このページでは、条件に PromQL クエリを使用してアラート ポリシーを作成するさまざまな方法について説明します。
PromQL ベースの条件でのアラート ポリシーでは、Monitoring Query Language(MQL)クエリを使用してアラート ポリシー条件を構成する代わりに、オープンソースを使用できます。PromQL クエリを使用すると、比率、動的しきい値、統合指標などの機能を設定した複雑な条件を作成できます。
Google Cloud 以外の環境で Prometheus を使用する場合、または Prometheus 向けのマネージド サービスでアラートを使用する場合は、Prometheus のアラート ルールを PromQL ベースの条件を使用するアラート ポリシーに移行できます。これにより、すべてのアラート ポリシーを Cloud Monitoring で管理できます。
Grafana ダッシュボードを Cloud Monitoring にインポートすることもできます。
- Monitoring で PromQL を使用する場合の一般的な情報については、Cloud Monitoring の PromQL をご覧ください。
- アラート ポリシーの概要については、指標ベースのアラート ポリシーの動作をご覧ください。
概要
PromQL ベースの条件でアラート ポリシーを作成するには、次の方法があります。
Google Cloud コンソールでアラート ポリシーを作成し、コードエディタで PromQL クエリを定義します。
gcloud CLI または Monitoring API の
AlertPolicy
構成を使用して、PromQL ベースの条件でアラート ポリシーを作成します。Google Cloud CLI を使用して、Prometheus のアラートルールと通知チャンネルを Cloud Monitoring に移行します。
PromQL ベースの条件を含むアラート ポリシーによって作成されたインシデントは、他のインシデントとともに Google Cloud コンソールに表示されます。これらのインシデントは Google Cloud コンソールで操作できます。
PromQL アラート ポリシーの条件では、Google Cloud システム指標、カスタム指標、ログベースの指標、Prometheus 指標など、Cloud Monitoring の任意の指標を参照できます。Prometheus 以外の指標の名前を PromQL 指標構文に変換する必要があります。詳細については、Monitoring 指標を PromQL にマッピングするをご覧ください。
制限事項
PromQL ベースの条件を含むアラート ポリシーでは、再テスト期間を最大 24 時間、調整期間を最大 24 時間に設定できます。再テスト期間と調整期間の合計は 25 時間以内にする必要があります。
Prometheus アラートルールでカスタム指標を参照する場合は、まず Cloud Monitoring に同等のカスタム指標記述子が必要です。
料金
一般に、Cloud Monitoring システムの指標は無料であり、外部システム、エージェント、またはアプリケーションの指標はそうではありません。課金対象の指標は、取り込まれたバイト数とサンプル数のいずれかによって課金されます。
Cloud Monitoring の料金の詳細については、次のドキュメントをご覧ください。
次のステップ
Google Cloud コンソールを使用して、PromQL クエリの条件でアラート ポリシーを作成する方法については、PromQL ベースの条件でアラート ポリシーを作成する(コンソール)をご覧ください。
Cloud Monitoring API を使用して PromQL で直接アラート ポリシーを作成する方法については、PromQL ベースの条件(API)でアラート ポリシーを作成するをご覧ください。
PromQL アラートルールを PromQL クエリを使用するアラート ポリシーに移行する方法については、Prometheus からアラートルールとレシーバーを移行するをご覧ください。
Grafana ダッシュボードのインポートについては、Grafana ダッシュボードを Cloud Monitoring にインポートするをご覧ください。