メトリックの種類

Prometheus クライアントライブラリは、4つのコアメトリックタイプを提供します。これらは現在、クライアントライブラリ内（特定のタイプの使用に合わせたAPIを有効にするため）とワイヤープロトコル内でのみ区別されます。Prometheusサーバーはまだタイプ情報を使用せず、すべてのデータを型なしの時系列にフラット化します。これは将来変更される可能性があります。

カウンター

カウンターは、単一の単調増加するカウンターを表す累積メトリックで、その値は増加するか、再起動時にゼロにリセットされることしかありません。例えば、処理されたリクエスト数、完了したタスク数、エラー数などを表現するためにカウンターを使用できます。

減少する可能性のある値を公開するためにカウンターを使用しないでください。例えば、現在実行中のプロセス数にカウンターを使用しないでください。代わりにゲージを使用してください。

カウンターのクライアントライブラリ使用ドキュメント

• Go
• Java
• Python
• Ruby
• .Net
• Rust

ゲージ

ゲージは、任意に上下する単一の数値を示すメトリックです。

ゲージは通常、温度や現在のメモリ使用量などの測定値に使用されますが、同時リクエスト数のように増減する可能性のある「カウント」にも使用されます。

ゲージのクライアントライブラリ使用ドキュメント

• Go
• Java
• Python
• Ruby
• .Net
• Rust

ヒストグラム

ヒストグラムは、観測値（通常はリクエストの期間やレスポンスのサイズなど）をサンプリングし、設定可能なバケットにカウントします。また、すべての観測値の合計も提供します。

<basename>をベースメトリック名とするヒストグラムは、スクレイプ中に複数の時系列を公開します。

• 観測バケットの累積カウンター。<basename>_bucket{le="<upper inclusive bound>"}として公開されます。
• すべての観測値の合計。<basename>_sumとして公開されます。
• 観測されたイベントのカウント。<basename>_countとして公開されます（上記の<basename>_bucket{le="+Inf"}と同じ）。

histogram_quantile()関数を使用して、ヒストグラムまたはヒストグラムの集計からクォンタイルを計算します。ヒストグラムは、Apdexスコアの計算にも適しています。バケットで操作する場合、ヒストグラムが累積であることを忘れないでください。ヒストグラムとサマリーの詳細については、ヒストグラムの使用方法とサマリーとの違いを参照してください。

ヒストグラムのクライアントライブラリ使用ドキュメント

• Go
• Java
• Python
• Ruby
• .Net
• Rust

サマリー

ヒストグラムと同様に、サマリーも観測値（通常はリクエストの期間やレスポンスのサイズなど）をサンプリングします。観測値の総数とすべての観測値の合計も提供しますが、スライディングタイムウィンドウで設定可能なクォンタイルを計算します。

<basename>をベースメトリック名とするサマリーは、スクレイプ中に複数の時系列を公開します。

• 観測されたイベントのストリーミングφ-クォンタイル（0 ≤ φ ≤ 1）。<basename>{quantile="<φ>"}として公開されます。
• すべての観測値の合計。<basename>_sumとして公開されます。
• 観測されたイベントのカウント。<basename>_countとして公開されます。

φ-クォンタイル、サマリーの使用方法、およびヒストグラムとの違いの詳細については、ヒストグラムとサマリーを参照してください。

サマリーのクライアントライブラリ使用ドキュメント

• Go
• Java
• Python
• Ruby
• .Net

このドキュメントはオープンソースです。問題の提出やプルリクエストを通じて改善にご協力ください。