add_custom_parameters (PythonエージェントAPI)

構文

newrelic.agent.add_custom_parameters(items)

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

説明

この呼び出しは、1つ以上のカスタム属性（トランザクションにアタッチされたキー/値タプル）を記録します。 「カスタム属性」は以前は「カスタムパラメータ」と呼ばれていたため、呼び出し名はadd_custom_parametersです。

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

パラメーター

戻り値

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

例

バックグラウンドタスクへのカスタムパラメータの追加

バックグラウンドタスクにカスタムパラメータを追加する例:

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

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

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

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