- 重要な情報
- はじめに
- 用語集
- エージェント
- インテグレーション
- OpenTelemetry
- 開発者
- API
- CoScreen
- アプリ内
- インフラストラクチャー
- アプリケーションパフォーマンス
- 継続的インテグレーション
- ログ管理
- セキュリティ
- UX モニタリング
- 管理
通知は、チームに問題を知らせ、トラブルシューティングをサポートするモニターの重要なコンポーネントです。モニターを作成する場合は、何が起こっているかを伝えるセクションとチームに通知するセクションを追加します。
このセクションを使用して、チームに送信する通知を設定します。
モニターに一意のタイトルを追加します(必須)。マルチアラートモニターの場合、トリガースコープを識別するいくつかのタグが自動的に挿入されます。また、タグ変数を使用できます。
メッセージフィールドでは、標準のマークダウンフォーマットと変数を使用できます。@通知を使用して別の連絡先に送信される通知テキストを調整するには、条件付き変数を使用します。
モニターメッセージの一般的な使用例は、問題を解決するための段階的な方法を含めることです。次に例を示します。
Steps to free up disk space:
1. Remove unused packages
2. Clear APT cache
3. Uninstall unnecessary applications
4. Remove duplicate files
モニターにタグを追加します。モニタータグは、メトリクスタグとは異なります。UI でモニターのグループ化と検索に使用されます。タグポリシーが構成されている場合、必要なタグとタグ値を追加する必要があります。詳しくは、タグポリシーを参照してください。
モニターの再通知(オプション)を有効にすると、問題の未解決をチームに知らせることができます。
再通知の間隔、再通知の対象となるモニターの状態 (alert
、no data
、warn
) を構成し、オプションで再通知メッセージの送信数の制限を設定します。
例えば、stop renotifying after 1 occurrence
(1 回発生したら再通知を停止する) ようにモニターを設定すると、メインの警告の後に 1 回のエスカレーションメッセージを受信することができます。
注: 再通知の属性とタグの変数には、再通知の期間中にモニターが利用できるデータが入力されます。
再通知が有効になっている場合、モニターが指定した時間、選択した状態のいずれかに留まっている場合に送信されるエスカレーションメッセージを含めるオプションが提供されます。
エスカレーションメッセージは次の方法で追加できます。
{{#is_renotify}}
ブロック (推奨)。Say what's happening
セクションの Renotification message フィールド。escalation_message
属性。{{#is_renotify}}
ブロックを使用する場合、元の通知メッセージも再通知に含まれます。
{{#is_renotify}}
ブロックには余分な詳細のみを含め、元のメッセージの詳細は繰り返さないでください。サンプルセクションで、これらのユースケースに合わせてモニターを構成する方法を学びましょう。
モニターに関連付けられた優先度 (オプション) を追加します。値の範囲は 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
@通知
は以下に送信できます。
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:
Integration | Prefix | Examples |
---|---|---|
Jira | @jira | Examples |
PagerDuty | @pagerduty | Examples |
Slack | @slack | Examples |
Webhooks | @webhook | Examples |
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 の関連ページへのリンクなどのコンテンツが含まれます。個々のモニターの通知に含める、または除外するコンテンツを選択するオプションがあります。
オプションは、以下の通りです。
注: インテグレーションによっては、デフォルトで表示されないコンテンツがあります。
イベントは、モニターが作成、変更、無音、または削除されるたびに作成されます。Notify
オプションを設定して、これらのイベントをチームメンバー、チャットサービス、モニター作成者に通知します。
すべてのユーザーは、関連するロールに関係なく、すべてのモニターを読むことができます。
デフォルトでは、モニターの書き込み権限を持つユーザーのみがモニターを編集できます。Datadog Admin ロールおよび Datadog Standard ロールには、デフォルトでモニターの書き込み権限があります。オーガニゼーションでカスタムロールを使用している場合、他のカスタムロールにモニターの書き込み権限が付与されていることがあります。
モニターの編集が許可されるロールのリストを指定することで、さらにモニターに制限を設定できます。モニターの作成者は、常にモニターを編集することが可能です。
編集には、モニターのコンフィギュレーションの更新、モニターの削除、モニターのミュート(時間の長短を問わず)などが含まれます。
注: 制限は UI と API の両方に適用されます。
モニターの RBAC 設定や、モニターを固定設定からロール制限の使用へ移行する方法について、詳しくはモニターに RBAC を設定する方法をご参照ください。
テスト通知は、ホスト、メトリクス、異常、外れ値、予測値、ログ、RUM、APM、インテグレーション(チェックのみ)、プロセス(チェックのみ)、ネットワーク(チェックのみ)、カスタムチェック、イベント、複合条件のモニターの種類でサポートされています。
モニターを定義したら、モニターページの右下にある Test Notifications ボタンを使用して通知をテストします。
テスト通知ポップアップから、テストするモニターケースを選択します。テストできるのは、アラート条件で指定されたしきい値について、モニターのコンフィギュレーションで使用可能な状態のみです。ただし、回復しきい値は例外です。これは、モニターがアラート状態でなくなったか、警告状態がなくなったときに、Datadog が回復通知を送信するためです。
Run Test をクリックして、モニターにリストされている人とサービスに通知を送信します。
テスト通知は、イベントエクスプローラー内で検索できるイベントを生成します。テストを開始したユーザーをメッセージ本文で示し、通知のタイトルに [TEST]
が付きます。
タグ変数は、Datadog 子イベントのテキストにのみ入力されます。親イベントは、集計サマリーのみを表示します。
メッセージ変数には、モニター定義のスコープに基づいて、ランダムに選択されたグループが自動挿入されます。例:
{{#is_alert}}
{{host.name}} <-- これが入力されます
{{/is_alert}}
お役に立つドキュメント、リンクや記事: