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

タイトルテンプレートは、イベントを条件で開く場合に使用します。 デフォルトのタイトルを上書きします。

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

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

タイトル テンプレートの使用はオプションですが、推奨されます。アラート条件は、監視する一連の閾値を定義します。 これらの閾値のいずれかが違反された場合、大量イベントが作成されます。 わかりやすいタイトル テンプレートを使用すると、問題を正確に特定し、停止をより迅速に解決できます。

/ <img title="alert details page" alt="A screenshot depicting the final step of creating an alert condition- the alert details page" src="/images/alerts_screenshot-crop_adding-alert-details-to-an-alert-condition.webp" /> <figcaption> Go to <DNT>one.newrelic.com > All capabilities</DNT> > <DNT> Alerts </DNT> > <DNT> Alert Conditions</DNT> and select a pre-existing alert condition or create a new alert condition to use the title template to easily identify related alert events. </figcaption> /

あなたが始める前に

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

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

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

電子商取引サイトを運営しており、ネットワーク エラーが多いときに集中イベントをトリガーするアラート条件を作成したとします。 タイトル テンプレートを使用すると、この条件からの頻繁なイベントを簡単に識別できるようになります。

このアラート条件に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 alert event

  コピー

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

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

  Host {{tags.hostName}}, cluster {{tags.cluster}} alert event

  コピー

タグ名にはスペースを含めることはできませんが、展開された値にはスペースを含めることができます。利用可能なプロパティの完全なリストについては、 「集中イベント プロパティ」を参照してください。