アトリビュート は、イベントやトランザクションのプロパティを決定する情報を含むキーと値のペアです。ユーザーは、それぞれの送信先にどの属性を送信するかを正確にカスタマイズすることができます。
これらの属性設定は、Pythonエージェントのバージョン2.56.0.42以降に適用されます。 利用可能なすべての機能を利用するには、Pythonエージェント を 最新のリリース にアップデートしてください。
PythonエージェントのWebトランザクション属性
以下は、 Web トランザクション のために、Python エージェントで設定できる属性の一覧です。詳細は、 Python agent configuration: attributes を参照してください。
HTTPのAcceptリクエストヘッダから読み取ったタイプです。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。有効
- ページビュー ( ): 利用不可
Content-Lengthリクエスト ヘッダーから読み取った受信リクエストのサイズ（バイト単位）。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。有効
- ページビュー（ブラウザモニタリング）。利用不可
Content-Typeリクエスト ヘッダーから読み取られた受信リクエストのコンテンツ タイプ。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。有効
- ページビュー（ブラウザモニタリング）。利用不可
HTTPのホストリクエストヘッダの名前です。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。有効
- ページビュー（ブラウザモニタリング）。利用不可
Refererリクエスト ヘッダーから読み取られた着信リクエスト リファラー。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。有効
- ページビュー（ブラウザモニタリング）。利用不可
User-Agentリクエスト ヘッダーから読み取られた着信リクエストのユーザー エージェント。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。有効
- ページビュー（ブラウザモニタリング）。利用不可
受信したリクエストのHTTPメソッドです。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。有効
- ページビュー（ブラウザモニタリング）。利用不可
リクエストURLのクエリストリングからのパラメータ。
ヒント
capture_paramsプロパティは廃止されました。ただし、 trueに設定すると、トランザクション追跡と追跡エラーのリクエスト パラメータが有効になります。
デフォルトでは
- トランザクションのトレース。無効です。
- エラーコレクター（トレースされたエラー）。無効です。
- トランザクションイベント。使用不可
- ページビュー（ブラウザ監視）。使用不可
受信したリクエストのURIです。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。有効
- ページビュー（ブラウザモニタリング）。利用不可
Content-Length応答ヘッダーから取得され、送信応答のサイズをバイト単位で指定します。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。有効
- ページビュー（ブラウザモニタリング）。利用不可
Content-Type応答ヘッダーから取得され、発信応答のコンテンツ タイプを指定します。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。有効
- ページビュー（ブラウザモニタリング）。利用不可
発信応答の状態。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。有効
- ページビュー（ブラウザモニタリング）。利用不可
"スレッド使用率の指標で、" 同時リクエストを処理するスレッドの数を表す。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。使用不可
- ページビュー（ブラウザモニタリング）。利用不可
リクエストのキューイングに費やされた時間（秒単位）。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。使用不可
- ページビュー（ブラウザモニタリング）。利用不可
WSGIの入力ストリームで受信したバイト数（ファイル状のオブジェクト。）
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。使用不可
- ページビュー（ブラウザモニタリング）。利用不可
WSGI サーバーがリクエストを処理するためにread()を呼び出した回数。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。使用不可
- ページビュー（ブラウザモニタリング）。利用不可
WSGI サーバーがリクエストを処理するためにreadline()を呼び出した回数。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。使用不可
- ページビュー（ブラウザモニタリング）。利用不可
WSGI サーバーがリクエストを処理するためにreadlines()を呼び出した回数。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。使用不可
- ページビュー（ブラウザモニタリング）。利用不可
WSGI入力ストリームを読み込むのにかかる時間（秒）。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。使用不可
- ページビュー（ブラウザモニタリング）。利用不可
WSGIの出力レスポンスで送信されるバイト数。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。使用不可
- ページビュー（ブラウザモニタリング）。利用不可
WSGI サーバーが応答を送信するためにwrite()を呼び出した回数。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。使用不可
- ページビュー（ブラウザモニタリング）。利用不可
WSGI サーバーが応答を送信するためにyieldを呼び出した回数。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。使用不可
- ページビュー（ブラウザモニタリング）。利用不可
WSGIのレスポンスを送信する時間（秒）。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。使用不可
- ページビュー（ブラウザモニタリング）。利用不可
Pythonエージェントメッセージのトランザクション属性
次のセクションでは、 RabbitMQなどの受信メッセージ ブローカーによって開始されたメッセージ トランザクションに対して Python エージェントで構成できる属性を示します。 詳細については、 「Python エージェント設定: プロパティ」を参照してください。
RPC構成で使用される、アプリケーションが生成した識別子です。
デフォルトでは
- トランザクションのトレース。無効です。
- エラーコレクター（トレースされたエラー）。無効です。
- トランザクションイベント。使用不可
このメッセージが消費された交換のタイプ：ダイレクト、ファンアウト、トピック、またはヘッダ
デフォルトでは
- トランザクションのトレース。無効です。
- エラーコレクター（トレースされたエラー）。無効です。
- トランザクションイベント。使用不可
受信メッセージのヘッダーです。
デフォルトでは
- トランザクションのトレース。無効です。
- エラーコレクター（トレースされたエラー）。無効です。
- トランザクションイベント。使用不可
このメッセージが消費されたキューの名前。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。有効
RPC構成で使用されるコールバックキューです。
デフォルトでは
- トランザクションのトレース。無効です。
- エラーコレクター（トレースされたエラー）。無効です。
- トランザクションイベント。使用不可
受信メッセージのルーティングキー。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。有効
Pythonエージェントの外部トレース属性
以下のセクションでは、 httplib, boto3, requests, などの発信ライブラリによって開始されるトレースや、 外部トレース API を使用する際に、Python エージェントで設定可能な属性をリストアップしています。詳細については、 Python agent configuration: attributes を参照してください。
リクエストパラメーターを取り除いた、送信されるコールのURLです。
ときに除外されます。
Pythonエージェントデータベースのトレース属性
以下のセクションでは、 mysql, psycopg2, cx_Oracle, などのデータベースライブラリが起動するトレースや、データベーストレースAPIを使用する際に、Pythonエージェントで設定できる属性をリストアップしています。詳細については、 Python agent configuration: attributes を参照してください。
クエリで使用するデータベースの名前です。
ときに除外されます。
"datastore_tracer.database_name_reporting.enabled" の構成設定がFalseになっています。
db.instance」に一致するルールが"transaction_segments.attributes.exclude" の設定（セグメント用）に存在する場合。
"span_events.attributes.exclude" の構成設定に「db.instance」に一致するルールが存在する場合。(スパンの場合)
デフォルトでは
トランザクション・セグメント。Enabled
スパンイベント。有効
データベースへの接続に使用されるホストです。
ときに除外されます。
データベースのポート、パス、IDのいずれか。
ときに除外されます。
transaction_tracer.record_sql 設定 に基づいて処理された、クエリで使用された SQLl。大きなクエリはサイズが制限されます。
ときに除外されます。
"transaction_tracer.record_sql の設定" の設定が"off になっています。"
デフォルトでは
トランザクションセグメント。Enabled, reported as"obfuscated" SQL.
データベースへの接続に使用されるホストです。
ときに除外されます。
データベースへの接続に使用されるホスト（ポートやパスの情報を含む）。
ときに除外されます。
このスパンで実行されたデータベース操作です。db.statement が適用されない場合にのみ含まれます。
ときに除外されます。
Pythonエージェントのデータストアのトレース属性
以下のセクションでは、 redis, memcache, pymongo, などのデータストアライブラリによって開始されるトレースや、 データストアトレースAPI を使用する際に、Pythonエージェントで設定できる属性をリストアップしています。詳細については、 Python agent configuration: attributes を参照してください。
クエリで使用されるデータストア・インスタンスの名前です。
ときに除外されます。
"datastore_tracer.database_name_reporting.enabled" の構成設定がFalseになっています。
db.instance」に一致するルールが"transaction_segments.attributes.exclude" の設定（セグメント用）に存在する場合。
db.instance」に一致するルールが"span_events.attributes.exclude" の構成設定（スパン用）に存在する場合。
デフォルトでは
トランザクション・セグメント。Enabled
スパンイベント。有効
データストアへの接続に使用されるホストです。
ときに除外されます。
データストアのポート、パス、またはID。
ときに除外されます。
データストアへの接続に使用されるホストです。
ときに除外されます。
データストアへの接続に使用されたホスト（ポート、パス、またはID情報を含む）。
ときに除外されます。
Pythonエージェントのスパン属性
以下のセクションでは、 スパンイベント のためにPythonエージェントで設定できる属性をリストアップしています。詳細については、 Python agent configuration: attributes を参照してください。
スパンイベントに記録される例外のクラス（存在する場合）。例外の詳細は、 notice_error APIを使ってスパンに記録することができます。
デフォルトでは
スパンイベントに記録される例外メッセージ（存在する場合）。例外の詳細は、 notice_error APIを使ってスパンに記録することができます。
デフォルトでは
カスタムアトリビュートを追加する
アプリケーションから追加のカスタム属性を取得するには、 newrelic.agent.add_custom_attribute()を使用します。
詳細は、 Collecting custom attributes を参照してください。
デフォルトでは
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。有効
- ページビュー（ブラウザ監視）。使用不可
重要
カスタムアトリビュートを作成する前に、 reserved terms のリストを確認してください。そうしないと、予期しない結果が生じる可能性があります。
例外にカスタム属性を追加
newrelic.agent.notice_error() API 呼び出しを使用する場合、トレースされたエラーの属性として記録されるparamsのディクショナリを渡すことができます。
デフォルトでは
- トランザクションのトレース。利用できません
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベントです。使用不可
- ページビュー（ブラウザモニタリング）。利用不可
設定ファイルのアップグレード
Python エージェント2.56.0.42以上にアップグレードするときは、 newrelic.ini設定ファイルもアップグレードしてください。 非推奨の構成設定の詳細については、 「属性の有効化と無効化」を参照してください。