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()
    ...

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