Datadog メトリクスにおける Prometheus メトリクスのマッピング

Datadog の Prometheus または OpenMetrics チェックをお使いの場合に、これらのメトリクスが既存の Datadog メトリクスタイプにどのようにマッピングされるかをご説明します。

詳細は、Kubernetes Prometheus および OpenMetrics メトリクスの収集を参照してください。

Prometheus および OpenMetrics メトリクスのタイプ

  • counter: 単調に増加するカウンターで表される、累積的なメトリクス。値は増加するか、0 にリセットされるかのどちらかとなります。
  • gauge: 無作為に増減する単一の数値を表すメトリクス。
  • histogram: 観察結果のサンプルを抽出し、構成可能なバケットの中でカウントします。また、観察されたすべての値の合計を提示します。
  • summary: histogram と同様に観察結果のサンプルを抽出し、観察されたすべての値の合計を提示します。また、スライド式のタイムウィンドウの中で構成可能な量を計算します。

Datadog メトリクスにおける Prometheus/OpenMetrics メトリクスのマッピング方法

詳細は、Datadog メトリクスタイプを参照してください。

Counter

デフォルトでは、Prometheus/OpenMetrics の counter はDatadog の monotonic_count にマッピングされます。

ただし、パラメーター send_monotonic_counter が false の場合、このメトリクスは gauge として送信されます。単調カウンターの詳細についてはこちらを参照してください。

Gauge

Prometheus/OpenMetrics の gauge は Datadog の gauge にマッピングされます。

Histogram

Prometheus/OpenMetrics の histogram については、histogram の _count と _sum の値がそれぞれ Datadog の gauge にマッピングされます。

パラメーター collect_histogram_buckets が true の場合、それぞれの _bucket 値もまた Datadog の gauge にマッピングされます。

パラメーター send_distribution_buckets が true の場合、それぞれの _bucket は Datadog の distribution にマッピングされます。Prometheus/OpenMetrics の histogram データは Datadog のディストリビューションメトリクスに変換され、Datadog で Kubernetes のメトリクスをパーセンタイルとして監視できるようになります。Datadog のディストリビューションメトリクスは DDSketch アルゴリズムに基づいています。詳しくは、関連する Datadog の OpenMetrics とディストリビューションメトリクスに関するブログ記事を参照してください。

注: OpenMetrics v2 の場合、代わりに collect_counters_with_distributions を使用してください。

パラメーター send_distribution_counts_as_monotonic が true の場合、_count で終わる各メトリクスは monotonic_count として送信されます。単調カウンターについての詳細はこちらを参照してください。

Summary

Prometheus/OpenMetrics の summary については、summary の _count および _sum の値がそれぞれ Datadog の count にマッピングされます。

パラメーター send_distribution_buckets が true の場合は、histogram がディストリビューションに変換され、それぞれの _bucket が distribution タグを使用してフェッチされます。

パラメーター send_distribution_counts_as_monotonic が true の場合、_count で終わる各メトリクスは monotonic_count として送信されます。単調カウンターについての詳細はこちらを参照してください。