add_custom_attributes (Python エージェント API)

構文

newrelic.agent.add_custom_attributes(items)

複数のカスタム属性をトランザクションに追加します。

説明

この呼び出しは、1 つ以上のカスタム属性(トランザクションに関連付けられたキー/値のタプル) を記録します。

トランザクションがエラーに関連付けられている場合、またはそのトランザクションに対してトランザクショントレースが生成されている場合、属性はAPMで検出される可能性があります。属性は、NewRelicUIでも検索および照会できます。

属性

戻り値

すべての属性が正常に追加された場合、 Trueを返します。

例

バックグラウンドタスクにカスタム属性を追加

バックグラウンドタスクにカスタム属性を追加する例 。

@newrelic.agent.background_task()
def send_request():
    response = requests.get("http://example.com")
    newrelic.agent.add_custom_attributes(
        [("url_path_status_code", response.status_code)]
    )

カスタム属性を使用したトラブルシューティング

カスタム属性を使用して、パフォーマンスの問題をトラブルシューティングすることもできます。たとえば、memcache インスタンスのプールからの応答時間が時折遅くなることがありますが、問題の原因となっているインスタンスはわかりません。次のように、サーバーを示す属性をトランザクションに追加できます。

# Set server_ip to be the current server processing the transaction
newrelic.agent.add_custom_attributes([
    ("memcache_query_frontend_lookup", server_ip)
])