メトリクスタイプ

COUNT メトリクス送信タイプは、ある時間間隔のイベント発生の合計数を表します。COUNT を使用して、データベースへの接続の合計数またはエンドポイントへのリクエストの合計数を追跡できます。このイベントの数は、時間の経過とともに累積または減少する可能性があり、単調に増加することはありません。

注: この COUNT とは異なり、RATE は定義された時間間隔で正規化される 1 秒あたりのイベントの数を表します。

RATE メトリクス送信タイプは、ある時間間隔の 1 秒あたりのイベント発生の合計数を表します。RATE を使用して、データベースへの接続頻度やエンドポイントへのリクエストフローなど、何かが発生している頻度を追跡できます。

注: この RATE とは異なり、COUNT メトリクス送信タイプは特定の時間間隔内のイベント発生の合計数を表します。

GAUGE メトリクス送信タイプは、ある時間間隔のイベントのスナップショットを表します。この代表的なスナップショット値は、時間間隔中に Agent に送信された最後の値です。GAUGE を使用して、使用可能なディスク容量や使用中のメモリなど、継続的にレポートする何かの測定を行うことができます。

HISTOGRAM メトリクス送信タイプは、ある時間間隔の Agent 側で計算された一連の値の統計分布を表します。Datadog の HISTOGRAM メトリクスタイプは、StatsD タイミングメトリクスタイプの拡張機能です。Agent は、定義された時間間隔で送信される値を集計し、一連の値を表すさまざまなメトリクスを生成します。

ある時間間隔内に HISTOGRAM メトリクス <メトリクス名> に対して X 個の値を送信した場合、次のメトリクスが Agent によってデフォルトで生成されます。

<METRIC_NAME>.avg

時間間隔内の X 個の値の平均値を表します。
Datadog In-App Type: GAUGE

<METRIC_NAME>.count

間隔内に送信された値の数 (つまり X) を表します。Agent はその数を RATE として送信することで、アプリ内で値 X/interval として表示します。
Datadog In-App Type: RATE

<METRIC_NAME>.median

時間間隔内の X 個の値の中央値を表します。
Datadog In-App Type: GAUGE

<METRIC_NAME>.95percentile

時間間隔内の X 個の値の 95 パーセンタイルを表します。
Datadog In-App Type: GAUGE

<METRIC_NAME>.max

時間間隔内に送信された X 個の値の最大値を表します。
Datadog In-App Type: GAUGE

注:

• どの集計を Datadog に送信するかは、datadog.yaml 構成ファイルの histogram_aggregates パラメーターで構成します。デフォルトでは、max、median、avg、count の集計だけが Datadog に送信されます。sum および min も利用できます。
• どのパーセンタイル集計を Datadog に送信するかは、datadog.yaml 構成ファイルの histogram_percentiles パラメーターで構成します。デフォルトでは、95percentile のパーセンタイルだけが Datadog に送信されます。

DISTRIBUTION メトリクス送信タイプは、ある時間間隔の分散インフラストラクチャー全体にわたって計算された一連の値のグローバルな統計分布を表します。DISTRIBUTION を使用して、基底のホストから独立して、サービスなどの論理オブジェクトをインスツルメントすることができます。

Agent で特定の時間間隔内の集計を行う HISTOGRAM メトリクスタイプと異なり、DISTRIBUTION メトリクスは、時間間隔内に収集されたすべての未加工データを Datadog に送信します。サーバー側で集計を行います。基になるデータ構造は集計されておらず、未加工データを表すため、ディストリビューションは次の 2 つの主要な機能を提供します。

• パーセンタイル集計の計算
• タグ付けのカスタマイズ

ある時間間隔内に DISTRIBUTION メトリクス <メトリクス名> に対して X 個の値を送信した場合、デフォルトで次の集計をクエリに利用できます。

avg:<METRIC_NAME>

時間間隔内の X 個の値の平均値を表します。
Datadog In-App Type: GAUGE

count:<METRIC_NAME>

時間間隔内に送信されたポイントの数 (つまり X) を表します。Agent はその数を COUNT として送信します。
Datadog In-App Type: COUNT

max:<METRIC_NAME>

時間間隔内に送信された X 個の値の最大値を表します。
Datadog In-App Type: GAUGE

min:<METRIC_NAME>

時間間隔内に送信された X 個の値の最小値を表します。
Datadog In-App Type: GAUGE

sum:<METRIC_NAME>

時間間隔内に送信された X 個の値すべての合計を表します。
Datadog In-App Type: COUNT

Datadog Agent を実行している単一のホストから COUNT メトリクス、activeusers.basket_size を送信するとします。このホストは、フラッシュ時間間隔で次の値を出力します: [1,1,1,2,2,2,3,3]。

Agent は、ある時間間隔で受信したすべての値を追加します。その後、合計数 (この場合は 15) を COUNT メトリクスの値として送信します。

Datadog Agent を実行している単一のホストから RATE メトリクス、queue_messages.rate を送信するとします。このホストは、フラッシュ時間間隔で次の値を出力します: [1,1,1,2,2,2,3,3]。

Agent は、ある時間間隔で受信したすべての値を追加します。その後、 この時間間隔の合計秒数で割った合計数を送信します。この場合、フラッシュ間隔が 10 秒の場合、RATE メトリクスの値として送信される値は 1.5 になります。

Datadog Agent を実行している単一のホストから GAUGE メトリクス、temperature を送信するとします。このホストは、フラッシュ時間間隔で次の値を出力します: [71,71,71,71,71,71,71.5]。

Agent は、最後に報告された数値 (この場合は 71.5) を GAUGE メトリクスの値として送信します。

たとえば、フラッシュ時間間隔で値 [1,1,1,2,2,2,3,3] を報告するウェブサーバーから HISTOGRAM メトリクス request.response_time.histogram を送信するとします。デフォルトでは、Agent は、この時間間隔のこれらの値の統計分布を表す以下のメトリクスを Datadog に送信します。

2 つのウェブサーバー webserver:web_1 と webserver:web_2 から DISTRIBUTION メトリクス、request.response_time.distribution を送信するとします。特定のフラッシュ時間間隔で、webserver:web_1 が値 [1,1,1,2,2,2,3,3] を持つメトリクスを報告し、webserver:web_2 が値 [1,1,2] を持つ同じメトリクスを報告するとします。この時間間隔で、次の 5 つの集計は、両方のウェブサーバーから収集されたすべての値のグローバルな統計分布を表します。

パーセンタイル集計の計算

GAUGE、HISTOGRAM などのメトリクスタイプと同様に、DISTRIBUTION メトリクスタイプでは count、min、max、sum、avg の集計を利用できます。ディストリビューションメトリクスは、まず他のメトリクスと同じ方法で (コードで設定されたカスタムタグを使用して) タグ付けられます。

パーセンタイル集計（p50、p75、p90、p95、p99`）をディストリビューションメトリクスに追加できます。アプリ内のディストリビューションメトリクスにパーセンタイル集計を追加する場合、次の 5 つの追加集計をクエリに使用できます。

つまり、特定の時間間隔でパーセンタイル集計を指定したディストリビューションメトリクスであれば、count、sum、min、max、avg、p50、p75、p90、p95、p99 の 10 個の集計を使用できます。

タグ付けのカスタマイズ

この機能を使用すると、ホストレベルの粒度を必要としない場合に、メトリクスのタグ付けを制御できます。Metrics without Limits™ の詳細についてはこちらをご覧ください。

注: この機能では、! によるタグの除外を使用できません。

次のソースのいずれかから COUNT タイプのメトリクスを送信します。

注: DogStatsD を介して COUNT メトリクスタイプを送信する場合、メトリクスは異なる Agent 間の関連する比較を確保するためにアプリ内に RATE として表示されます。その結果、StatsD カウントは Datadog 内に 10 進数値で表示される場合があります（1 秒あたりの単位を報告するために時間間隔で正規化されるため）。

次のソースのいずれかから RATE タイプのメトリクスを送信します。

注: DogStatsD を介して RATE メトリクスタイプを送信する場合、メトリクスは異なる Agent 間の関連する比較を確保するためにアプリ内に GAUGE として表示されます。

次のソースのいずれかから GAUGE タイプのメトリクスを送信します。

次のソースのいずれかから HISTOGRAM タイプのメトリクスを送信します。

TIMER メトリクスを Datadog Agent に送信することは、DogStatsD 内で HISTOGRAM メトリクスタイプを送信することと同等です（標準 StatsD のタイマーと混同しないでください）。DogStatsD TIMER は期間データのみを表します。たとえば、コードのセクションの実行にかかる時間や、ページを完全にレンダリングするのにかかる時間などです。

次のソースから DISTRIBUTION タイプのメトリクスを送信します。