翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# コンタクトポイントの設定
<a name="v10-alerting-configure-contactpoints"></a>

****  
このドキュメントのトピックは、**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 で管理されるアラートの通知先 (コンタクトポイント) は、作成および編集が可能です。データソース管理アラートのコンタクトポイントは読み取り専用です。

## コンタクトポイント (通知先) の使用
<a name="v10-alerting-configure-contactpoints-working"></a>

次の手順では、通知先 (コンタクトポイント) を追加、編集、削除、テストする方法について説明します。

**コンタクトポイントの追加方法**

1. 左側のメニューで、**[アラート]** を選択します。

1. **[コンタクトポイント]** を選択します。

1. **[アラートマネージャーの選択]** ドロップダウンから、アラートマネージャーを選択します。デフォルトでは、Grafana アラートマネージャーが選択されています。

1. **[コンタクトポイント]** タブで、 **[\$1 コンタクトポイントの追加]** を選択します。

1. コンタクトポイントの** [名前]** を入力します。

1. **[統合]** からタイプを選択し、そのタイプに基づいて必須フィールドを入力します。例えば、Slack を選択した場合は、Slack チャネルと通知先となるユーザーを入力します。

1. 選択したコンタクトポイントで利用可能な場合は、任意の**オプション設定**を選択して追加の設定を指定します。

1. **[通知設定]**で**[解決済みメッセージの無効化]**を選択すると、アラートが解決した際に通知を受け取らないようにすることができます (任意)。

1. 別のコンタクトポイント統合を追加するには、**[コンタクトポイント統合を追加]** を選択し、必要なコンタクトポイントタイプごとにステップを繰り返します。

1. 変更内容を保存します。

**コンタクトポイントの編集方法**

1. 左側のメニューで、**[アラート]** を選択します。

1. **[コンタクトポイント]**を選択すると、現在設定されているコンタクトポイントのリストが表示されます。

1. 編集する連絡先を選択し、**[編集]** を選択します。

1. 連絡先を更新し、変更を保存します。

使用されていないコンタクトポイントは、通知ポリシーで削除できます。

**連絡先の削除方法**

1. 左側のメニューで、**[アラート]** を選択します。

1. **[コンタクトポイント]** を選択して、現在設定されているコンタクトポイントのリストを開きます。

1. **コンタクトポイント** で、削除するコンタクトポイントを選択し、**[詳細]**、**[削除]** を選択します。

1. 確認ダイアログボックスで、**[はい、削除]** を選択します。

**注記**  
コンタクトポイントが通知ポリシーで使用されている場合、コンタクトポイントを削除する前に、通知ポリシーを削除するか、別のコンタクトポイントを使用するように編集する必要があります。

コンタクトポイントを作成したら、テスト通知を送信して、正しく設定されていることを確認します。

**テスト通知の送信方法**

1. 左側のメニューで、**[アラート]** を選択します。

1. **[コンタクトポイント]** を選択して、現在設定されているコンタクトポイントのリストを開きます。

1. **コンタクトポイント** で、テストするコンタクトポイントを選択し、**[編集]** を選択します。必要に応じて、新しいコンタクトポイントを作成することもできます。

1. **[テスト]** を選択して、コンタクトポイントテストダイアログを開きます。

1. 事前定義されたテスト通知を送信するか、**[カスタム]** を選択してテスト通知に独自の注釈とラベルを追加するかを選択します。

1. **[テスト通知を送信]**を選択して、指定されたコンタクトポイント宛にアラートをテストします。

## コンタクトポイント統合の設定
<a name="v10-alerting-configure-contactpoints-integration"></a>

アラートルールの発射時に通知を受信するための優先通信チャネルを選択するように Grafana でコンタクトポイント統合を設定します。各統合には、独自の設定オプションとセットアッププロセスがあります。ほとんどの場合、これには API キーまたは Webhook URL の提供が含まれます。

設定が完了すると、コンタクトポイントの一部として統合を使用して、アラートの状態が変化するたびに通知を受け取ることができます。このセクションでは、PagerDuty を例として使用して統合を設定する基本的な手順について説明します。これにより、リアルタイムアラートの受信を開始し、モニタリングデータを常に把握できます。

**サポートされている統合のリスト**

次の表に、Grafana でサポートされているコンタクトポイントのタイプを示します。


| 名前 | タイプ | 
| --- | --- | 
| Amazon SNS | `sns` | 
| OpsGenie | `opsgenie` | 
| Pager Duty | `pagerduty` | 
| Slack | `slack` | 
| VictorOps | `victorops` | 

**アラート用の PagerDuty の設定**

PagerDuty を設定するには、統合キーを指定する必要があります。次の詳細情報を入力します：


| 設定 | 説明 | 
| --- | --- | 
| 統合キー | PagerDuty の統合キー | 
| 緊急度 | 動的通知のレベル。デフォルトは critical です。 | 
| カスタムの詳細 | イベントに関するその他の詳細 | 

`CustomDetails` フィールドは、任意のキーと値のペアを含むオブジェクトです。ユーザー定義の詳細が、デフォルトで使用されている詳細とマージされます。

`CustomDetails` のデフォルト値は次のとおりです。

```
{
	"firing":       `{{ template "__text_alert_list" .Alerts.Firing }}`,
	"resolved":     `{{ template "__text_alert_list" .Alerts.Resolved }}`,
	"num_firing":   `{{ .Alerts.Firing | len }}`,
	"num_resolved": `{{ .Alerts.Resolved | len }}`,
}
```

キーが重複している場合、ユーザー定義の詳細がデフォルトのキーを上書きします。