メトリクスの種類
Prometheus クライアントライブラリには、4つのコアメトリクスタイプがあります。これらは現在、クライアントライブラリ（特定のタイプの使用に合わせた API を有効にするため）とワイヤプロトコルでのみ区別されています。Prometheus サーバーは、まだタイプ情報を使用しておらず、すべてのデータをタイプなしの時系列に平坦化しています。これは将来変更される可能性があります。
Counter
カウンターは、累積メトリクスであり、単一の 単調増加するカウンター を表します。その値は、増加するか、再起動時にゼロにリセットされるだけです。たとえば、カウンターを使用して、提供されたリクエスト数、完了したタスク数、またはエラー数を表すことができます。
減少する可能性のある値を公開するためにカウンターを使用しないでください。たとえば、現在実行中のプロセスの数にカウンターを使用しないでください。代わりにゲージを使用してください。
カウンターのクライアントライブラリ使用法ドキュメント
Gauge
ゲージは、任意に増減する単一の数値値を表すメトリクスです。
ゲージは通常、温度や現在のメモリ使用量などの測定値に使用されますが、同時リクエスト数のように増減する「カウント」にも使用されます。
ゲージのクライアントライブラリ使用法ドキュメント
Histogram
ヒストグラムは、観測値（通常はリクエストの期間や応答サイズなど）をサンプリングし、設定可能なバケットにカウントします。また、すべての観測値の合計も提供します。
ベースメトリクス名が <basename> のヒストグラムは、スクレイプ中に複数の時系列を公開します。
- 観測バケットの累積カウンター。
<basename>_bucket{le="<upper inclusive bound>"}として公開されます。 - すべての観測値の合計。
<basename>_sumとして公開されます。 - 観測されたイベントのカウント。
<basename>_countとして公開されます（上記の<basename>_bucket{le="+Inf"}と同一）。
histogram_quantile() 関数 を使用して、ヒストグラムまたはヒストグラムの集計からクォンタイルを計算します。ヒストグラムは、Apdex スコア を計算するのにも適しています。バケットを操作する際は、ヒストグラムが累積的 であることを覚えておいてください。ヒストグラムの使用法とサマリーとの違いについては、ヒストグラムとサマリーを参照してください。
注Prometheus v2.40 以降、ネイティブヒストグラムの実験的なサポートが提供されています。ネイティブヒストグラムは、観測値の合計とカウントに加えて、動的な数のバケットを含む単一の時系列のみを必要とします。ネイティブヒストグラムは、コストの fraction でより高い解像度を可能にします。ネイティブヒストグラムが安定した機能に近づいたら、詳細なドキュメントが提供されます。
注Prometheus v3.0 以降、クラシックヒストグラムの le ラベルの値は、OpenMetrics Canonical Numbers の形式に従うように、取り込み中に正規化されます。
ヒストグラムのクライアントライブラリ使用法ドキュメント
概要
ヒストグラムと同様に、サマリーは観測値（通常はリクエストの期間や応答サイズなど）をサンプリングします。観測値の合計カウントとすべての観測値の合計も提供しますが、スライディングタイムウィンドウにわたって設定可能なクォンタイルを計算します。
ベースメトリクス名が <basename> のサマリーは、スクレイプ中に複数の時系列を公開します。
- 観測イベントのストリーミング φ-クォンタイル（0 ≤ φ ≤ 1）。
<basename>{quantile="<φ>"}として公開されます。 - すべての観測値の合計。
<basename>_sumとして公開されます。 - 観測されたイベントのカウント。
<basename>_countとして公開されます。
φ-クォンタイル、サマリーの使用法、およびヒストグラムとの違いの詳細については、ヒストグラムとサマリーを参照してください。
注Prometheus v3.0 以降、quantile ラベルの値は、OpenMetrics Canonical Numbers の形式に従うように、取り込み中に正規化されます。
サマリーのクライアントライブラリ使用法ドキュメント