record_custom_metrics (PythonエージェントAPI)

構文

newrelic.agent.record_custom_metrics(metrics, application=None)

カスタムメトリクスのセットを記録します。

説明

この呼び出しは、一連のカスタム指標を記録します。単一のカスタム指標を記録するには、 record_custom_metricを参照してください。

渡される指標は、 (name, value)タプルを生成する反復可能なオブジェクトにすることができます。例えば：

def metrics():
    yield "Custom/Value-1", 1
    yield "Custom/Value-2", 2
    yield "Custom/Value-3", 3

newrelic.agent.record_custom_metrics(metrics())

名前の設定に制限はありませんが、 Custom/プレフィックスを使用することをお勧めします。カスタム メトリック値は、数値にすることも、既に集計されたデータ サンプルに対応するディクショナリにすることもできます。nameおよびvalueルールの詳細については、 record_custom_metricを参照してください。

パラメーター

戻り値

なし。

例

カスタムメトリクスの記録

def metrics():
    yield 'Custom/Value-1', 1
    yield 'Custom/Value-2', 2
    yield 'Custom/Value-3', 3

newrelic.agent.record_custom_metrics(metrics())

カスタムメトリクスの表示と使用

カスタム メトリクスを表示するには、メトリクスとイベントを使用してカスタム メトリクスを検索およびフィルタリングし、カスタマイズ可能なグラフを作成して、それらのグラフを New Relic ダッシュボードに追加します。REST API を使用して、UI の外部でカスタム メトリック データをプログラムで取得して使用できます。カスタム メトリック アラート条件を作成して、カスタム メトリックが特定の値を超えたときに自分またはチームに通知することもできます。