通知

概要

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

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 で使用されます。

再通知

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

再通知の有効化

再通知の間隔、再通知の対象となるモニターの状態 (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 などを使用してチームに通知を送信するには、このセクションを使用してください。ドロップダウンボックスから、チームメンバーおよび接続済みのインテグレーションを検索できます。このセクションに @通知 が追加されている場合、通知は自動的にメッセージフィールドに追加されます。

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

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

通知

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

Email

  • @<DD_USER_EMAIL_ADDRESS> を使用して、Datadog のアクティブユーザーにメールで通知します。: 保留中の Datadog ユーザー招待または無効化されているユーザーに関連付けられているメールアドレスは非アクティブと見なされ、通知を受信しません。
  • @<メール>を使用して、Datadog 以外のユーザーにメールで通知します。

インテグレーション

@<インテグレーション名>-<値> という形式を使用して、接続されたインテグレーションを通じてチームに通知します。以下は、プレフィックスのリストと例のリンクです。

インテグレーションプレフィックス
Jira@jira
PagerDuty@pagerduty
Slack@slack
Webhooks@webhook

チームへの通知に使用できるインテグレーションのリストをご覧ください。

: 括弧 ((, )) を含むハンドルはサポートされていません。括弧を含むハンドルが使用される場合、ハンドルはパースされずアラートも作成されません。

変更

イベントは、モニターが作成、変更、無音、または削除されるたびに作成されます。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}}

その他の参考資料

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