PromQL クエリ¶

グラフに PromQL クエリを適用することで、Prometheus データソースから時系列データを抽出・分析し、その結果をグラフに可視化できます。

クエリを開始する¶

1. 「PromQL クエリを追加」をクリックします。
2. クエリ方式を選択します。
3. クエリを開始します。

クエリ方式¶

詳細については、DQL と他のクエリ言語との比較 を参照するか、PromQL をご確認ください。

Range クエリ（範囲クエリ）¶

一定期間の監視データをクエリし、範囲ベクトル（Range Vector）を返します。これは、各時系列の指定期間における複数のサンプル値です。構文には時間範囲を付加する必要があります。

例：

[5m]）：http_requests_total{job="api-server"}[5m]

これは、過去5分間の各時点におけるリクエスト総数を返します。

Instant クエリ（即時クエリ）¶

特定の時点の監視データをクエリし、即時ベクトル（Instant Vector）を返します。これは、各時系列のその時点における最新のサンプル値です。

例：

http_requests_total{job="api-server"}

これは、現在時刻においてラベル条件を満たすすべてのリクエスト総数を返します。

クエリ例¶

例えば、特定のリージョンの同時実行制限器がトリガーされたかどうかを監視し、潜在的なパフォーマンス問題やリソースのボトルネックを早期に発見したい場合。

dataplatform:system_concurrent_limiter_current{region="#{region}"} > 0

上記のクエリ文を入力すると、system_concurrent_limiter_current メトリクスの値が0より大きいすべてのデータポイントをフィルタリングし、かつそれらのデータポイントの region ラベル値が #{region} であることを意味します。

region の値が us-west-1 の場合、実際のクエリ文は次のようになります：

dataplatform:system_concurrent_limiter_current{region="us-west-1"} > 0

このクエリは、region が us-west-1 であり、かつ system_concurrent_limiter_current メトリクスの値が0より大きいすべての時系列データを返します。

フィルター条件¶

PromQL モードでは、フィルター条件はラベル文字列のマッチングのみをサポートします。システムは自動的に条件に合致するフィルターを PromQL ラベルマッチャーに変換します。

サポートされる変換ルール¶

サポートされないフィルター¶

以下のフィルター条件は現在サポートされていません：

• 異なるラベル間の OR

• 数値比較（>、<、>=、<=）

• 関数系フィルター

適用シナリオ¶

PromQL クエリインターフェースの定義には、クエリのデータ処理動作を制御する3つのパラメータがあります。それぞれ interval、timerange、align_time で、その意味は以下の通りです：