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

# 将经典控制面板警报迁移到 Grafana Alerting
<a name="v10-alerting-use-grafana-alerts"></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 Alerting 的工作区，使用 [经典控制面板警报](old-alerts-overview.md)。要切换到新的 Grafana Alerting，必须选择启用此功能。要详细了解经典控制面板警报和 Grafana 警报之间的区别，请参阅。[Grafana Alerting 与旧版控制面板警报对比](#v10-alerting-diff-old-new) GrafanaLabs 已宣布将在版本 11 中删除经典仪表板警报。

使用经典控制面板警报时，Amazon Managed Grafana 会显示 Grafana Alerting 的预览，您可以在完成升级之前查看和修改升级后的警报。

## 预览 Grafana 警报
<a name="v10-alerting-preview-grafana-alerts"></a>

在迁移之前，您可以在 Grafana Alerting 中预览警报。在预览中，您可以对将更改迁移的警报进行更改。

**预览 Grafana Alerting 迁移**

1. 登录 Grafana 工作区。

1. 从左侧菜单中，选择**警报（旧版）**以查看当前警报。

1. 从左侧菜单中，选择**警报升级**，在 Grafana Alerting 中查看警报。

   在此视图中，您可以查看迁移后的警报。

**注意**  
您还可以在此视图中进行影响迁移的更改。要撤消所做的任何更改，请选择升级页面右上角的**重置升级**。

如果您准备好升级警报，请参阅下一节。

## 迁移到 Grafana Alerting 系统
<a name="v10-alerting-use-grafana-alerts-opt-in"></a>

您可以使用、或亚马逊托管 Grafana API 将您的亚马逊托管 Grafana 实例配置为使用 Grafana 警报。 AWS 管理控制台 AWS CLI有关如何配置 Amazon Managed Grafana（包括打开或关闭 Grafana Alerting）的详细信息，请参阅 [配置 Amazon Managed Grafana 工作区](AMG-configure-workspace.md)。

开启 Grafana Alerting 后，现有的经典控制面板警报将以兼容 Grafana Alerting 的格式迁移。在 Grafana 实例的“警报”页面中，您可以查看迁移的警报和新警报。借助 Grafana Alerting，Grafana 管理的警报规则会在匹配时发送多条通知，而不是单个警报。

对经典控制面板警报和 Grafana 警报的读写权限受存储这些警报的文件夹的权限控制。在迁移过程中，经典控制面板警报权限与新规则权限匹配，如下所示：
+ 如果原始警报的控制面板拥有权限，则迁移会创建一个以 `Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1}` 格式命名的文件夹，以匹配原始控制面板的权限（包括从该文件夹继承的权限）。
+ 如果没有控制面板权限，并且控制面板位于某个文件夹下，则规则将链接到该文件夹并继承其权限。
+ 如果没有控制面板权限，并且控制面板位于 General 文件夹下，则规则将链接到 General Alerting 文件夹并继承默认权限。

**注意**  
由于 Grafana Alerting 中没有 `NoData` 的 `Keep Last State` 选项，因此在经典规则迁移期间，此选项将变为 `NoData`。`Error` 处理的选项 `Keep Last State` 已迁移到新选项 `Error`。为了匹配 `Keep Last State` 的行为，在这两种情况下，在迁移过程中，Amazon Managed Grafana 会自动为每条警报规则创建一个静默，持续时间为一年。

通知通道将迁移到具有相应路由和接收器的 Alertmanager 配置。默认通知通道将作为联系点添加到默认路由。未与任何控制面板警报关联的通知通道将会转到 `autogen-unlinked-channel-recv` 路由。

### 限制
<a name="v10-alerting-use-grafana-alerts-limitations"></a>
+ Grafana Alerting 系统可从所有可用的 Prometheus、Loki 和 Alertmanager 数据来源检索规则。但可能无法从其他受支持的数据来源获取警报规则。
+ 在 Grafana 警报和经典控制面板警报之间来回迁移可能会导致一个系统支持的功能丢失数据，而另一个则不会。
**注意**  
如果您迁移回经典控制面板警报，则在启用 Grafana Alerting 时对警报配置进行的所有更改都将丢失，包括创建的任何新警报规则。

## Grafana Alerting 与旧版控制面板警报对比
<a name="v10-alerting-diff-old-new"></a>

Grafana 8 中引入的 Grafana Alerting 与旧版控制面板警报相比有多项增强。

### 多维警报
<a name="v10-alerts-diff-multi-dimensional"></a>

现在，您可以创建警报，通过单个警报规则提供系统范围的可见性。根据单个警报规则生成多个警报实例。例如，您可以创建一条规则，来监控一台主机上多个挂载点的磁盘使用情况。评估引擎会从单个查询返回多个时间序列，每个时间序列由其标签集标识。

### 在控制面板外部创建警报
<a name="v10-alerts-diff-alerts-outside-of-dashboards"></a>

与旧版控制面板警报不同，Grafana 警报允许创建查询和表达式，以独特的方式组合来自多个来源的数据。您仍然可以使用控制面板和面板的 ID，将控制面板和面板链接到警报规则，并快速对观察的系统进行故障排除。

由于统一警报不再与面板查询直接关联，因此通知邮件中不包含图像或查询值。您可以使用自定义通知模板来查看查询值。

### 创建 Loki 和 Grafana Mimir 警报规则
<a name="v10-alerts-diff-loki-mimir-alerting-rules"></a>

在 Grafana Alerting 中，您可以使用与 Grafana 管理的警报相同的 UI 和 API 管理 Loki 和 Grafana Mimir 警报规则。

### 查看和搜索来自 Prometheus 兼容数据来源的警报
<a name="v10-alerts-diff-view-alerts-from-prometheus"></a>

Prometheus 兼容数据来源的警报现在位于 Grafana 警报部分下。您可以跨多个数据来源搜索标签，以快速查找相关警报。

### 警报状态 NoData 和错误的特殊警报
<a name="v10-alerts-diff-special-alerts"></a>

Grafana Alerting 引入了警报状态的新概念。当对警报规则的评估产生状态 NoData 或错误时，Grafana Alerting 将生成带有以下标签的特殊警报：
+ `alertname`使用值 DatasourceNoData 或 DatasourceError 取决于州。
+ 特殊警报所属的警报规则的 `rulename` 名称。
+ `datasource_uid` 具有导致该状态的数据来源的 UID。
+ 原始警报规则的所有标签和注释

您可以像处理常规警报一样处理这些警报，方法是添加静默、路由到联系点等。

**注意**  
如果规则使用多个数据来源，而其中一个或多个数据来源未返回任何数据，则将为导致警报状态的每个数据来源创建特殊警报。