このページでは、アラート ポリシーに関連付けられているドキュメント テンプレートで使用可能な変数とチャネル固有のコントロールについて説明します。
変数の使用
Markdown に加えて、${varname} 形式の変数を使用して、ドキュメントの内容を調整できます。ドキュメントが通知付きで送信されると、文字列 ${varname} は varname の値に置き換えられます。次のスクリーンショットは、アラート ポリシーの作成: ドキュメントで説明されているドキュメント テンプレートから作成されたメール通知に含まれるドキュメントを示しています。
ドキュメント フィールドで使用できる変数は次のとおりです。
| 変数 | 値 |
|---|---|
condition.name |
条件の REST リソース名（例: projects/foo/alertPolicies/1234/conditions/5678） |
condition.display_name |
条件の表示名（例: CPU usage increasing rapidly） |
metadata.system_label.KEY |
システム提供のリソース メタデータ ラベルの値 KEY。1 |
metadata.user_label.KEY |
ユーザー定義のリソース メタデータ ラベルの値 KEY。1,4 |
metric.type |
指数タイプ（例: compute.googleapis.com/instance/cpu/utilization） |
metric.display_name |
指数タイプの表示名（例: CPU utilization） |
metric.label.KEY |
指標ラベル 値は、数字、文字、スラッシュ（/）、または等号（=）で始まる必要があります。他のすべての接頭辞は使用できません。値にサポートされていない接頭辞が含まれている場合、その値は報告されません。 |
policy.name |
ポリシーの REST リソース名（例: projects/foo/alertPolicies/1234） |
policy.display_name |
ポリシーの表示名（例: High CPU rate of change） |
policy.user_label.KEY |
ユーザーラベル KEY の値 1,2 |
project |
ワークスペースのプロジェクト ID（例: a-gcp-project） |
resource.type |
モニタリング対象リソースタイプ（例: gce_instance）。 |
resource.project |
アラート ポリシーのモニタリング対象リソースのプロジェクト ID |
resource.label.KEY |
リソースラベルKEYの値。1,3,4モニタリング対象リソースタイプに関連付けられたラベルを確認するには、リソースリストをご覧ください。 |
1 たとえば、${resource.label.zone} は zone ラベルの値に置き換えられます。これらの変数の値はグループ化されます。詳細については、null の値をご覧ください。
2 ポリシーのユーザーラベルは、Monitoring API を使用してのみ設定できます。
3 アラート ポリシーでモニタリング対象リソース上の project_id ラベルの値を取得するには、${resource.project} を使用します。
4 resource.label.KEY. を使用して、ユーザー定義のリソース メタデータ ラベルにアクセスすることはできません。代わりに metadata.user_label.KEY を使用してください。
null 値
metric.*、resource.*、metadata.* 変数の値は時系列から派生します。時系列クエリから返される値がない場合、値は null になる可能性があります。
- アラート ポリシーでクロス系列集約（縮約）が使用されている場合は、
resource.label.KEY変数とmetric.label.KEY変数でnull値を使用できます（たとえば、フィルタに一致する各時系列全体で SUM を計算する場合など）。クロス系列集約を使用する場合、グループ化に使用されていないラベルはドロップされ、変数の置き換えで参照されると、null値を持つようになります。クロス系列集計がない場合は、これらのラベルは自動的に保持されます。 metadata.*変数の値は、クロス系列集計の条件のフィルタまたはグループにラベルが明示的に含まれている場合にのみ、使用できます。つまり、フィルタまたはグループでメタデータ ラベルを参照して、テンプレートの値を取得する必要があります。
その他の使用上の注意
- 表に記載している変数のみがサポートされています。
${varname1 + varname2}のような、より複雑な式とそれらを組み合わせることはできません。 - リテラル文字列
${をドキュメントに含めるには、$記号を 2 つ目の$記号でエスケープします。$${はドキュメントでは${としてレンダリングされます。 - これらの変数は、通知チャネルを介して送信される通知でのみ、値に置き換えられます。Google Cloud Console では、ドキュメントが表示されるときに、値ではなく変数が表示されます。コンソールの例には、インシデントの説明や、アラート ポリシー作成時のドキュメントのプレビューなどがあります。
チャネル コントロールの使用
ドキュメント フィールド内のテキストには、通知チャネル自体がフォーマットや通知を制御するために使用する特殊文字を含めることもできます。
たとえば、Slack では @ が使用されます。これを使用して、通知を特定のユーザーにリンクできます。ドキュメント フィールドに次のような文字列を含めているとします。
<@backendoncall> policy ${policy.display_name} triggered an incident
ドキュメント フィールドが、関連する Slack チャンネルによって通知の一部として受信されると、この行によってユーザー backendoncall（policy High CPU rate of change
triggered an incident など）に対する追加メッセージがトリガーされます。
これらの追加オプションはチャネルに固有です。利用可能な追加オプションの詳細については、チャネル ベンダーが提供しているドキュメントをご覧ください。