構文
newrelic.agent.add_custom_attribute(key, value)カスタム属性をトランザクションに追加します。
説明
この呼び出しは、カスタム属性(トランザクションに関連付けられたキーと値のペア) を記録します。
トランザクションがエラーに関連付けられている場合、またはそのトランザクションに対してトランザクショントレースが生成されている場合、属性はAPMで検出される可能性があります。属性は、NewRelicUIでも検索および照会できます。
重要
カスタム属性を作成する前に、NRQL で使用される予約語のリストを確認してください。
属性
属性 | 説明 |
|---|---|
ストリング | 必須項目です。キーの名前です。最初の255文字のみが保持されます。 |
文字列、 整数、 浮動小数点、 ブール値 | 必要です。現在のトランザクションに追加する文字列値です。最初の255文字のみが保持されます。 |
戻り値
属性が正常に追加された場合はTrueを返します。
例
バックグラウンドタスクにカスタム属性を追加
@newrelic.agent.background_task()def send_request(): response = requests.post('http://URL_path', headers=headers, data=data) newrelic.agent.add_custom_attribute('url_path_status_code', response.status_code)カスタム属性を使用したトラブルシューティング
カスタム属性を使用して、パフォーマンスの問題をトラブルシューティングすることもできます。たとえば、memcache インスタンスのプールからの応答時間が時折遅くなることがありますが、問題の原因となっているインスタンスはわかりません。次のように、サーバーを示す属性をトランザクションに追加できます。
# Set server_ip to be the current server processing the transaction
newrelic.agent.add_custom_attribute("memcache_query_frontend_lookup", server_ip)