Prometheus クライアント ライブラリは、4 つの主要なメトリクス タイプを提供します。これらは現在、クライアント ライブラリ(特定のタイプの使用法に合わせた API を有効にするため)とワイヤ プロトコルでのみ区別されます。 Prometheus サーバーはまだタイプ情報を使用しておらず、すべてのデータを型のない時系列にフラット化します。これは将来変更される可能性があります。
カウンター は、値が増加するか、再起動時にゼロにリセットされるだけの単調増加カウンターを表す累積メトリクスです。たとえば、カウンターを使用して、処理されたリクエスト数、完了したタスク数、またはエラー数を表すことができます。
減少する可能性のある値を公開するためにカウンターを使用しないでください。たとえば、現在実行中のプロセス数にカウンターを使用しないでください。代わりにゲージを使用してください。
カウンターのクライアント ライブラリ使用状況ドキュメント
ゲージ は、任意に上下する単一の 数値を表すメトリクスです。
ゲージは通常、温度や現在のメモリ使用量などの測定値に使用されますが、同時リクエスト数など、上下する可能性のある「カウント」にも使用されます。
ゲージのクライアント ライブラリ使用状況ドキュメント
ヒストグラム は、観測値(通常はリクエスト期間やレスポンス サイズなど)をサンプリングし、設定可能なバケットでカウントします。また、すべての観測値の合計も提供します。
ベース メトリクス名が <basename>
のヒストグラムは、スクレイプ中に複数の時系列を公開します
<basename>_bucket{le="<上限値>"}
として公開されます<basename>_sum
として公開されます<basename>_count
として公開されます(上記の <basename>_bucket{le="+Inf"}
と同じ)histogram_quantile()
関数を使用して、ヒストグラムまたはヒストグラムの集計から分位数を計算します。ヒストグラムは、Apdex スコアの計算にも適しています。バケットで操作する場合、ヒストグラムは累積的であることに注意してください。ヒストグラムの使用法とサマリーとの違いの詳細については、ヒストグラムとサマリーを参照してください。
ヒストグラムのクライアント ライブラリ使用状況ドキュメント
ヒストグラム と同様に、サマリー は観測値(通常はリクエスト期間やレスポンス サイズなど)をサンプリングします。観測の総数とすべての観測値の合計も提供しますが、スライド時間枠で設定可能な分位数を計算します。
ベース メトリクス名が <basename>
のサマリーは、スクレイプ中に複数の時系列を公開します
<basename>{quantile="<φ>"}
として公開されます<basename>_sum
として公開されます<basename>_count
として公開されますφ 分位数、サマリーの使用方法、およびヒストグラムとの違いの詳細な説明については、ヒストグラムとサマリーを参照してください。
サマリーのクライアント ライブラリ使用状況ドキュメント
このドキュメントはオープンソースです。問題の報告やプル リクエストを送信して、改善にご協力ください。