NRQL アラート条件のタイトル テンプレート

タイトル テンプレートは、条件によってインシデントが開かれるときに使用されます。 デフォルトのタイトルを上書きします。

タイトル テンプレートを使用する理由は何ですか?

アラート条件はインシデント作成の基礎となります。 ガイド モードを使用する場合でも、チャートやポリシーから条件を作成する場合でも、一意のタイトル テンプレートを使用することが、アラート条件を作成するための最後の手順となります。

タイトル テンプレートの使用はオプションですが、推奨されます。 アラート条件は、モニターする閾値のセットを定義します。 これらの閾値のいずれかが破られると、インシデントが生成されます。 意味のあるタイトル テンプレートを使用すると、問題を正確に特定し、停止をより迅速に解決できます。

あなたが始める前に

タイトル テンプレートを使用する前に注意すべき重要な点は次のとおりです。

• 互換性: タイトル テンプレート機能は、NRQL 条件でのみ使用できます。
• 文字数制限: タイトル テンプレートの最大長は 256 文字です。
• フォーマット: タイトル テンプレートは有効なHandlebarsフォーマットに従う必要があります。
• 信号喪失インシデント: 信号喪失によってトリガーされたインシデントの場合、デフォルトのタイトルが常に使用されます。 信号損失の詳細については、「信号損失とギャップの埋め込み」を参照してください。

タイトルテンプレートを理解する

たとえば、電子商取引サイトを運営していて、ネットワーク エラーが多い場合にインシデントをトリガーするアラート条件を作成したとします。 タイトル テンプレートを使用すると、この条件によるインシデントを簡単に識別できます。

このアラート条件にHigh Network Errorsという名前を付けました。 ただし、インシデントのタイトルには、エンティティと優先度に関する詳細情報を反映させる必要があります。

例:

{{conditionName}} Affecting {{entity.name}} - {{entity.type}} - {{priority}}

このテンプレートでは、次のインシデント タイトルが生成されます。

High Network Errors Affecting Entity123 - Kubernetes Pod - Critical

タイトルテンプレートを使用する

タイトル テンプレートは、UI 経由または GraphQL を使用する 2 つの方法で操作できます。 方法については、次の手順に従ってください。

mutation {
  alertsNrqlConditionStaticUpdate(
    accountId: 123456
    id: 456789
    condition: { titleTemplate: "{{conditionName}} has triggered an incident" }
  ) {
    titleTemplate
  }
}

属性を使用して条件をさらに定義する

タイトル テンプレートにインシデント イベント属性のサブセットを含めて、より多くのコンテキストを追加できます。

その方法は次のとおりです。

• {{AN_ATTRIBUTE}}形式を使用します。 例えば：

  {{conditionName}} has triggered an incident

  コピー

• タグ属性: タグには、 {{tags.TAG_NAME}}形式を使用します。

• ファセット句タグ: NRQL 条件でFACET句が使用されている場合は、 tagsフォーマットを使用して、タイトル テンプレートでそれらの値を使用できます。 たとえば、NRQL クエリにFACET hostName, cluster含まれている場合は、次のように使用できます。

  Host {{tags.hostName}}, cluster {{tags.cluster}} incident

  コピー

タグ名にはスペースを含めることはできませんが、展開された値にはスペースを含めることができます。 使用可能な属性の完全なリストについては、 「インシデント イベント属性」を参照してください。