ドキュメント テンプレートの変数

このページでは、アラート ポリシーに関連付けられているドキュメント テンプレートで使用可能な変数とチャネル固有のコントロールについて説明します。

変数の使用

Markdown に加えて、${varname} 形式の変数を使用してドキュメントの内容を調整できます。ドキュメントが通知とともに送信されるときに、文字列 ${varname}varname の値に置き換えられます。次のスクリーンショットは、ドキュメントの追加で説明しているドキュメント テンプレートから作成されたメール通知に含まれるドキュメントを示しています。

メール内のドキュメント

ドキュメント フィールドで使用できる変数は次のとおりです。

変数
condition.name 条件の REST リソース名(例: projects/foo/alertPolicies/1234/conditions/5678
condition.display_name 条件の表示名(例: CPU usage increasing rapidly
metric.type 指標タイプ(例: compute.googleapis.com/instance/cpu/utilization
metric.display_name 指標タイプの表示名(例: CPU utilization
metric.label.[KEY] 指標ラベル key の値1
policy.user_label.[KEY] ユーザーラベル key の値1、2
policy.name ポリシーの REST リソース名(例: projects/foo/alertPolicies/1234
policy.display_name ポリシーの表示名(例: High CPU rate of change
project ワークスペースのプロジェクト ID(例: a-gcp-project
resource.project アラート ポリシーのモニタリング対象リソースのプロジェクト ID
resource.type モニタリング対象リソースのタイプ(例: api
resource.label.[KEY] リソースラベル key の値1

1 たとえば、${resource.label.zone}zone ラベルの値に置き換えられます。
2 ポリシーのユーザーラベルは、Monitoring API を使用してのみ設定できます。

注:

  • 表に記載している変数のみがサポートされています。${varname1 + varname2} ような、より複雑な式に組み合わせることはできません。

  • リテラル文字列 ${ をドキュメントに含めるには、$ 記号を 2 つ目の $ 記号でエスケープします。$${ はドキュメントでは ${ としてレンダリングされます。

チャネル コントロールの使用

ドキュメント フィールド内のテキストには、通知チャネル自体がフォーマットや通知を制御するために使用する特殊文字を含めることもできます。

たとえば、Slack では @ が使用されます。これを使用して、通知を特定のユーザーにリンクできます。ドキュメント フィールドに次のような文字列を含めているとします。

<@backendoncall> policy ${policy.display_name} triggered an incident

このドキュメント フィールドが、関連する Slack チャネルによって通知の一部として受信されると、この行によって、ユーザー backendoncall への追加メッセージ(例: policy High CPU rate of change triggered an incident)がトリガーされます。

これらの追加オプションはチャネルに固有です。利用可能な追加オプションの詳細については、チャネル ベンダーが提供しているドキュメントをご覧ください。

このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...

ご不明な点がありましたら、Google のサポートページをご覧ください。