通知

概要

通知は、チームに問題を知らせ、トラブルシューティングをサポートするモニターの重要なコンポーネントです。モニターを作成する場合は、何が起こっているかを伝えるセクションとチームに通知するセクションを追加します。

Say what’s happening

このセクションを使用して、チームに送信する通知を設定します。

タイトル

モニターに一意のタイトルを追加します(必須)。マルチアラートモニターの場合、トリガースコープを識別するいくつかのタグが自動的に挿入されます。また、タグ変数を使用できます。

メッセージ

メッセージフィールドでは、標準のマークダウンフォーマット変数を使用できます。@通知を使用して別の連絡先に送信される通知テキストを調整するには、条件付き変数を使用します。

モニターメッセージの一般的な使用例は、問題を解決するための段階的な方法を含めることです。次に例を示します。

Steps to free up disk space:
1. Remove unused packages
2. Clear APT cache
3. Uninstall unnecessary applications
4. Remove duplicate files

タグ

モニターにタグを追加します。モニタータグは、メトリクスタグとは異なります。UI でモニターのグループ化と検索に使用されます。タグポリシーが構成されている場合、必要なタグとタグ値を追加する必要があります。詳しくは、タグポリシーを参照してください。

ポリシータグ構成の表示。'Policy tags' の下には、'Select value' のドロップダウンの横に、cost_center、product_id、env の 3 つのタグの例が示されています。

再通知

モニターの再通知(オプション)を有効にすると、問題の未解決をチームに知らせることができます。

再通知の有効化

再通知の間隔、再通知の対象となるモニターの状態 (alertno datawarn) を構成し、オプションで再通知メッセージの送信数の制限を設定します。

例えば、stop renotifying after 1 occurrence (1 回発生したら再通知を停止する) ようにモニターを設定すると、メインの警告の後に 1 回のエスカレーションメッセージを受信することができます。 注: 再通知の属性とタグの変数には、再通知の期間中にモニターが利用できるデータが入力されます。

再通知が有効になっている場合、モニターが指定した時間、選択した状態のいずれかに留まっている場合に送信されるエスカレーションメッセージを含めるオプションが提供されます。

エスカレーションメッセージは次の方法で追加できます。

  • 元の通知メッセージの {{#is_renotify}} ブロック (推奨)。
  • Say what's happening セクションの Renotification message フィールド。
  • API の escalation_message 属性。

{{#is_renotify}} ブロックを使用する場合、元の通知メッセージも再通知に含まれます。

  1. {{#is_renotify}} ブロックには余分な詳細のみを含め、元のメッセージの詳細は繰り返さないでください。
  2. グループのサブセットにエスカレーションメッセージを送信します。

サンプルセクションで、これらのユースケースに合わせてモニターを構成する方法を学びましょう。

優先度

モニターに関連付けられた優先度 (オプション) を追加します。値の範囲は P1 から P5 で、P1 が最高の優先度、P5 が最低の優先度です。通知メッセージでモニターの優先度を上書きするには、{{override_priority 'Pi'}} を使用し、Pi を P1 から P5 の間で設定します。

たとえば、alert および warning 通知を異なる優先度で設定できます。

{{#is_alert}}
{{override_priority 'P1'}}
 ...
{{/is_alert}}

{{#is_warning}}
{{override_priority 'P4'}}
...
{{/is_warning}}

チームへの通知

電子メール、Slack、PagerDuty などを使用してチームに通知を送信するには、このセクションを使用してください。ドロップダウンボックスから、チームメンバーおよび接続済みのインテグレーションを検索できます。このセクションに @notification が追加されている場合、通知は自動的にメッセージフィールドに追加されます。

: @通知 は最後の行文字との間にスペースが必要です。次に例を示します。

Disk space is low @ops-team@company.com

通知

@通知は以下に送信できます。

Email

  • Notify an active Datadog user by email with @<DD_USER_EMAIL_ADDRESS>.

    Note: An email address associated with a pending Datadog user invitation or a disabled user is considered inactive and does not receive notifications.

  • Notify any non-Datadog user by email with @<EMAIL>.

インテグレーション

Notify your team through connected integrations by using the format @<INTEGRATION_NAME>-<VALUES>.

This table lists prefixes and example links:

IntegrationPrefixExamples
Jira@jiraExamples
PagerDuty@pagerdutyExamples
Slack@slackExamples
Webhooks@webhookExamples

Handles that include parentheses ((, )) are not supported. When a handle with parentheses is used, the handle is not parsed and no alert is created.

追加コンテンツのトグル

モニター通知には、モニターのクエリ、使用された @メンション、メトリクススナップショット (メトリクスモニターの場合)、Datadog の関連ページへのリンクなどのコンテンツが含まれます。個々のモニターの通知に含める、または除外するコンテンツを選択するオプションがあります。

モニタープリセットを設定する

オプションは、以下の通りです。

  • Default: コンテンツが隠れることはありません。
  • Hide Query: 通知メッセージからモニターのクエリを削除します。
  • Hide Handles: 通知メッセージで使用されている @メンションを削除します。
  • Hide All: 通知メッセージには、クエリ、ハンドル、スナップショット (メトリクスモニター用)、フッターの追加リンクは含まれません。

: インテグレーションによっては、デフォルトで表示されないコンテンツがあります。

変更

イベントは、モニターが作成、変更、無音、または削除されるたびに作成されます。Notify オプションを設定して、これらのイベントをチームメンバー、チャットサービス、モニター作成者に通知します。

アクセス許可

すべてのユーザーは、関連するロールに関係なく、すべてのモニターを読むことができます。

デフォルトでは、モニターの書き込み権限を持つユーザーのみがモニターを編集できます。Datadog Admin ロールおよび Datadog Standard ロールには、デフォルトでモニターの書き込み権限があります。オーガニゼーションでカスタムロールを使用している場合、他のカスタムロールにモニターの書き込み権限が付与されていることがあります。

モニターの編集が許可されるロールのリストを指定することで、さらにモニターに制限を設定できます。モニターの作成者は、常にモニターを編集することが可能です。

RBAC 制限付きモニター

編集には、モニターのコンフィギュレーションの更新、モニターの削除、モニターのミュート(時間の長短を問わず)などが含まれます。

: 制限は UI と API の両方に適用されます。

モニターの RBAC 設定や、モニターを固定設定からロール制限の使用へ移行する方法について、詳しくはモニターに RBAC を設定する方法をご参照ください。

テスト通知

テスト通知は、ホスト、メトリクス、異常、外れ値、予測値、ログ、RUM、APM、インテグレーション(チェックのみ)、プロセス(チェックのみ)、ネットワーク(チェックのみ)、カスタムチェック、イベント、複合条件のモニターの種類でサポートされています。

テストを実行する

  1. モニターを定義したら、モニターページの右下にある Test Notifications ボタンを使用して通知をテストします。

  2. テスト通知ポップアップから、テストするモニターケースを選択します。テストできるのは、アラート条件で指定されたしきい値について、モニターのコンフィギュレーションで使用可能な状態のみです。ただし、回復しきい値は例外です。これは、モニターがアラート状態でなくなったか、警告状態がなくなったときに、Datadog が回復通知を送信するためです。

    このモニターの通知をテストする
  3. Run Test をクリックして、モニターにリストされている人とサービスに通知を送信します。

イベント

テスト通知は、イベントエクスプローラー内で検索できるイベントを生成します。テストを開始したユーザーをメッセージ本文で示し、通知のタイトルに [TEST] が付きます。

タグ変数は、Datadog 子イベントのテキストにのみ入力されます。親イベントは、集計サマリーのみを表示します。

変数

メッセージ変数には、モニター定義のスコープに基づいて、ランダムに選択されたグループが自動挿入されます。例:

{{#is_alert}}
{{host.name}} <-- これが入力されます
{{/is_alert}}

その他の参考資料

お役に立つドキュメント、リンクや記事: