MQL のアラートポリシー

条件に MQL クエリを含む Monitoring アラートポリシーを作成できます。アラート条件の MQL クエリは、MQL アラートオペレーションが含まれる以外はその他の MQL クエリです。

このページでは、MQL アラートオペレーションを紹介し、それを使用するアラートポリシーを作成する方法について説明します。Monitoring アラートポリシーの概要については、アラートの動作をご覧ください。

MQL アラートオペレーション

MQL では、しきい値のアラートポリシーと不在のアラートポリシーの両方を作成できます。

クエリで次のいずれかの MQL アラートオペレーションを使用して、MQL ベースのアラートポリシーを作成します。

しきい値アラートの condition オペレーション。
不在のアラートのための absent_for オペレーション。

クエリは、これらのオペレーションのいずれかで終わる必要があります。詳細については、MQL リファレンスのアラートのセクションをご覧ください。

クエリに、明示的な期間指定、つまり within オペレーションを含めないようにしてください。

MQL を使用してアラートポリシーを作成する場合は、fetch、filter、group_by などを使用して MQL クエリを作成し、対象の時系列を特定します。クエリのこの部分は、グラフの時系列データを取得するために使用されるクエリと同じです。たとえば、次のクエリは、米国中部リージョンにあるすべての Compute Engine VM インスタンスの CPU 使用率を取得します。

fetch gce_instance::compute.googleapis.com/instance/cpu/utilization
| filter zone =~ 'us-central.*'

このクエリでは、出力テーブルが生成されます。アラートを作成するには、出力テーブルをアラートオペレーションに連結します。アラートオペレーションでは、アラートオペレーションより前のクエリによって生成される出力テーブルのデータ値のブール値を計算します。

アラートオペレーションでは、入力テーブルのデータを評価するための式を指定します。しきい値条件の場合、式で「0.5 未満かどうか」のようなしきい値に照らして各ポイントをテストします。

Monitoring のアラート機能は、アラートオペレーションの結果を使用して、アラートポリシーがトリガーされるかどうかとタイミングを決定します。アラートの構成では、決定の方法を説明しています。

しきい値のアラート

しきい値のアラートには、condition オペレーションを使用します。条件オペレーションでは、「値が 15 パーセントより大きい」のようなしきい値に照らして値を評価し、ブール値を返します。

condition オペレーションでは、入力テーブルを明示的なアライメントウィンドウに合わせる必要があります。入力テーブルを明示的なウィンドウにアライメントするには、アライメントウィンドウ（例: align delta_gauge(5m)）を align オペレーションに指定するか、スライディングタイムウィンドウが配置された一時的な group_by を使用します。次の例では、sliding オペレーションで group_by を使用しています。

fetch gce_instance::compute.googleapis.com/instance/cpu/utilization
| filter zone =~ 'us-central.*'
| group_by sliding(5m), mean(val())
| condition val() > .15 '10^2.%'

デフォルトの group_by ウィンドウ設定はスライドしているため、前のクエリの group_by 式は group_by 5m, mean(val()) と同じです。

条件で、使用率の値がしきい値の 15% を超えているかどうか判断するために、アライメントされた入力テーブルの各データポイントをテストします。condition 演算子によって生成されるテーブルには、しきい値の評価結果を記録するブール値列と、入力テーブルからの utilization 値のコピーが含まれる列の 2 つの列があります。

CPU 使用率の値は、小数の使用率として保存されます。値の範囲は 0.0～1.0 です。指標記述子では、これらの値の単位が 10^2.% として指定され、グラフではパーセンテージで表示されます。しきい値の単位には互換性が必要であるため、しきい値を .15 '10^2.% として表現します。

指標タイプの単位は、該当する指標タイプの表に記載されています。指標タイプ compute.googleapis.com/instance/cpu/utilization については、compute テーブルをご覧ください。

MQL の単位の詳細については、測定単位をご覧ください。

不在のアラート

不在のアラートの場合は、absent_for オペレーションを使用します。このオペレーションでは、データが欠落している期間を使用します。たとえば、次のテストでは、米国中部ゾーンから 8 時間分のデータが欠落しているかどうかをテストします。

fetch gce_instance::compute.googleapis.com/instance/cpu/utilization
| filter zone =~ 'us-central.*'
| absent_for 8h

absent_for オペレーションでは、条件を満たすためにデータが欠落している時間の長さを示す duration 引数のみを使用します。

データが過去 24 時間以内に出現したものの、期間（この例では過去 8 時間）内には欠落している場合は、データが不在と見なされます。

absent_for クエリでは、デフォルトのアライメント、または absent_for オペレーションの後に every オペレーションを使用して、値が整列された出力テーブルを作成します。

出力テーブルには 2 つの列があります。

1 番目の列は、データが存在しない場合のブール値の結果を記録する active 列です。true 値は、過去 24 時間に入力ポイントが存在し、期間内には入力ポイントが存在しないことを示しています。
2 番目の列は signal 列です。入力テーブルに値列がある場合、signal 列には最新の入力ポイントの最初の値列の値が格納されます。入力テーブルに値列がない場合、signal 列には最後の入力ポイントが記録されてからの分数が格納されます。次の例に示すように、このケースは簡単に強制できます。
```
fetch gce_instance::compute.googleapis.com/instance/cpu/utilization
| filter zone =~ 'us-central.*'
| value []
| absent_for 8h
```
前の例では、value [] オペレーションで入力テーブルから値列が削除されるため、absent_for オペレーションによって作成されたテーブルの signal 列には最後の入力ポイントが記録されてからの分数が格納されます。

アラートの構成

MQL クエリに加えて、アラートポリシー条件には他にも 2 つの値が含まれます。

条件を満たす必要のある入力時系列の数。この値は、次のいずれかになります。
- 1 つの時系列。
- 特定の数の時系列。
- 時系列の割合。
- すべての時系列。
アラート状態の期間、つまりアラート条件が継続的に true に評価される期間。

特定の時系列でアラートクエリが true と評価される時間が継続している場合、その時系列はアクティブとみなされます。指定された数の時系列がアクティブな場合、アラートポリシーがトリガーされ、アクティブな時系列ごとにアラートが生成されます。アラートポリシーの評価方法については、アラートの動作をご覧ください。

条件で MQL を使用する場合、その条件がポリシー内の唯一の条件である必要があります。MQL ベースのアラートポリシーでは複数の条件を使用できません。

MQL アラートポリシーの作成（コンソール）

Google Cloud Console から MQL ベースのアラートポリシーを作成するには、アラートポリシーの管理で説明されている、通常のポリシー作成手順に沿って操作します。アラートポリシーの条件を作成する場合は、フォームベースの指標セレクタではなく Query Editor を使用します。

MQL ベースのアラートポリシーの条件エディタ。

次のように条件を入力します。

[Untitled Condition] フィールドに値を入力して、条件に名前を付けます。保存すると、条件に数値形式の識別子が割り当てられます。このオプションの表示名には、よりわかりやすい説明を指定できます。
アラート条件を開始するには、Query Editor でモニタリングするデータを選択するクエリを入力します。次のクエリは、時系列を取得して 5 分間の時間枠に配置します。
```
fetch gce_instance
| metric 'compute.googleapis.com/instance/cpu/utilization'
| group_by 5m, mean(val())
```
この時点で [Run Query] をクリックすると、グラフが表示されます。1 つのプロジェクトでこのクエリを実行すると、次の結果が生成されます。
次のいずれかのオペレーションを使用して、クエリにアラート句を追加します。
- condition 演算子。しきい値アラートに使用します。
- 不在アラートの absent_for 演算子。
これらのアラートオペレーションの詳細については、MQL リファレンスのアラートをご覧ください。

次の例では、condition オペレーションを使用してしきい値を指定しています。
```
fetch gce_instance
| metric 'compute.googleapis.com/instance/cpu/utilization'
| group_by 5m, mean(val())
| condition val() > .05
```
この時点で [Run Query] をクリックすると、次のスクリーンショットに示すように、グラフに条件のしきい値行が追加されます。
まだクエリを実行していない場合は、[Run Query] をクリックします。
[Configuration] ペインで、アラートポリシーがトリガーされるタイミングを指定します。次の 2 つの値を指定します。
- [Condition triggers if] では、アラートポリシーをトリガーするまでに、アラートオペレーションを満たす必要があるクエリによって返される時系列の数を指定できます。指定できる条件は次のとおりです。
  - 1 つの時系列。
  - 特定の数の時系列。
  - 時系列の割合。
  - すべての時系列。
- [For] では、アラートポリシーがトリガーされる条件が満たされる期間を指定できます。これは、MQL クエリで使用されるアライメントウィンドウとは異なります。これらの値の関係については、アライメント期間と期間をご覧ください。
  
  注: absent_for を使用するアラートクエリには、クエリに暗黙的な期間があります。absent_for 8h を使用するクエリとします。1 時間の期間を使用する場合、アラートポリシーがトリガーされるためには、アラートクエリが、直近の 1 時間にわたって 30 秒ごとの各評価期間において true と評価される必要があります。8 時間の absent_for ウィンドウにわたって条件が true と評価された場合、1 時間の期間は実質的にさらに 1 時間が追加され、absent_for 9h と同等となります。UI では値を選択する必要があるため、MQL の不在アラートでの低い値を選択してください。詳細については、期間時間枠をご覧ください。
[Add] をクリックして、条件を保存します。アラートポリシーの条件のクエリは厳密な形式に変換されません。
残りのアラートポリシーの構成に進みます。

MQL アラートポリシーの作成（API）

API を使用する場合は、ポリシーを設定するときに MonitoringQueryLanguageCondition 型の条件を作成します。詳細については、アラートポリシーの条件の作成をご覧ください。

次に、ポリシーを通常どおり alertPolicies.create に渡します。

MQL のアラート ポリシー

MQL アラート オペレーション