翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# アラートの管理
****
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。
アラートルール、コンタクトポイント、通知ポリシーを設定したら、Grafana アラートを使用してアラートを実際に管理できます。
**Topics**
+ [通知のカスタマイズ](v10-alerting-manage-notifications.md)
+ [コンタクトポイントの管理](v10-alerting-manage-contactpoints.md)
+ [アラート通知のサイレンシング](v10-alerting-silences.md)
+ [アラートルールの表示とフィルタリング](v10-alerting-manage-rules-viewfilter.md)
+ [ミュートタイミング](v10-alerting-manage-muting.md)
+ [アラートルールの状態と正常性を表示する](v10-alerting-manage-rulestate.md)
+ [アラートグループ別に表示およびフィルタリングする](v10-alerting-manage-viewfiltergroups.md)
+ [通知エラーの表示](v10-alerting-manage-viewnotificationerrors.md)
# 通知のカスタマイズ
****
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。
通知テンプレートを使用して、通知をカスタマイズします。
通知テンプレートを使用して、通知内のメッセージのタイトル、メッセージ、形式を変更できます。
通知テンプレートは、Amazon SNS や Slack などの特定のコンタクトポイント統合には関連付けられていません。ただし、異なるコンタクトポイント統合用に個別の通知テンプレートを作成することもできます。
通知テンプレートを使用すると、次のことができます。
+ 概要、説明、ラベルと注釈、値、リンクなど、通知内の情報を追加、削除、または並べ替える
+ テキストを太字と斜体で書式設定し、改行を追加または削除する
通知テンプレートを次の目的には使用できません。
+ Slack や Microsoft Teams などのインスタントメッセージングサービスで通知のデザインを変更する
**Topics**
+ [Go のテンプレート言語の使用](v10-alerting-notifications-go-templating.md)
+ [通知テンプレートの作成](v10-alerting-create-templates.md)
+ [通知テンプレートの使用](#v10-alerting-use-notification-templates)
+ [テンプレートリファレンス](v10-alerting-template-reference.md)
# Go のテンプレート言語の使用
****
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。
Go のテンプレート言語である [text/template](https://pkg.go.dev/text/template) で通知テンプレートを書き込みます。
このセクションでは、Go のテンプレート言語の概要と、text/template でのテンプレートの作成について説明します。
## dot
text/template には dot と呼ばれる特別なカーソルがあり、`.` として記述されます。このカーソルは、テンプレート内の使用場所に応じて値が変化する変数と考えることができます。例えば、通知テンプレートの開始時に `.` は、`Alerts`、`Status`、`GroupLabels`、`CommonLabels`、`CommonAnnotations` および `ExternalURL` を含む多数のフィールドを含む `ExtendedData` オブジェクトを参照します。ただし、dot は、リスト上の `range` で使用される場合、`with` 内で使用される場合、または他のテンプレートで使用する機能テンプレートを記述する場合、他の何かを参照する場合があります。これの例は [通知テンプレートの作成](v10-alerting-create-templates.md) で、すべてのデータと関数は [テンプレートリファレンス](v10-alerting-template-reference.md) で確認できます。
## 開始と終了のタグ
テキスト/テンプレートでは、テンプレートが変数を印刷するか、if ステートメントなどのコントロール構造を実行するかに関係なく、テンプレートは `{{`で始まり、`}}` で終わります。これは、変数の出力に `{{` と `}}` を使用し、制御構造に `{%` と `%}` を使用する Jinja などの他のテンプレート言語とは異なります。
## 印刷
何かの値を印刷するには、`{{` と `}}` を使用します。dot の値、dot のフィールド、関数の結果、[[変数]](#v10-go-variables)の値を印刷できます。例えば、dot が `ExtendedData` を参照する `Alerts` フィールドを印刷するには、次のように記述します。
```
{{ .Alerts }}
```
## アラートを反復処理する
アラートに関するすべての情報ではなく、各アラートのラベルのみを印刷するには、`range` を使用して `ExtendedData` でアラートを反復処理できます。
```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
```
範囲内の dot は、`ExtendedData` ではなく `Alert` を参照します。`{{ .Labels }}` を使用して、各アラートのラベルを印刷できます。これは、アラートのリスト内の現在のアラートを参照するように `{{ range .Alerts }}` が dot を変えるために機能します。範囲が終了すると、dot は範囲の開始前に存在していた値にリセットされます。この例では `ExtendedData` です。
```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
{{/* does not work, .Labels does not exist here */}}
{{ .Labels }}
{{/* works, cursor was reset */}}
{{ .Status }}
```
## 注釈とラベルを反復処理する
各アラートのラベルを `The name of the label is $name, and the value is $value` の形式で印刷するテンプレートを書きましょう。ここで、`$name` と `$value` には各ラベルの名前と値が含まれます。
前の例と同様に、`.Alerts` の範囲を使用して のアラートを繰り返し、dot がアラートのリスト内の現在のアラートを参照するようにし、ソートされたラベルで 2 番目の範囲を使用して、dot が現在のラベルを参照するように 2 回目に更新されます。2 番目の範囲内では、 `.Name` と `.Value` を使用して各ラベルの名前と値を出力します。
```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
The name of the label is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ range .Annotations.SortedPairs }}
The name of the annotation is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ end }}
```
## インデックス関数
特定の注釈またはラベルを出力するには、 `index` 関数を使用します。
```
{{ range .Alerts }}
The name of the alert is {{ index .Labels "alertname" }}
{{ end }}
```
## If ステートメント
テンプレートでは if ステートメントを使用できます。例えば、`.Alerts` にアラートがない場合に `There are no alerts` を出力するには、次のように記述します。
```
{{ if .Alerts }}
There are alerts
{{ else }}
There are no alerts
{{ end }}
```
## With
With は if ステートメントと似ていますが、if ステートメントとは異なり、`with` は dot を更新して with の値を参照します。
```
{{ with .Alerts }}
There are {{ len . }} alert(s)
{{ else }}
There are no alerts
{{ end }}
```
## [変数]
text/template の変数は、テンプレート内に作成する必要があります。例えば、`$variable` という変数を現在の dot の値で作成するには、次のように記述します。
```
{{ $variable := . }}
```
範囲内の `$variable` または `with` を使用でき、これらは変数が定義された時点の dot の値を参照します。dot の現在の値は参照されません。
例えば、2 番目の範囲で `{{ .Labels }}` を使用するテンプレートを記述することはできません。ここでは、現在のアラートではなく、現在のラベルが dot で参照されるためです。
```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* does not work because in the second range . is a label not an alert */}}
There are {{ len .Labels }}
{{ end }}
{{ end }}
```
これを修正するには、最初の範囲と 2 番目の範囲の前に `$alert` という変数を定義します。
```
{{ range .Alerts }}
{{ $alert := . }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* works because $alert refers to the value of dot inside the first range */}}
There are {{ len $alert.Labels }}
{{ end }}
{{ end }}
```
## インデックスを含む範囲
範囲の開始時にインデックス変数と値変数を定義することで、範囲内の各アラートのインデックスを取得できます。
```
{{ $num_alerts := len .Alerts }}
{{ range $index, $alert := .Alerts }}
This is alert {{ $index }} out of {{ $num_alerts }}
{{ end }}
```
## テンプレートの定義
`define` とテンプレートの名前を二重引用符で囲むことで、他のテンプレート内で使用できるテンプレートを定義できます。`__subject`、`__text_values_list`、`__text_alert_list`、`default.title`、`default.message` などのデフォルトテンプレートを含め、他のテンプレートと同じ名前のテンプレートを設定しないでください。デフォルトテンプレートと同じ名前のテンプレート、または別の通知テンプレート内のテンプレートと同じ名前で作成されている場合、Grafana はいずれかのテンプレートを使用することになり、混乱が生じます。Grafana は、同じ名前のテンプレートが 2 つ以上ある場合、エラーメッセージを返しません。
```
{{ define "print_labels" }}
{{ end }}
```
## テンプレートの実行
`template`、二重引用符で囲まれたテンプレートの名前、およびテンプレートに渡されるカーソルを使用して、テンプレート内で定義されたテンプレートを実行できます。
```
{{ template "print_labels" . }}
```
## テンプレートにデータを渡す
テンプレート内では、dot はテンプレートに渡される値を参照します。
例えば、テンプレートに発射アラートのリストが渡された場合、dot は発射アラートのリストを参照します。
```
{{ template "print_alerts" .Alerts }}
```
テンプレートにアラートのソート済みラベルが渡された場合、dot はソート済みラベルのリストを参照します。
```
{{ template "print_labels" .SortedLabels }}
```
これは、再利用可能なテンプレートを記述する場合に役立ちます。例えば、すべてのアラートを出力するには、次のように記述します。
```
{{ template "print_alerts" .Alerts }}
```
次に、発射アラートのみを出力するには、次のように記述します。
```
{{ template "print_alerts" .Alerts.Firing }}
```
これは、`.Alerts` と `.Alerts.Firing` の両方がアラートのリストであるために機能します。
```
{{ define "print_alerts" }}
{{ range . }}
{{ template "print_labels" .SortedLabels }}
{{ end }}
{{ end }}
```
## コメント
`{{/*` および `*/}}` を使用してコメントを追加できます。
```
{{/* This is a comment */}}
```
コメントが改行を追加しないようにするには、以下を使用します。
```
{{- /* This is a comment with no leading or trailing line breaks */ -}}
```
## インデント
タブとスペースの両方のインデントと改行を使用して、テンプレートをより読みやすくすることができます。
```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{ end }}
{{ end }}
```
ただし、テンプレートのインデントはテキストにも適用されます。次に、削除する方法を説明します。
## スペースと改行を削除する
text/template では、 `{{-` と `-}}` を使用して、先頭と末尾のスペースと改行を削除します。
例えば、インデントと改行を使用してテンプレートをより読みやすくする場合です。
```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{ end }}
{{ end }}
```
インデントと改行はテキストにも表示されます。
```
alertname = "Test"
grafana_folder = "Test alerts"
```
各範囲の先頭の `}}` を `-}}` に変更することで、テキストからインデントと改行を削除できます。
```
{{ range .Alerts -}}
{{ range .Labels.SortedPairs -}}
{{ .Name }} = {{ .Value }}
{{ end }}
{{ end }}
```
これにより、テンプレートのインデントと改行がテキストから取り除かれます。
```
alertname = "Test"
grafana_folder = "Test alerts"
```
# 通知テンプレートの作成
****
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。
コンタクトポイントに送信するため、再利用可能な通知テンプレートを作成できます。
通知テンプレートには 1 つ以上のテンプレートを追加できます。
通知テンプレート名は、一意である必要があります。同じ通知テンプレートまたは異なる通知テンプレートに、同じ名前のテンプレートを 2 つ使用することはできません。`__subject`、`__text_values_list`、`__text_alert_list`、`default.title`、`default.message` などのデフォルトテンプレートと同じ名前のテンプレートを定義しないでください。
[コンタクトポイント] タブには、通知テンプレートのリストが表示されます。
## 通知テンプレートの作成
**通知テンプレートを作成するには**
1. **[アラート]**、**[コンタクトポイント]** を続けて選択します。
1. **[通知テンプレート]** タブを選択し、**[\$1 通知テンプレートの追加]** を選択します。
1. `email.subject` などの通知テンプレートの名前を選択します。
1. テンプレートの内容をコンテンツフィールドに書き込みます。
例:
```
{{ if .Alerts.Firing -}}
{{ len .Alerts.Firing }} firing alerts
{{ end }}
{{ if .Alerts.Resolved -}}
{{ len .Alerts.Resolved }} resolved alerts
{{ end }}
```
1. 変更内容を保存します。
`{{ define "email.subject" }}` (`email.subject` はテンプレートの名前) と `{{ end }}` はコンテンツの先頭と末尾に自動的に追加されます。
**複数のテンプレートを含む通知テンプレートを作成するには**
1. **[アラート]**、**[コンタクトポイント]** を続けて選択します。
1. **[通知テンプレート]** タブを選択し、**[\$1 通知テンプレートの追加]** を選択します。
1. 通知テンプレート全体の名前を入力します。例えば、`email`。
1. 各テンプレートの最初と最後に `{{ define "name-of-template" }}` と `{{ end }}` を含む各テンプレートをコンテンツフィールドに書き込みます。`email.subject` や `email.message` など、通知テンプレート内の各テンプレートにわかりやすい名前を使用できます。この場合、上記で入力した通知テンプレートの名前は再度使用しないでください。
後のセクションでは、作成するテンプレートの詳細な例を示します。
1. 保存をクリックします。
## 通知テンプレートをプレビューする
コンタクトポイントで使用する前に通知テンプレートの外観をプレビューすると、作成するテンプレートの結果を理解しやすくなり、テンプレートを保存する前にエラーを修正することができます。
**注記**
通知プレビューは Grafana アラートマネージャーでのみ使用できます。
**通知テンプレートをプレビューするには**
1. **[アラート]**、**[コンタクトポイント]** を続けて選択します。
1. **[通知テンプレート]** タブを選択し、**[\$1 通知テンプレートの追加]** を選択するか、既存のテンプレートを編集します。
1. テンプレートコンテンツを追加または更新します。
デフォルトのデータが提供され、アラートデータとアラートインスタンスを追加または編集できます。アラートデータは、ペイロードデータウィンドウ自体に直接追加するか、**[アラートインスタンスの選択]** または**[カスタムアラートの追加]** をクリックします。
1. [オプション] 既存のアラートインスタンスからアラートデータを追加するには:
1. **[アラートインスタンスの選択]** を選択します。
1. アラートインスタンスにカーソルを合わせると、各アラートインスタンスに関する詳細情報が表示されます。
1. **[Confirm]** (確認) を選択して、アラートインスタンスをペイロードに追加します。
1. [オプション] アラートデータエディタを使用してアラートデータを追加するには、**[カスタムデータの追加]** を選択します。
1. 注釈/カスタムラベルを追加するか、ダッシュボードまたはパネルを設定します。
1. 通知に発射アラートを追加するか、解決済みアラートを追加するかに応じて、発射または解決を切り替えます。
1. **[アラートデータの追加]** を選択します。
1. **[プレビューの更新]** を選択して、テンプレートの内容と対応するペイロードデータを確認します。
テンプレートにエラーがある場合はプレビューに表示され、保存する前に修正できます。
1. 変更内容を保存します。
## メッセージの件名のテンプレートの作成
この例では、発射アラートと解決済みアラートの数を含む E メールの件名のテンプレートを作成します。
```
1 firing alerts, 0 resolved alerts
```
**E メールの件名のテンプレートを作成するには**
1. `email.subject` というテンプレートを次の内容で作成します。
```
{{ define "email.subject" }}
{{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
{{ end }}
```
1. テンプレートは、キーワード `template` を使用して**件名**フィールドに配置して、コンタクトポイント統合を作成するときに使用します。
```
{{ template "email.subject" . }}
```
## E メールのメッセージ用のテンプレート作成
この例では、すべての発射アラートと解決済みアラートの概要を含む E メールのメッセージ用のテンプレートを作成します。
```
There are 2 firing alerts, and 1 resolved alerts
Firing alerts:
- alertname=Test 1 grafana_folder=GrafanaCloud has value(s) B=1
- alertname=Test 2 grafana_folder=GrafanaCloud has value(s) B=2
Resolved alerts:
- alertname=Test 3 grafana_folder=GrafanaCloud has value(s) B=0
```
**E メールのメッセージ用のテンプレートを作成するには**
1. `email` という名前の通知テンプレートを、コンテンツに `email.message_alert` と `email.message` という 2 つのテンプレートで作成します。
`email.message_alert` テンプレートは、`email.message` テンプレートに E メールの構造が含まれている間、各発射アラートと解決済みアラートのラベルと値を印刷するために使用されます。
```
{{- define "email.message_alert" -}}
{{- range .Labels.SortedPairs }}{{ .Name }}={{ .Value }} {{ end }} has value(s)
{{- range $k, $v := .Values }} {{ $k }}={{ $v }}{{ end }}
{{- end -}}
{{ define "email.message" }}
There are {{ len .Alerts.Firing }} firing alerts, and {{ len .Alerts.Resolved }} resolved alerts
{{ if .Alerts.Firing -}}
Firing alerts:
{{- range .Alerts.Firing }}
- {{ template "email.message_alert" . }}
{{- end }}
{{- end }}
{{ if .Alerts.Resolved -}}
Resolved alerts:
{{- range .Alerts.Resolved }}
- {{ template "email.message_alert" . }}
{{- end }}
{{- end }}
{{ end }}
```
1. テンプレートは、キーワード `template` を使用して**テキスト本文**フィールドに配置して、コンタクトポイント統合を作成するときに使用します。
```
{{ template "email.message" . }}
```
## Slack メッセージのタイトルのテンプレート作成
この例では、発射アラートと解決済みアラートの数を含む Slack メッセージのタイトルのテンプレートを作成します。
```
1 firing alerts, 0 resolved alerts
```
**Slack メッセージのタイトルのテンプレートを作成するには**
1. `slack.title` というテンプレートを次の内容で作成します。
```
{{ define "slack.title" }}
{{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
{{ end }}
```
1. コンタクトポイント統合のタイトルフィールドからテンプレートを実行します。
```
{{ template "slack.title" . }}
```
## Slack メッセージのコンテンツのテンプレート作成
すべての発射アラートと解決済みアラートの説明 (ラベル、注釈、ダッシュボード URL など) を含む Slack メッセージのコンテンツのテンプレートを作成します。
**注記**
このテンプレートは Grafana マネージドアラート専用です。データソースマネージドアラートに テンプレートを使用するには、DashboardURL と SilenceURL への参照を削除します。Prometheus 通知の設定に関する詳細については、「[通知に関する Prometheus ドキュメント](https://prometheus.io/docs/alerting/latest/notifications/)」を参照してください。
```
1 firing alerts:
[firing] Test1
Labels:
- alertname: Test1
- grafana_folder: GrafanaCloud
Annotations:
- description: This is a test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1
1 resolved alerts:
[firing] Test2
Labels:
- alertname: Test2
- grafana_folder: GrafanaCloud
Annotations:
- description: This is another test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1
```
**Slack メッセージのコンテンツのテンプレートを作成するには**
1. コンテンツに `slack.print_alert` と`slack.message` の 2 つのテンプレートを使用して、`slack` という名前のテンプレートを作成します。
`slack.print_alert` テンプレートはラベル、注釈、および DashboardURL の印刷に使用され、`slack.message` テンプレートには通知の構造が含まれます。
```
{{ define "slack.print_alert" -}}
[{{.Status}}] {{ .Labels.alertname }}
Labels:
{{ range .Labels.SortedPairs -}}
- {{ .Name }}: {{ .Value }}
{{ end -}}
{{ if .Annotations -}}
Annotations:
{{ range .Annotations.SortedPairs -}}
- {{ .Name }}: {{ .Value }}
{{ end -}}
{{ end -}}
{{ if .DashboardURL -}}
Go to dashboard: {{ .DashboardURL }}
{{- end }}
{{- end }}
{{ define "slack.message" -}}
{{ if .Alerts.Firing -}}
{{ len .Alerts.Firing }} firing alerts:
{{ range .Alerts.Firing }}
{{ template "slack.print_alert" . }}
{{ end -}}
{{ end }}
{{ if .Alerts.Resolved -}}
{{ len .Alerts.Resolved }} resolved alerts:
{{ range .Alerts.Resolved }}
{{ template "slack.print_alert" .}}
{{ end -}}
{{ end }}
{{- end }}
```
1. コンタクトポイント統合のテキスト本文フィールドからテンプレートを実行します。
```
{{ template "slack.message" . }}
```
## 共有テンプレートを使用して E メールと Slack の両方にテンプレートを作成する
E メールや Slack など、コンタクトポイントごとに個別の通知テンプレートを作成する代わりに、同じテンプレートを共有できます。
例えば、この件名の E メールを送信し、このタイトル `1 firing alerts, 0 resolved alerts` の Slack メッセージを送信する場合は、共有テンプレートを作成できます。
**共有テンプレートを作成するには**
1. `common.subject_title` というテンプレートを次の内容で作成します。
```
{{ define "common.subject_title" }}
{{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
{{ end }}
```
1. E メールの場合は、E メールコンタクトポイント統合の件名フィールドからテンプレートを実行します。
```
{{ template "common.subject_title" . }}
```
1. Slack の場合は、Slack コンタクトポイント統合のタイトルフィールドからテンプレートを実行します。
```
{{ template "common.subject_title" . }}
```
## 通知テンプレートの使用
コンタクトポイントのテンプレートを使用して通知をカスタマイズします。
**コンタクトポイントの作成時にテンプレートを使用するには**
1. **[アラート]** メニューから、**[コンタクトポイント]** タブを選択して、既存のコンタクトポイントのリストを表示します。
1. **[New]** (新規作成) を選択します。または、**[編集]** アイコンを選択して、既存のコンタクトポイントを編集することもできます。
1. **[Message]** (メッセージ) や **[Subject]** (件名) などのフィールドに、使用するテンプレートを入力します。テンプレートを入力するには、`{{ template "template_name" . }}` フォームを使用し、 *template\$1name* を使用するテンプレートの名前に置き換えます。
1. **[コンタクトポイントの保存]** を選択します。
# テンプレートリファレンス
****
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。
このセクションでは、テンプレートを作成するためのリファレンス情報を提供します。
**アラート (型)**
アラート型には、次のデータがあります。
| 名前 | [Kind] (種類) | 説明 | 例 |
| --- | --- | --- | --- |
| ステータス | string | `firing` または `resolved` | \$1\$1 .Status \$1\$1 |
| ラベル | KeyValue | アラートに付与された一連のラベル。 | \$1\$1 .Labels \$1\$1 |
| 注釈 | KeyValue | アラートに付与された一連の注釈。 | \$1\$1 .Annotations \$1\$1 |
| 値 | KeyValue | クラシック条件を含むすべての式の値 | \$1\$1 .Values \$1\$1 |
| StartsAt | time.Time | アラートが発行された時刻。 | \$1\$1 .StartsAt \$1\$1 |
| EndsAt | time.Time | アラートの終了時刻がわかっている場合にのみ設定されます。それ以外の場合、最後にアラートを受信してから設定可能なタイムアウト期間が適用されます。 | \$1\$1 .EndsAt \$1\$1 |
| GeneratorURL | string | Grafana または外部アラートマネージャーへのリンク。 | \$1\$1 .GeneratorURL \$1\$1 |
| SilenceURL | string | アラートをサイレンスするリンク (このアラートのラベルがあらかじめ入力されています)。Grafana 管理のアラートのみ。 | \$1\$1 .SilenceURL\$1\$1 |
| DashboardURL | string | Grafana ダッシュボードへのリンク (アラートルールが Grafana に属している場合)。Grafana 管理のアラートのみ。 | \$1\$1 .DashboardURL \$1\$1 |
| PanelURL | string | Grafana ダッシュボードパネルへのリンク (アラートルールが Grafana に属している場合)。Grafana 管理のアラートのみ。 | \$1\$1 .PanelURL \$1\$1 |
| Fingerprint | string | アラートの識別に使用するフィンガープリント。 | \$1\$1 .Fingerprint \$1\$1 |
| ValueString | string | アラート内の各削減された式のラベルと値を含む文字列。 | \$1\$1 .ValueString \$1\$1 |
**ExtendedData**
ExtendedData オブジェクトには、以下のプロパティが含まれています。
| 名前 | [Kind] (種類) | 説明 | 例 |
| --- | --- | --- | --- |
| レシーバー | `string` | 通知を送信するコンタクトポイントの名前。 | `{{ .Receiver }}` |
| ステータス | `string` | ステータスは、少なくとも 1 つのアラートが発せられている場合は `firing` で、それ以外の場合は `resolved` です。 | `{{ .Status }}` |
| アラート | `[]Alert` | この通知のすべての発生アラートと解決済みアラートのリスト。 | `There are {{ len .Alerts }} alerts` |
| 発生アラート | `[]Alert` | この通知のすべての発生アラートのリスト。 | `There are {{ len .Alerts.Firing }} firing alerts` |
| 解決済みアラート | `[]Alert` | この通知で解決されたすべてのアラートのリスト。 | `There are {{ len .Alerts.Resolved }} resolved alerts` |
| GroupLabels | `KeyValue` | これらのアラートをこの通知にグループ化するラベル。 | `{{ .GroupLabels }}` |
| CommonLabels | `KeyValue` | この通知のすべてのアラートに共通するラベル。 | `{{ .CommonLabels }}` |
| CommonAnnotations | `KeyValue` | この通知のすべてのアラートに共通する注釈。 | `{{ .CommonAnnotations }}` |
| ExternalURL | `string` | この通知を送信した Grafana ワークスペースまたはアラートマネージャーへのリンク。 | `{{ .ExternalURL }}` |
**KeyValue 型**
`KeyValue` 型は、キー (ラベル) 値 (注釈) の文字列を組み合わせたものです。
`KeyValue` として保存されたデータに直接アクセスするメソッドだけでなく、データをソート、削除、変換するメソッドも備えています。
| 名前 | 引数 | 戻り値 | 注意事項 | 例 |
| --- | --- | --- | --- | --- |
| SortedPairs | | キーと値の文字列のソート済みのリスト | | `{{ .Annotations.SortedPairs }}` |
| 削除 | []string | KeyValue | 指定したキーを除いたキー/値のマップのコピーを返します。 | `{{ .Annotations.Remove "summary" }}` |
| 名前 | | []string | 名前のリスト | `{{ .Names }}` |
| [Values] (値) | | []string | 値のリスト | `{{ .Values }}` |
**[時間]**
時間は Go [https://pkg.go.dev/time#Time](https://pkg.go.dev/time#Time) パッケージからのものです。時間はさまざまな形式で印刷できます。例えば、アラートが発生した時刻を `Monday, 1st January 2022 at 10:00AM` 形式で出力するには、次のテンプレートを作成します。
```
{{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }}
```
Go の時間形式に関するリファレンスは、[こちら](https://pkg.go.dev/time#pkg-constants)を参照してください。
# コンタクトポイントの管理
****
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。
**[コンタクトポイント]** リストビューには、既存のすべてのコンタクトポイントと通知テンプレートが一覧表示されます。
**[コンタクトポイント]** タブでは、次のことができます。
+ コンタクトポイントと統合の名前とタイプを検索する。
+ 既存のすべての連絡先と統合を表示する。
+ 各コンタクトポイントが使用されている通知ポリシーの数を表示し、リンクされた通知ポリシーに直接移動する。
+ 通知配信のステータスを表示する。
+ 個々のコンタクトポイントまたはすべてのコンタクトポイントを JSON、YAML、または Terraform 形式でエクスポートする。
+ 通知ポリシーで使用されていないコンタクトポイントを削除する。
**[通知テンプレート]** タブでは、次のことができます。
+ 既存の通知テンプレートを表示、編集、コピー、または削除する。
# アラート通知のサイレンシング
****
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。
*サイレンス*を使用してアラート通知を抑制できます。サイレンスは通知の作成を停止するだけで、アラートルールの評価やユーザーインターフェースへのアラートインスタンスの表示は引き続き行われます。アラートをサイレンスにする場合、停止する時間枠を指定します。
**注記**
アラート通知を一定の時間間隔、定期的なメンテナンス期間中など、で停止するには、サイレンスではなく [ミュートタイミング](v10-alerting-manage-muting.md) を使用します。
**サイレンスの追加方法**
1. Grafana コンソールの Grafana メニューで、**[アラート]** を選択します。
1. **[サイレンス]** を選択します。
1. アラートマネージャードロップダウンから **[アラートマネージャー]** を選択します。
1. **[サイレンスの作成]** を選択します。
1. **[サイレンスの開始と終了]** でサイレンスを有効にする開始日と終了日を選択します。
1. 終了時刻を設定する代わりに、**[期間]** でサイレンスが適用される期間を指定します。この方法を使用すると、**[サイレンスの開始と終了]** フィールドの終了時刻が自動的に更新されます。
1. **[ラベル]** と **[値]** フィールドに、1 つ以上の*一致するラベル*を入力します。照合機能により、どのルールにサイレンスを適用するかが決定されます。一致するアラート (発動状態) はすべて、**[Affected alerts instances(影響を受けるアラートインスタンス)]** フィールドに表示されます。
1. 必要に応じて、サイレンスに関する**コメント**を追加します。
1. **[送信]** を選択します。
**サイレンスを編集するには**
1. Grafana コンソールの Grafana メニューで、**[アラート]** を選択します。
1. 既存のサイレンスのリストを表示するには、**[サイレンス]** を選択します。
1. 編集するサイレンスを見つけ、**[編集]** (ペンアイコン) を選択します。
1. 変更後、**[送信]** を選択して変更を保存します。
既存のサイレンスを編集するには、**[編集]** アイコン (ペン) を選択します。
**サイレンスフォームへの URL リンクを作成するには**
サイレンスフォームにリンクするときは、`matcher` および `comment` クエリパラメータを使用して、デフォルトの一致するラベルとコメントを指定します。`matcher` パラメータは、次の `[label][operator][value]` の形式である必要があります。この時、`operator` パラメータには以下のいずれかを指定できます: `=` (正規表現ではなく等号)、`!=` (正規表現ではなく不等号)、`=~` (等号、正規表現)、`!~` (不等号、正規表現)。URL には、 キー `matcher` を含む多くのクエリパラメータを含めることができます。例えば、一致するラベル `severity=critical` と `cluster!~europe-.*` ならびにコメント `Silence critical EU alerts` を使用してサイレンスフォームにリンクするには、URL `https://mygrafana/alerting/silence/new?matcher=severity%3Dcritical&matcher=cluster!~europe-*&comment=Silence%20critical%20EU%20alert` を作成します。
外部アラートマネージャーの新しいサイレンスページにリンクするには、`alertmanager` クエリパラメータを追加します。
**サイレンスを削除するには**
1. Grafana コンソールの Grafana メニューで、**[アラート]** を選択します。
1. 既存のサイレンスのリストを表示するには、**[サイレンス]** を選択します。
1. 終了するサイレンスを選択し、**[サイレンス解除]** を選択します。この操作によりアラートの停止状態は終了します。
**注記**
サイレンス解除を行うと、終了時刻が現在の時刻に設定されたものとして、アラートの停止状態が終了します。（自動または手動を問わず）終了したサイレンスは5 日間保持され、一覧表示されます。リストからサイレンスを手動で削除することはできません。
# アラートルールの表示とフィルタリング
****
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。
**[アラート]** ページには、アラートルールが一覧表示されます。デフォルトでは、ルールはデータソースの種類ごとにグループ化されます。**Grafana** セクションには、Grafana によって管理されるルールが一覧表示されます。Prometheus 互換データソースのアラートルールもここに表示されます。Prometheus 互換データソースのアラートルールは表示できますが、編集することはできません。
Mimir/Cortex/Loki ルールセクションには、Mimir、Cortex、または Loki データソースのすべてのルールが一覧表示されます。クラウドアラートルールもこのセクションに表示されます。
大量のアラートを管理する場合、拡張アラートルール検索機能を使用して、フォルダ、評価グループ、ルールをフィルタリングできます。さらに、ラベル、状態、タイプ、正常性などのプロパティでアラートルールをフィルタリングできます。
## アラートルールの表示
Grafana アラートを使用すると、すべてのアラートを 1 ページに表示できます。
**アラートの詳細を表示するには**
1. Grafana コンソールの Grafana メニューで、**[アラート]**、**[アラートルール]** を選択します。デフォルトでは、リストビューが表示されます。
1. **[表示形式]** では、任意のオプションを選択して、グループ化されたビュー、リストビュー、および状態ビューを切り替えることができます。
1. ルール行を展開して、ルールラベル、注釈、データソース、ルールクエリ、およびルールの結果のアラートインスタンスのリストを表示します。
このページから、アラートルールのコピーを作成して、既存のルールを再利用することもできます。
## アラートルールのエクスポート
ルールは Grafana ワークスペースで YAML または JSON にエクスポートできます。
+ YAML、JSON、または Terraform にエクスポートする各アラートルールグループの横にある **[ルールグループのエクスポート]** アイコンを選択します。
+ **[ルールのエクスポート]** を選択して、すべての Grafana マネージドアラートルールを YAML、JSON、または Terraform にエクスポートします。
+ グループ内の個々のアラートルールの横にある **[その他]**、**[エクスポートを変更** を選択して、プロビジョニングされたアラートルールを編集し、変更されたバージョンをエクスポートします。
## プロビジョニングされたアラートのクエリ定義を表示する
プロビジョニングされたアラートの読み取り専用クエリ定義を表示します。ルール定義の「as-code」リポジトリにアクセスすることなく、アラートルールのクエリが正しいかどうかをすばやく確認できます。
**グループ化されたビュー**
グループ化されたビューには、フォルダ別にグループ化された Grafana アラートルールと、`namespace` と `group` によりグループ化された Loki または Prometheus アラートルールが表示されます。これは、ルールの管理を目的としたデフォルトのルールリストビューです。各グループを展開すると、そのグループ内のルールのリストが表示されます。さらにルールを展開すると、その詳細を見ることができます。また、ルールから生成されたアクションボタンとアラートを展開して、詳細を表示することもできます。
**状態ビュー**
状態ビューには、アラートルールが状態ごとグループ化されて表示されます。このビューを使用すると、各ルールがどの状態にあるかを一目で確認できます。各ルールは展開して詳細を表示することがでます。アクションボタンとこのルールによって生成されたアラート、および各アラートをさらに展開して詳細を表示することができます。
## アラートルールのフィルタリング
**[アラート]** ページに表示されるアラートルールは、いくつかの方法でフィルタリングできます。
**アラートルールをフィルタリングするには**
1. **[データソースの選択]** からデータソースを選択します。選択したデータソースをクエリするアラートルールが表示されます。
1. **[ラベルで検索]** で、ラベルセレクタを使用して検索条件を入力します。例えば、`environment=production;region=~US|EU,severity!=warning`。
1. **[Filter alerts by state (状態別にアラートをフィルタリング)]** から、表示するアラート状態を選択します。その状態に一致するアラートルールが表示されます。他の状態に一致するルールは非表示になります。
# ミュートタイミング
****
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。
ミュートタイミングとは、ポリシーの新しい通知が生成されたり送信されないようにする繰り返しの時間間隔です。定期的なメンテナンス期間など、アラートが特定の期間や繰り返し発生するのを防ぐために使用されます。
サイレンスと似ていますが、ミュートタイミングはアラートルールの評価や、ユーザーインターフェースへのアラート表示を停止せず、通知の作成のみを防ぎます。
外部のアラートマネージャーデータソースの Grafana 管理のミュートタイミングとミュートタイミングを設定できます。
## ミュートタイミングとサイレンス
次の表に、「ミュートタイミング」と「サイレンス」の違いを示します。
| ミュートタイミング | サイレンス |
| --- | --- |
| 繰り返しの時間間隔を定義します。 | 開始時刻と終了時刻を固定します。 |
| 作成され、通知ポリシーに追加されます。 | ラベルを使用してアラートと照合し、サイレンスするかどうかが判断されます。 |
## ミュートタイミングの追加
ミュートタイミングは Grafana ワークスペースで作成できます。
**ミュートタイミングを追加するには**
1. Grafana コンソールの Grafana メニューで、**[アラート]** を選択します。
1. **[通知ポリシー]** を選択し、**[ミュートタイミング]** タブを選択します。
1. **[アラートマネージャー]** ドロップダウンから、編集するアラートマネージャーを選択します。
1. **[\$1 ミュートタイミングの追加]** ボタンを選択します。
1. フォームに入力して、ミュートタイミングに合わせて一致する[[時間間隔]](#v10-alerting-manage-muting-interval)を作成します。
1. ミュートタイミングを保存します。
## 通知ポリシーへのミュートタイミングの追加
ミュートタイミングが設定されたら、一定間隔でミュートする通知ポリシーに追加して使用します。
**通知ポリシーへのミュートタイミングの追加方法**
1. Grafana コンソールの Grafana メニューで、**[アラート]** を選択します。
1. **[通知ポリシー]** を選択し、**[通知ポリシー]** タブを選択します。
1. ミュートタイミングを追加する通知ポリシーを選択し、**[...]**、**[編集]** を選択します。
1. **[ミュートタイミング]** ドロップダウンから、ポリシーに追加するミュートタイミングを選択します。
1. 変更内容を保存します。
## 時間間隔
時間間隔は、アラートが抑制される特定の期間です。この期間は通常、特定の時間範囲と曜日、月、または年で構成されます。
サポートされている時間間隔のオプションは次のとおりです。
+ **[時間範囲]** – 開始時間を含み、終了時間を含まない時間 (場所が選択されていない場合は UTC で、それ以外の場合は現地時間)。
+ **Location (場所)** – タイミングの場所を設定します。時間範囲は、その場所の現地時間で表示されます。
+ **[曜日]** – 曜日または一連の曜日。例えば、`monday:thursday`。
+ **[月の日付]** – 1 か月内の日付。値は `1`～`31` の範囲で指定します。負の値は月の日を逆順で指定することを意味します。たとえば、`-1` は月の最終日を表します。
+ **[月]** - 暦月の完全な名前の数値で表された、その年の月。例えば、`1, may:august`。
+ **[年]** - 間隔の年または複数年。例えば、`2023:2024`。
これらの要素はそれぞれリストにすることができ、一致するには要素内の少なくとも 1 つの項目を満たす必要があります。フィールドは、`:` を使用して、範囲もサポートします。例えば、`monday:thursday`。
フィールドを空白のままにすると、任意の時刻をフィールドと照合します。のインスタントが完全な時間間隔と一致するには、すべてのフィールドが一致している必要があります。ミュートタイミングには複数の時間間隔を含めることができます。
正確な期間を指定する場合は、その期間に必要なすべてのオプションを指定します。例えば、3 月、6 月、9 月、12 月の最初の月曜日の 12:00 から 24:00 UTC の時間間隔を作成する場合、時間間隔の指定は次のようになります。
+ 時間範囲
+ 開始時間: `12:00`
+ 終了時間: `24:00`
+ 曜日: `monday`
+ 月: `3, 6, 9, 12`
+ 日: `1:7`
# アラートルールの状態と正常性を表示する
****
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。
アラートルールの状態と正常性は、アラートに関するいくつかの主要なステータスインジケータを提供します。
次の 3 つのコンポーネントがあります。
+ [アラートルールの状態](#v10-alerting-manage-rulestate-state)
+ [アラートインスタンスの状態](#v10-alerting-manage-rulestate-instance)
+ [アラートルールの正常性](#v10-alerting-manage-rulestate-health)
それぞれに関連はありますが、各コンポーネントは微妙に異なる情報を伝達します。
**アラートルールの状態と正常性を表示するには**
1. Grafana コンソールの Grafana メニューで、**[アラート]** を選択します。
1. **[アラートルール]** を選択して、既存のアラートのリストを表示します。
1. アラートルールを選択して、その状態と正常性を表示します。
## アラートルールの状態
アラートルールは、次のいずれかの状態になります。
| State | 説明 |
| --- | --- |
| [普通] | 評価エンジンによって返される時系列のいずれも pending または firing 状態ではありません。 |
| [保留中] | 評価エンジンから返される少なくとも 1 つの時系列は pending です。 |
| [発射] | 評価エンジンから返される少なくとも 1 つの時系列は firing です。 |
**注記**
アラートは最初に `pending` に移行し、次に `firing` に移行します。そのため、アラートが発生する前に少なくとも 2 つの評価サイクルが必要です。
## アラートインスタンスの状態
アラートインスタンスは、次のいずれかの状態になります。
| State | 説明 |
| --- | --- |
| [普通] | pending でも firing でもないアラートの状態。すべてが期待どおりに機能しています。 |
| [保留中] | 設定されたしきい値期間未満でアクティブであったアラートの状態。 |
| [アラート] | 設定されたしきい値期間よりも長くアクティブであったアラートの状態。 |
| [データなし] | 設定された時間枠のデータを受信しない状態。 |
| [アラート] | アラートルールの評価試行中にエラーが発生しました。 |
## 最後の状態を保持する
アラートルールは、`NoData` または `Error` 状態が発生したときに最後の状態を保持するように設定できます。これにより、アラートの発射、解決と再発射の両方が防止されます。通常の評価と同様に、アラートルールは保留期間が経過すると `pending` から `firing` に移行します。
## アラートルールの正常性
アラートルールは、次のいずれかのヘルスステータスを持つことができます。
| State | 説明 |
| --- | --- |
| [OK] | アラートルールを評価するときにエラーはありません。 |
| [エラー] | アラートルールの評価中にエラーが発生しました。 |
| [NoData] | ルール評価中に返される少なくとも 1 つの時系列にデータがありません。 |
| \$1status\$1、KeepLast | ルールは別のステータスを受け取りますが、アラートルールの最後の状態を保持するように設定されています。 |
## NoData とエラーの特別なアラート
アラートルールの評価で状態 `NoData` または `Error` が生成されると、Grafana アラートは、次の追加ラベルを含むアラートインスタンスを生成します。
| ラベル | 説明 |
| --- | --- |
| alertname | 状態に応じて、DatasourceNoData または DatasourceError のいずれか。 |
| datasource\$1uid | 状態の原因となったデータソースの UID。 |
**注記**
追加のラベルを生成するには、[Grafana マネージドアラートルールを設定する](v10-alerting-configure-grafanamanaged.md) のトピックで説明されているように、アラートルールで no data またはエラー処理を `NoData` または `Error` に設定する必要があります。
これらのアラートは、サイレンスを追加したり、コンタクトポイントにルーティングしたりするなど、通常のアラートと同じ方法で処理できます。
# アラートグループ別に表示およびフィルタリングする
****
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。
アラートグループは、アラートマネージャーインスタンスからのグループ化されたアラートを表示します。デフォルトでは、アラートルールは通知ポリシーのデフォルトポリシーのラベルキーによってグループ化されます。共通のアラートルールを 1 つのアラートグループにグループ化することで、重複したアラートルールが発生することを防ぎます。
アラートグループを表示し、特定の条件に一致するアラートルールをフィルター処理することもできます。
**アラートグループを表示するには**
1. Grafana コンソールの Grafana メニューで、**[アラート]** を選択します。
1. **[グループ]** を選択して、既存のグループを表示します。
1. **[アラートマネージャー]** ドロップダウンから、データソースとして外部アラートマネージャーを選択します。
1. **[カスタムグループ化]** ドロップダウンでラベルの組み合わせを選択して、デフォルト以外のグループを表示します。これは、通知ポリシーのグループをデバッグおよび検証するのに役立ちます。
アラートにルートポリシーのグループ化またはカスタムグループ化のいずれかで指定されたラベルが含まれていない場合、アラートは `No grouping` のヘッダーを持つ [すべてのグループを取得] に追加されます。
アラートは、ラベルまたはアラートの状態によってフィルタリングできます。
**ラベルでフィルタリングするには**
+ **[検索]** で既存のラベルを入力して、ラベルに一致するアラートを表示します。
例えば、`environment=production,region=~US|EU,severity!=warning`。
**状態でフィルタリングするには**
+ **[状態]** では、Active (アクティブ)、Suppressed (抑制)、または Unprocessed (未処理) の状態を選択すると、選択した状態に一致するアラートが表示されます。他のすべてのアラートは非表示になります。
# 通知エラーの表示
****
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。
通知エラーを表示し、送信に失敗したか受信されなかった理由を確認できます。
**注記**
この機能は Grafana アラートマネージャーでのみサポートされています。
**通知エラーを表示するには**
1. 左側のメニューから、**[アラート]**、**[コンタクトポイント]** を続けて選択します。
いずれかのコンタクトポイントが失敗した場合、ワークスペースの右隅にあるメッセージに、エラーがあることと、その数が表示されます。
1. コンタクトポイントを選択すると、そのコンタクトポイントのエラーの詳細が表示されます。
エラーアイコンにカーソルを合わせると、エラーの詳細が表示されます。
コンタクトポイントに複数の統合がある場合、各統合のすべてのエラーが表示されます。
1. [正常性] 列で、通知のステータスを確認します。
これは、[OK]、[試行なし]、または [エラー]のいずれかです。