profile_trace (PythonエージェントAPI)

構文

newrelic.agent.profile_trace(name=None, group=None, label=None, params=None, depth=3)

関数のトレース名に追加の属性を追加します。

説明

profile_trace 追加セグメントの形式でトランザクション追跡に詳細を追加するために使用されます。profile_traceで報告された呼び出しは、 APM データベースページに表示されます。profile_traceはProfileTraceWrapperの部分を返します。これは、プロファイラーへの呼び出しのタイミングをとる関数のデコレータとして使用できます。

アプリケーションでデコレータを使用できない場合は、次の呼び出し形式を使用できます: ラッパーフォームはProfileTraceWrapperです。デコレータを使用せずにラップされた関数を返すために使用できます。

これらの異なるコールフォーマットの用途についての説明は、 Different call formats を参照してください。通話例については、例をご覧ください。

重要

関数は、指定された関数呼び出しのスコープでのみインストルメント化されます。関数function_aがトレースされ、それがfunction_bを呼び出す場合、これはfunction_aのスコープ内でのみ計測され、 function_bが呼び出されてトレースされない他の場所では計測されません。

パラメーター

デコレーターのパラメータ

newrelic.agent.profile_trace(name=None, group=None, label=None, params=None, depth=3)

このコールには、以下のパラメータが含まれています。

パラメータ	説明
`name` ストリング	オプションです。関数名を指定します。設定されていない場合は、キャプチャされた関数名がデフォルトとなります。
`group` ストリング	オプション。`group`は、 `name`パラメータの命名構造を表します。これは、トランザクションタイプを分離するために UI で使用されます。指定しない場合、名前が`module:class.function`または`module:function`の形式であり、実行される関数の名前を表すと想定して、グループはデフォルトで`Function`になります。カスタムグループを作成する場合は、先頭に`Python/`を付けることをお勧めします。
`label` ストリング	オプション。トランザクション追跡のセグメントにコールアウトスタイルのフラグを追加します。デフォルトは`None`です。
`params` ディクト	オプションです。トランザクション・トレースのセグメントに追加するカスタム・パラメータ。
`depth` ディクト	任意です。関数トレースの最大深度を表すパラメータです。デフォルトは3です。

ラッパーのパラメーター

newrelic.agent.ProfileTraceWrapper(wrapped, name=None, group=None, label=None, params=None, depth=3)

ラッパーのパラメーターには、 profile_traceのすべてのパラメーターとwrappedパラメーターが含まれます。

パラメータ	説明
`wrapped` 機能	必要です。ラッピングされる機能

パラメータ

説明

wrapped

機能

必要です。ラッピングされる機能

例

`profile_trace` 例

profile_traceデコレーターの使用例:

import newrelic.agent

@newrelic.agent.profile_trace()
def some_function():
    ...

ラッパーの例

ProfileTraceWrapperの使用例:

import newrelic.agent

def another_function():
    wrapped_function = newrelic.agent.ProfileTraceWrapper(some_function)
    ...
    wrapped_function()
    ...

この機械翻訳は、参考として提供されています。