メトリクス タイプ

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

カウンター

カウンター は、値が増加するか、再起動時にゼロにリセットされるだけの単調増加カウンターを表す累積メトリクスです。たとえば、カウンターを使用して、処理されたリクエスト数、完了したタスク数、またはエラー数を表すことができます。

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

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

ゲージ

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

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

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

ヒストグラム

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

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

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

histogram_quantile() 関数を使用して、ヒストグラムまたはヒストグラムの集計から分位数を計算します。ヒストグラムは、Apdex スコアの計算にも適しています。バケットで操作する場合、ヒストグラムは累積的であることに注意してください。ヒストグラムの使用法とサマリーとの違いの詳細については、ヒストグラムとサマリーを参照してください。

**注:** Prometheus v2.40 以降、ネイティブ ヒストグラムの試験的サポートがあります。ネイティブ ヒストグラムには、合計と観測カウントに加えて、動的な数のバケットを含む時系列が 1 つだけ必要です。ネイティブ ヒストグラムは、コストのごく一部で、はるかに高い解像度を実現します。ネイティブ ヒストグラムが安定した機能に近づくにつれて、詳細なドキュメントが続きます。

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

サマリー

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

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

  • 観測されたイベントのストリーミング **φ 分位数** (0 ≤ φ ≤ 1)。<basename>{quantile="<φ>"} として公開されます
  • すべての観測値の**合計**。<basename>_sum として公開されます
  • 観測されたイベントの**カウント**。<basename>_count として公開されます

φ 分位数、サマリーの使用方法、およびヒストグラムとの違いの詳細な説明については、ヒストグラムとサマリーを参照してください。

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

このドキュメントはオープンソースです。問題の報告やプル リクエストを送信して、改善にご協力ください。