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

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

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

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

GAUGE メトリクス送信タイプは、1 つの時間間隔内のイベントのスナップショットを表します。この代表スナップショット値は、1 つの時間間隔内に Agent に送信された最後の値です。GAUGE は、使用可能なディスクスペースや使用中のメモリなど、継続的に報告されるものを測定するために使用できます。

HISTOGRAM メトリクス送信タイプは、1 つの時間間隔内で Agent 側で計算された値セットの統計分布を表します。Datadog の HISTOGRAM メトリックタイプは、StatsD タイミングメトリックタイプの拡張です。Agent は、定義された時間間隔内に送信された値を集約し、値セットを表す複数の異なるメトリクスを生成します。

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

<METRIC_NAME>.avg

時間間隔内に送信された X 個の値の平均値を表します。
Datadog アプリ内タイプ: GAUGE

<METRIC_NAME>.count

時間間隔内に送信された値の数 X を表します。Agent はこの数を RATE として送信するため、アプリ内で表示される値は X/interval です。
Datadog アプリ内タイプ: RATE

<METRIC_NAME>.median

時間間隔内に送信された X 個の値の中央値を表します。
Datadog アプリ内タイプ: GAUGE

<METRIC_NAME>.95percentile 時間間隔内に送信された X 個の値の 95 パーセンタイルを表します。
Datadog アプリ内タイプ: GAUGE

<METRIC_NAME>.max

時間間隔内に送信された X 個の値の最大値を表します。
Datadog アプリ内タイプ: GAUGE

注:

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

DISTRIBUTION メトリクス送信タイプは、分散インフラストラクチャー全体で計算された値セットのグローバル統計分布を表します。DISTRIBUTION は、基盤となるホストとは独立して、サービスのような論理オブジェクトをインスツルメントするために使用できます。

HISTOGRAM メトリクスタイプが特定の時間間隔内で Agent に対して集計するのに対し、DISTRIBUTION メトリクスは特定の時間間隔内のすべての生データを Datadog に送信します。集計はサーバー側でなされます。基礎となるデータ構造が生未集計データを表すため、分布は 2 つの主要な機能を提供します。

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

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

avg:<METRIC_NAME>

時間間隔内に送信された X 個の値の平均値を表します。
Datadog アプリ内タイプ: GAUGE

count:<METRIC_NAME>

時間間隔内に送信されたポイントの数を表します。XAgent はその数を COUNT として送信します。
Datadog アプリ内タイプ: COUNT

max:<METRIC_NAME>

時間間隔内に送信された X 個の値の最大値を表します。
Datadog アプリ内タイプ: GAUGE

min:<METRIC_NAME>

時間間隔内に送信された X の最小値を表します。
Datadog アプリ内タイプ: GAUGE

sum:<METRIC_NAME> 時間間隔内に送信された X 個の値の合計値を表します。
Datadog アプリ内タイプ: COUNT

注: 分布メトリクス値の異なる複数の集計値はアプリ内でゲージまたはカウントとして_表され_ますが、メトリクス自体はタイプ DISTRIBUTION を保持します。

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

Agent は、1つの時間間隔内で受信したすべての値を加算します。次に、合計数値 (この場合は 15) を COUNT メトリクスの値として送信します。

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

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

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

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

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

2 つの Web サーバー 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 つの集約が両方の Web サーバーから収集されたすべての値のグローバルな統計分布を表します。

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

GUAGE や HISTOGRAM などの他のメトリクスタイプと同じように、ディストリビューションメトリクスタイプでは次の集計が利用可能です: count、min、max、sum、およびavg。ディストリビューションメトリクスのタグ付け方法は、当初は他のメトリクスと同じです (コード内で設定されたカスタムタグによる)。

追加のパーセンタイル集計 (p50、p75、p90、p95、p99) は、メトリクスの詳細サイドパネルからディストリビューションメトリクスに追加できます。アプリ内のディストリビューションメトリクスにパーセンタイル集計を追加する場合、次の 5 つの追加集計をクエリに使用できます。

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

注: 分布メトリクス値の異なる複数の集計値はアプリ内でゲージまたはカウントとして_表され_ますが、メトリクス自体はタイプ DISTRIBUTION を保持します。

タグ付けのカスタマイズ

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

注: 許可リストベースのタグのカスタマイズでは、タグの除外はサポートされていません。!で始まるタグは追加できません。

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

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

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

注: DogStatsD を通じて RATE メトリクスを取得するには、[COUNT][16] または [HISTOGRAM][18] メトリクスを送信してください。COUNT メトリクスの値と <HISTOGRAM>.count の値は、StatsD フラッシュ期間全体のメトリクス値の時間正規化された差分です。

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

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

Datadog Agent に TIMER メトリックを送信することは、DogStatsD 内で HISTOGRAM メトリックタイプを送信することと同等です (標準の StatsD のタイマーと混同しないようにしてください)。DogStatsD TIMER が表すのは期間データだけです。たとえば、コードのセクションが実行されるのにかかる時間です。

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

注: 分布メトリクス値の異なる複数の集計値はアプリ内でゲージまたはカウントとして_表され_ますが、メトリクス自体はタイプ DISTRIBUTION を保持します。