• ログイン今すぐ開始

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

profile_trace (PythonエージェントAPI)

構文

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

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

説明

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

アプリケーションでデコレータを使用できない場合は、次の呼び出し形式を使用できます: ラッパー フォームは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

機能

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

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()
...
Copyright © 2022 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.