構文
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 ファイルまたは環境変数) で指定されたアプリケーションが使用されます。 アプリケーション オブジェクトの生成の詳細については、 |
文字列 または 機能 | オプション。トランザクションの名前。callable_name パラメーターを受け取る関数である可能性があります。デフォルト値は |
文字列 または 機能 | オプション。 指定されていない場合、名前が |
文字列 または 機能 | オプション。リクエストURLのスキーム部分。ラップされる関数と同じパラメーターを受け取る関数にすることもできます。 |
文字列 または 機能 | オプション。リクエストURLのホスト部分。ラップされる関数と同じパラメーターを受け取る関数にすることもできます。 |
整数または関数 | オプション。リクエストURLのポート部分。ラップされる関数と同じパラメーターを受け取る関数にすることもできます。 |
文字列 または 機能 | オプション。GETやPOSTなどのHTTPリクエストメソッド。ラップされる関数と同じパラメーターを受け取る関数にすることもできます。 |
文字列 または 機能 | オプション。リクエストURLのパスの残りの部分。ラップされる関数と同じパラメーターを受け取る関数にすることもできます。 |
文字列 または 機能 | オプション。リクエストURLのクエスチョンマークの後に続く部分。ラップされる関数と同じパラメーターを受け取る関数にすることができます。 |
イテラブルまたは dict または 関数 | オプション。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 パラメータを受け取ります。
パラメータ | 説明 |
|---|---|
メソッド | 必要です。トレースするメソッドです。 |
文字列 または 機能 | オプション。トランザクションの名前。callable_name パラメーターを受け取る関数である可能性があります。デフォルト値は |
文字列 または 機能 | オプション。 指定されていない場合、名前が |
文字列 または 機能 | オプション。リクエストURLのスキーム部分。ラップされる関数と同じパラメーターを受け取る関数にすることもできます。 |
文字列 または 機能 | オプション。リクエストURLのホスト部分。ラップされる関数と同じパラメーターを受け取る関数にすることもできます。 |
整数または関数 | オプション。リクエストURLのポート部分。ラップされる関数と同じパラメーターを受け取る関数にすることもできます。 |
文字列 または 機能 | オプション。GETやPOSTなどのHTTPリクエストメソッド。ラップされる関数と同じパラメーターを受け取る関数にすることもできます。 |
文字列 または 機能 | オプション。リクエストURLのパスの残りの部分。ラップされる関数と同じパラメーターを受け取る関数にすることもできます。 |
文字列 または 機能 | オプション。リクエストURLのクエスチョンマークの後に続く部分。ラップされる関数と同じパラメーターを受け取る関数にすることができます。 |
イテラブルまたは dict または 関数 | オプション。HTTPリクエストヘッダー。[name, value]の2要素で構成されるイテラブル（反復可能オブジェクト）のリスト、または |
パスベースのパラメータ
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)