構文
newrelic.agent.web_transaction(application=None, name=None, group=None, scheme=None, host=None, port=None, request_method=None, request_path=None, query_string=None, headers=None)Webトランザクションを計測するために使用されます。
要件
エージェントのバージョン4.16.0.116以降
説明
この Python デコレーターは、Web トランザクションの計測に使用できます。このデコレーターでマークされたトランザクションは、APM UIではウェブトランザクションの下に表示され、非ウェブトランザクションとは区別されます。
デコレーターを使用できない場合は、これらの呼び出し形式のいずれかを使用すると便利です。
- The wrapper: 追跡したい特定の関数がどこにあるかが事前にわかっている場合は、
web_transactionデコレータを使用できます。 ただし、トレースする必要があるすべての関数がわからない場合 (たとえば、関数がルーティング システムの一部として動的に検索されている場合)、その時点でWebTransactionWrapperを使用して関数をラップする必要があります。登録時または電話時。 - The path-based wrapper: パスベースのラッパー フォームは
wrap_web_transactionです。
これらの関数形式の違いや用途については、 Variable Call Formats を参照してください。
パラメーター
デコレーターのパラメータ
newrelic.agent.web_transaction(application=None, name=None, group=None, scheme=None, host=None, port=None, request_method=None, request_path=None, query_string=None, headers=None)これらのコールのパラメータ
パラメータ | 説明 |
|---|---|
アプリケーションインスタンス | 任意。データが報告されるアプリケーションです。値を指定しない場合は、エージェントの 設定 (config ファイルまたは環境変数) で指定されたアプリケーションが使用されます。 アプリケーション オブジェクトの生成の詳細については、 |
ストリング | オプションです。トランザクションの名前です。デフォルトでは、この名前はデコレータが適用された関数の名前になりますが、この名前を指定することでこれを上書きできます。 |
ストリング | オプション。 指定しない場合、グループは、名前が |
ストリング | オプションです。リクエスト URL のスキーム部分 |
ストリング | オプションです。リクエストURLのホスト部分 |
整数 | オプションです。リクエストURLのポート部分 |
ストリング | オプションです。GETやPOSTなどのHTTPリクエスト・メソッドです。 |
ストリング | 任意です。リクエストURLのパスの残りの部分 |
ストリング | オプションです。クエスチョンマークの後に続くリクエストURLの部分 |
イテレート可能またはディク | オプション。HTTP リクエスト ヘッダー [name, value] の 2 項目の反復可能または |
ラッパーのパラメータです。
newrelic.agent.WebTransactionWrapper(wrapped, application=None, name=None, group=None, scheme=None, host=None, port=None, request_method=None, request_path=None, query_string=None, headers=None)WebTransactionWrapper は web_transaction デコレータと同じ パラメータ と、この追加の wrapped パラメータを受け取ります。
パラメータ | 説明 |
|---|---|
メソッド | 必要です。トレースするメソッドです。 |
パスベースのパラメータ
newrelic.agent.wrap_web_transaction(module, object_path, application=None, name=None, group=None, scheme=None, host=None, port=None, request_method=None, request_path=None, query_string=None, headers=None)wrap_web_transaction は、 web_transaction デコレータと同じ パラメータ に加えて、次の追加パラメータを受け取ります。
パラメータ | 説明 |
|---|---|
モジュール または 文字列 | 必要です。インスツルメンテーションを行うWeb関数/アクティビティを含むモジュール。 |
ストリング | 必須です。モジュールへのパスです。 |
例
web_transaction
ここでは、web_transaction デコレーターの使用例を示します。
@newrelic.agent.web_transaction()def get(): ...WebTransactionWrapper
WebTransactionWrapperの使用例:
task = newrelic.agent.WebTransactionWrapper(get_next_task())result = task(*args, **kwargs)