指標トピックでは、PrometheusのPromQL構文を使用して指標データをクエリします。詳細な構文の説明については、Prometheus公式ドキュメントを参照してください。本記事では、基本的な使用方法をすばやく理解できるように、一部の一般的な構文と操作手順を主に紹介します。 指標クエリには2つのクエリ方法が含まれます:
範囲クエリ:つまりPrometheus Range queriesは、クエリ時間範囲内で、時間間隔(step)に従って各時点の指標データをクエリします。指標の変化傾向をクエリするためによく使用されます。 説明:
クエリ時間間隔(step)が指標収集間隔より短い場合、クエリ結果に重複データが表示されます。例えば、CPU使用率が15秒ごとに1回報告される場合、クエリ時間間隔が1秒のとき、同じ値が15個含まれる重複データが表示されます。
最新値クエリ:つまりPrometheus Instant queriesは、クエリ時間範囲の終了時点における最新の指標データを返します。現在の指標値をクエリするためによく使用されます。終了時点から5分前までの間に指標データがない場合、対応するクエリ結果はありません。 よく使う文法
1. 指標名を指定し、その指標名における各次元の指標値の変化傾向をクエリします。例えば、ディスク容量(disk_total)をクエリします。
2. 指標名と次元を指定し、特定の次元の組み合わせにおける指標値の変化傾向をクエリします。例えば、ホスト名(host)が 6c74e00eb825、パス(path)が /etc/hostname のディスク容量:
disk_total{host="6c74e00eb825", path="/etc/hostname"}
3. 指定された次元に従って指標データを集計します。例えば、各ホスト(host)、各デバイス(device)のディスク容量の合計をクエリします。
sum by (host,device)(disk_total)
操作手順
2. 左側のナビゲーションバーで検索分析を選択し、左側のリスト上部で指標トピックを選択し、次にクエリする指標トピックを選択します。
3. 入力ボックスにクエリ文を入力し、右側のをクリックして指標をクエリします。また、指標を閲覧をクリックして、現在存在する指標名をクエリすることもできます。