このドキュメントでは、Cloud Monitoring で Prometheus Query Language（PromQL）を使用する方法について説明します。PromQL は、グラフとダッシュボードを作成するための、Metrics Explorer のメニュー ドリブンおよび Monitoring Query Language（MQL）インターフェースの代替を提供します。
PromQL を使用すると、次のソースからの Cloud Monitoring のデータをクエリおよびグラフ化できます。
- Cloud Monitoring システム指標のリストに記載されている指標を書き込む Google Kubernetes Engine や Compute Engine などの Google Cloud サービス。
- ログベースの指標などのユーザー定義の指標や Cloud Monitoring のユーザー定義の指標。
- Google Cloud の Prometheus 向けのフルマネージド マルチクラウド ソリューションである、Google Cloud Managed Service for Prometheus。マネージド サービス（PromQL からのサポートを含む）については、Google Cloud Managed Service for Prometheus をご覧ください。
Grafana などのツールを使用して、Cloud Monitoring に取り込まれた指標データをグラフにすることもできます。使用可能な指標には、指標のリストに記載されている Managed Service for Prometheus の指標と Cloud Monitoring の指標が含まれます。Prometheus API に基づく Grafana などのツールの設定については、Grafana に関する Managed Service for Prometheus のドキュメントをご覧ください。
Grafana ダッシュボードを Cloud Monitoring にインポートすることもできます。
命名規則
Prometheus の指標モデルと命名規則は、Cloud Monitoring で使用されるものとは異なります。PromQL を使用して Monitoring の指標データをクエリするには、Cloud Monitoring の名前を PromQL と互換性のある同等のものに変換する必要があります。命名規則については、Cloud Monitoring の指標を PromQL にマッピングするをご覧ください。
Cloud Monitoring での PromQL へのアクセス
Google Cloud コンソールの次のページの [コード] タブから PromQL を使用できます。
- Metrics Explorer
- カスタム ダッシュボードの作成時にグラフを追加する
エディタへのアクセス方法と使用方法については、PromQL エディタの使用をご覧ください。
Prometheus のルールとアラート
PromQL を使用して、Managed Service for Prometheus で Prometheus スタイルのアラートを使用することにより、Cloud Monitoring の任意の指標に対して記録とアラートのルールを作成できます。詳細については、マネージド ルールの評価とアラートまたはセルフデプロイ ルールの評価とアラートをご覧ください。
PromQL の学習
PromQL の基本的な使用方法については、オープンソースのドキュメントを参照することをおすすめします。以下のリソースが役に立ちます。
PromQL の違い
Cloud Monitoring の PromQL は、アップストリームの PromQL とは若干異なる場合があります。これらの違いの一覧については、PromQL の違いをご覧ください。