本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 配置联系点
<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. 从**选择 Alertmanager** 下拉列表中，选择 Alertmanager。默认选择 Grafana Alertmanager。

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 支持的联系点类型。


| Name | Type | 
| --- | --- | 
| 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 }}`,
}
```

如果密钥重复，用户定义的详细信息会覆盖默认的详细信息。