アラート通知
このドキュメントのトピックでは、Grafana での従来のアラートについて説明します。これは、Amazon Managed Grafana の将来のバージョンではサポートされません。Grafana アラートに移行すると、最新のアラート機能を使用できます。詳細については、次のトピックのいずれかを参照してください。
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「Grafana バージョン 10 のアラート」を参照してください。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「Grafana バージョン 9 のアラート」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「Grafana アラート」を参照してください。
アラートの状態が変化すると、通知が送信されます。各アラートルールには、複数の通知を含めることができます。アラートルールに通知を追加するには、まず notification チャネルを追加および設定する必要があります。
これは通知チャネルページから実行します。
通知チャネルの追加
-
サイドバーで、アラート (ベル) アイコンを一時停止してから、通知チャネルを選択します。
-
[チャンネルの追加] を選択します。
-
フィールドに記入、または以下のセクションで説明されているオプションを選択します。
新しい通知チャネルのフィールド
デフォルト (すべてのアラートで送信)
-
名前 - チャネルの名前を入力します。ユーザーがアラートルールに通知を追加するときに表示されます。
-
タイプ – チャンネルのタイプを選択します。詳細については、「サポートされている通知方法の一覧」を参照してください。
-
デフォルト (すべてのアラートで送信) – このオプションを選択すると、すべてのアラートルールでこのチャネルの通知が送信されます。
-
解決済みメッセージの無効化 – このオプションを選択すると、アラート状態が偽に戻ったときに送信される解決メッセージである [OK] が無効になります。
-
リマインダーの送信 - このオプションを選択すると、アラートで追加の通知 (リマインダー) が送信されます。リマインダーの送信頻度は、秒 (s)、分 (m)、時間 (h) などを使用して、
30s、3m、5m、1hのように指定できます。
重要
アラートリマインダーは、ルールの評価後に送信されます。そのため、設定済みのアラートルール評価間隔よりも頻繁にリマインダーを送信することはできません。
次の例は、トリガーされたアラートに対してリマインダーが送信される、頻度とタイミングを示しています。
| アラートルール評価間隔 | リマインダーの送信間隔 | リマインダーの送信間隔 (前回のアラート通知後) |
|---|---|---|
30s
|
15s
|
30 秒以内 |
1m
|
5m
|
5 分以内 |
5m
|
15m
|
15 分以内 |
6m
|
20m
|
24 分以内 |
1h
|
15m
|
1 時間以内 |
1h
|
2h
|
2 時間以内 |
サポートされている通知方法の一覧
| 名前 | 型 | イメージをサポート | アラートルールタグをサポート |
|---|---|---|---|
| Amazon Simple Notification Service | sns | いいえ | あり |
| OpsGenie |
opsgenie
|
いいえ | あり |
| PagerDuty |
pagerduty
|
なし | あり |
| Slack |
slack
|
なし | いいえ |
| VictorOps |
victorops
|
いいえ | いいえ |
Amazon Simple Notification Service
サービスマネージドアクセス許可を有効にし、ワークスペースの通知チャネルに Amazon SNS を含めると、SNS トピック ARN の提供が通知チャネルの作成時にのみになります。[名前] フィールドに、作成した SNS トピックの名前を入力します。サービスマネージドアクセス許可を使用してワークスペースを作成する場合に、通知をトピックに正常に発行するには、SNS トピック名に grafana のプレフィックスを付ける必要があります。ワークスペースの作成時にカスタマーマネージドアクセス許可を選択する場合は、SNS トピック名に grafana のプレフィックスを付ける必要はありません。
[トピック] フィールドに、SNS トピックの ARN をコピーして貼り付けます。[メッセージ本文の形式] では、JSON またはテキストオプションのいずれかを選択できます。
[オプションの AWS SNS 設定] フィールドで、[メッセージ内のすべてのタグを含める] チェックボックスをオンにすると、メッセージ本文内のすべての Grafana タグが表示されます。
ワークプレイスでカスタマーマネージドアクセス許可を使用する場合は、指定する IAM ロールに SNS トピックの SNS 公開権限を含める必要があります。
Slack
Slack を設定するためには、受信 Slack ウェブフック URL を設定する必要があります。詳細については、「Sending messages using incoming webhooks
Slack ボット統合の設定の詳細については、「Follow Slack’s guide to set up a bot integration
| 設定 | 説明 |
|---|---|
| Url | Slack 受信ウェブフック URL、または Chat.postMessage |
| ユーザーネーム | ボットメッセージのユーザー名を設定します。 |
| 受取人 | これを使用して Slack の受信者を上書きします。チャネル Slack ID、ユーザー Slack ID、ユーザー名リファレンス (@<user>、すべて小文字、空白なし)、またはチャネルリファレンス (#<channel>、すべて小文字、空白なし) のいずれかを指定する必要があります。chat.postMessage Slack API エンドポイントを使用する場合はこれが必要です。 |
| アイコンの絵文字 | ボットメッセージのアイコンとして使用する絵文字を指定します。例えば、:smile: |
| アイコンの URL | ボットメッセージのアイコンとして使用する画像の URL を指定します。 |
| ユーザーの言及 | 必要に応じて、Grafana が送信する Slack 通知で 1 人以上のユーザーについて言及します。カンマで区切られたユーザーを表示するには、対応する Slack ID を使用して、各ユーザーの Slack プロファイルのオーバーフローボタンを選択します。 |
| グループの言及 | 必要に応じて、Grafana が送信する Slack 通知で 1 人以上のグループについて言及します。対応する Slack ID (各グループの Slack プロファイル URL から取得できます) を使用して、カンマで区切られたグループを表示できます。 |
| チャネルの言及 | 必要に応じて、すべてのチャネルメンバー、またはアクティブなチャネルメンバーのみのいずれかに言及します。 |
| トークン | 指定すると、Amazon Managed Grafana は、外部イメージの送信先ではなく、Slack file.upload API オペレーションを介して生成されたイメージをアップロードします。chat.postMessage Slack API エンドポイントを使用する場合はこれが必要です。 |
Slack ボットにトークンを使用する場合は、通知を送信するチャネルにボットを招待する必要があります。受信者フィールドにチャネルを追加します。
PagerDuty
PagerDuty を設定するため、統合キーを指定します。
| 設定 | 説明 |
|---|---|
| 統合キー | PagerDuty の統合キー。 |
| 緊急度 | 動的通知のレベルで、デフォルトは critical (1) です。 |
| インシデントの自動解決 | アラートが OK に戻った後に PagerDuty でインシデントを解決します。 |
| メッセージの詳細 | PD のサマリーフィールドからアラートメッセージを削除し、代わりにカスタム詳細に配置します (2)。 |
注記
タグ Severity、Class、Group、dedup_key、Component は [PagerDuty 共通イベント形式 – PD-CEF]
注記
メッセージの詳細を使用すると、PagerDuty イベントの custom_details フィールドの構造が変更されます。payload.custom_details のフィールドに依存すると、PagerDuty ルールのカスタムイベントルールが壊れる可能性があります。custom_details.myMetric を使用する既存のルールを custom_details.queries.myMetric に移動します。
注記
dedup_key タグを使用すると、カスタムキーにより Grafana が生成した dedup_key が上書きされます。
アラート通知から Grafana に戻るリンクの設定
すべてのアラート通知には、Grafana ワークスペースでトリガーされたアラートに戻るリンクが含まれています。
