アラート通知

このドキュメントトピックでは、Grafana でのレガシーアラートについて説明します。これは、Amazon Managed Grafana の将来のバージョンではサポートされません。Grafana アラートに移行して、最新のアラート機能を使用できます。詳細については、次のトピックのいずれかを参照してください。

Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 10 のアラート。

Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 9 のアラート。

Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana アラート。

アラートの状態が変わると、通知が送信されます。各アラートルールには複数の通知を含めることができます。アラートルールに通知を追加するには、まずnotificationチャネルを追加して設定する必要があります。

これは、通知チャネルページから行われます。

通知チャネルの追加

1. サイドバーで、アラート (ベル) アイコンを一時停止し、通知チャネル を選択します。

2. [Add channel] (チャンネルの追加) を選択します。

3. 以下のセクションで説明するフィールドに入力するか、オプションを選択します。

新しい通知チャネルフィールド

デフォルト (すべてのアラートで送信）

• 名前 – このチャネルの名前を入力します。ユーザーがアラートルールに通知を追加すると表示されます。

• タイプ – チャネルタイプを選択します。詳細については、「サポートされている通知子のリスト」を参照してください。

• デフォルト (すべてのアラートで送信) – 選択すると、このオプションはすべてのアラートルールについて、このチャネルに通知を送信します。

• メッセージの解決を無効にする – 選択すると、アラート状態が false に戻ったときに送信される解決メッセージ [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 Publish アクセス許可を含める必要があります。

Slack

Slack を設定するには、受信 Slack ウェブフック URL を設定する必要があります。詳細については、「受信 Webhook を使用したメッセージの送信」を参照してください。

Slack メッセージに発声アラートのスクリーンショットを含めるには、Grafana で外部イメージの送信先を設定するか、Slack Apps を介したボット統合を設定する必要があります。Slack ボット統合の設定の詳細については、「Slack のガイドに従ってボット統合をセットアップする」を参照してください。「xoxb」で始まる指定されたトークンを使用します。

設定	説明
Url	受信ウェブフック URL をスラックするか、最終的に chat.postMessage Slack API エンドポイントをスラックします。
ユーザーネーム	ボットのメッセージのユーザー名を設定します。
受取人	これを使用して Slack 受信者を上書きします。チャネル Slack ID、ユーザー Slack ID、ユーザー名リファレンス (@<user>、すべて小文字、空白なし）、またはチャネルリファレンス (#<channel>、すべて小文字、空白なし) のいずれかを指定する必要があります。Slack API chat.postMessage エンドポイントを使用する場合は、これが必要です。
アイコン絵文字	ボットのメッセージのアイコンとして使用する絵文字を指定します。例えば、:smile:
アイコン URL	ボットのメッセージのアイコンとして使用するイメージへの URL を指定します。
ユーザーについて言及する	オプションで、Grafana から送信された Slack 通知で 1 人以上のユーザーについて言及します。対応する Slack IDs を介してカンマ区切りでユーザーを表示するには、各ユーザーの Slack プロファイルのオーバーフローボタンを選択します。
メンショングループ	オプションで、Grafana によって送信される Slack 通知で 1 つ以上のグループについて言及します。対応する Slack IDs (各グループの Slack プロファイル URL から取得できます) を使用して、カンマで区切られたグループを表示できます。
言及チャネル	オプションで、すべてのチャネルメンバーまたはアクティブなチャネルメンバーのみに言及します。
トークン	指定した場合、Amazon Managed Grafana は外部イメージの送信先ではなく、Slack file.upload API オペレーションを介して生成されたイメージをアップロードします。Slack API chat.postMessage エンドポイントを使用する場合は、これが必要です。

Slack ボットにトークンを使用している場合は、通知を送信するチャネルにボットを招待する必要があります。次に、受信者フィールドにチャンネルを追加します。

PagerDuty

を設定するには PagerDuty、統合キーを指定します。

設定	説明
統合キー	の統合キー PagerDuty。
緊急度	動的通知のレベル。デフォルトは critical (1) です。
インシデントの自動解決	アラートが ok に戻った PagerDuty 後、 でインシデントを解決します。
詳細のメッセージ	PD 概要フィールドからアラートメッセージを削除し、代わりにカスタムの詳細 (2) に配置します。

注記

タグ Severity、Class、、Group、 Componentはdedup_key、PagerDuty共通イベント形式 – PD-CEF で特別な意味を持ちます。アラートパネルでこれらのタグキーが定義されている場合、それらは に送信されるイベントのルートに変換されます PagerDuty。つまり、 PagerDuty UI およびフィルタリングツール内で使用できます。アラートに設定された重要度タグは、有効なレベルである場合、通知チャネルに設定されたグローバル重要度を上書きします。

注記

Message In Details を使用すると、 PagerDuty イベント内の custom_detailsフィールドの構造が変更されます。これにより、 のフィールドに依存すると、ルールのカスタムイベント PagerDuty ルールが破損する可能性がありますpayload.custom_details。を使用する既存のルールを custom_details.myMetricに移動しますcustom_details.queries.myMetric。

注記

dedup_key タグを使用すると、カスタムキーdedup_keyで生成された Grafana が上書きされます。

アラート通知から Grafana へのリンクを設定する

すべてのアラート通知には、Grafana ワークスペースのトリガーされたアラートへのリンクが含まれています。