data_source_generator (PythonエージェントAPI)

構文

newrelic.agent.data_source_generator(name=None, **properties)

メトリックデータを生成するデータソースをラップします。

説明

データ ソース API は、 record_custom_metricによって実装されたプッシュ スタイル APIではなく、プル スタイル API を使用して指標を生成する方法を提供します。カスタム メトリックにデータ ソースを使用する理由とその方法の詳細については、 「カスタム メトリック データ ソース」を参照してください。

data_source_generator デコレータは、各サンプルのメトリクスを含むイテラブル/ジェネレータを直接返す単純なメトリクス データ生成データ ソースをラップするために使用されます。デコレータが適用される関数は引数を取らないでください。これは、メトリクスを生成するために呼び出し間で状態情報を保持する必要がない場合、およびデータ ソースの 1 つのインスタンスを複数のアプリケーションに対して使用できる場合に使用されます。

パラメーター

戻り値

関数を返します。

例

データソースジェネレータの例

data_source_generator を使用してメトリック値を返す関数をラップする例:

import psutil
import os
 
@newrelic.agent.data_source_generator(name='Memory Usage')
def memory_metrics():
    pid = os.getpid()
    p = psutil.Process(os.getpid())
    m = p.get_memory_info()
    yield ('Custom/Memory/Physical', float(m.rss)/(1024*1024))
    yield ('Custom/Memory/Virtual', float(m.vms)/(1024*1024))