翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
アラート通知
このドキュメントトピックでは、Grafana でのレガシーアラートについて説明します。これは、Amazon Managed Grafana の将来のバージョンではサポートされません。Grafana アラートに移行して、最新のアラート機能を使用できます。詳細については、次のトピックのいずれかを参照してください。
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 10 のアラート。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 9 のアラート。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana アラート。
アラートの状態が変わると、通知が送信されます。各アラートルールには複数の通知を含めることができます。アラートルールに通知を追加するには、まずnotificationチャネルを追加して設定する必要があります。
これは、通知チャネルページから行われます。
通知チャネルの追加
-
サイドバーで、アラート (ベル) アイコンを一時停止し、通知チャネル を選択します。
-
[Add channel] (チャンネルの追加) を選択します。
-
以下のセクションで説明するフィールドに入力するか、オプションを選択します。
新しい通知チャネルフィールド
デフォルト (すべてのアラートで送信）
-
名前 – このチャネルの名前を入力します。ユーザーがアラートルールに通知を追加すると表示されます。
-
タイプ – チャネルタイプを選択します。詳細については、「サポートされている通知子のリスト」を参照してください。
-
デフォルト (すべてのアラートで送信) – 選択すると、このオプションはすべてのアラートルールについて、このチャネルに通知を送信します。
-
メッセージの解決を無効にする – 選択すると、アラート状態が 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 のガイドに従ってボット統合をセットアップする
| 設定 | 説明 |
|---|---|
| Url | 受信ウェブフック URL をスラックするか、最終的に chat.postMessage |
| ユーザーネーム | ボットのメッセージのユーザー名を設定します。 |
| 受取人 | これを使用して 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
注記
Message In Details を使用すると、 PagerDuty イベント内の custom_detailsフィールドの構造が変更されます。これにより、 のフィールドに依存すると、ルールのカスタムイベント PagerDuty ルールが破損する可能性がありますpayload.custom_details。を使用する既存のルールを custom_details.myMetricに移動しますcustom_details.queries.myMetric。
注記
dedup_key タグを使用すると、カスタムキーdedup_keyで生成された Grafana が上書きされます。
アラート通知から Grafana へのリンクを設定する
すべてのアラート通知には、Grafana ワークスペースのトリガーされたアラートへのリンクが含まれています。
