本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 管理警报通知 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 选择发送警报通知的方式、时间和地点是设置警报系统的重要组成部分。这些决定将直接影响您快速解决问题的能力，并且不会错过任何重要的事情。 首先，定义*联系点*，这些联系点定义了向何处发送警报通知。联系点可以是一组用于匹配通知的目标。向联系点添加通知模板，以便在通知中实现重用和一致的消息传递。 接下来，创建*通知策略*，该策略包含一组规则，规定了警报在何处、何时以及如何发送到联系点。在通知策略中，您可以选择创建的一个联系点，来定义将警报通知发送到何处。向通知策略添加静音定时。*静音定时*是一个重复的时间间隔，在此期间您不希望发送任何通知。 评估警报规则时，警报规则会向 Alertmanager 发送警报实例：一个警报规则可以触发多个单独的*警报实例*。 Alertmanager 会收到这些警报实例，然后处理静音定时，对警报分组，并按照通知策略中的定义将通知发送到联系点。 **Topics** + [Alertmanager](v9-alerting-managenotifications-alertmanager.md) + [使用联系点](v9-alerting-contact-points.md) + [使用通知策略](v9-alerting-notification-policies.md) + [自定义通知](v9-alerting-notifications.md) + [静默 Prometheus 数据来源的警报通知](v9-alerting-silences.md) + [静音定时](v9-alerting-notification-muting.md) + [按警报组查看和筛选](v9-alerting-viewfiltergroups.md) + [查看通知错误](v9-alerting-viewnotificationerrors.md) # Alertmanager **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 Alertmanager 让您可以快速高效地管理和响应警报。还可以接收警报、处理静音、抑制、分组和路由，通过您选择的渠道（如电子邮件或 Slack）发送通知。 在 Grafana 中，您可以使用 Grafana Alertmanager 或外部 Alertmanager。您也可以运行多个 Alertmanager，具体取决于您的设置和警报的生成位置。 **Grafana Alertmanager** Grafana Alertmanager 是一个预先配置的内部 Alertmanager，如果您在本地或开源环境下运行 Grafana，默认情况下可供选择。 Grafana Alertmanager 可以接收来自 Grafana 的警报，但不能接收来自 Grafana 外部的警报，例如来自 Mimir 或 Loki 的警报。 **注意** Grafana Alertmanager 不支持抑制规则。 **外部 Alertmanager** 如果您想使用单个 Alertmanager 来接收所有 Grafana、Loki、Mimir 和 Prometheus 警报，可将 Grafana 设置为使用外部 Alertmanager。然后，可以在 Grafana 中配置和管理此外部 Alertmanager。 以下是两个示例，说明了您可能需要配置自己的外部 Alertmanager 并向其发送警报，而不是向 Grafana Alertmanager 发送警报的情况： 1. 您已经在自己的云基础设施中部署了本地 Alertmanager，并希望继续使用，因为您还有其他警报生成器，比如 Prometheus。 1. 您想同时使用 Prometheus 本地和托管 Grafana 将警报发送到云基础设施中运行的同一个 Alertmanager。 Alertmanager 位于“警报联系点”和“通知策略”页面的下拉菜单中。 如果要预置数据来源，请将 `jsonData` 字段中的标志 `handleGrafanaManagedAlerts` 中设置为 `true`，以将 Grafana 管理的警报发送到此 Alertmanager。 # 使用联系点 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 使用联系点可定义当警报启动时，如何通知联系人。一个联系点可以有一个或多个联系点集成，例如 Amazon Simple Notification Service 或 Slack。启动警报后，将向联系点列出的所有联系点集成发送通知。（可选）使用[通知模板](v9-alerting-create-templates.md)可为联系点类型自定义通知消息。 **注意** 您可以为 Grafana 管理的警报创建和编辑联系点。Alertmanager 警报的联系点为只读。 ## 使用联系点 以下过程详细介绍了如何添加、编辑、测试和删除联系点。 **添加联系点** 1. 在 Grafana 控制台的 Grafana 菜单中，选择**警报**（铃铛）图标，打开**警报**页面。 1. 选择**联系点**，然后选择**新建联系点**。 1. 从 **Alertmanager** 下拉列表中，选择 Alertmanager。默认选择 Grafana Alertmanager。 1. 输入联系点的**名称**。 1. 从**联系点集成**中选择一种类型，并根据该类型选择必填字段。例如，如果您选择 Slack，请输入应联系的 Slack 频道和用户。 1. 如果您选择的联系点可用，请选择所需的**可选设置**来指定其他设置。 1. 在**通知设置**下，如果您不希望在警报得到解决时收到通知，可以选择**禁用已解决消息**。 1. 如果您的联系点需要更多联系点类型，则可以选择**添加联系点集成**，然后针对所需的每种联系点类型，重复上述步骤。 1. 选择**保存联系点**，保存您的更改。 **编辑联系点** 1. 选择**联系点**，以查看现有联系点列表。 1. 选择要编辑的联系点，然后选择**编辑**图标（笔）。 1. 进行任何必要的更改，然后选择**保存联系点**，以保存更改。 创建联系点后，您可以发送测试通知，以验证其配置是否正确。 **发送测试通知** 1. 选择**联系点**，以打开现有联系点列表。 1. 选择要测试的联系点，然后选择**编辑**图标（笔）。 1. 选择**测试**图标（纸飞机）。 1. 选择是发送预定义的测试通知，还是通过选择**自定义**，在测试通知中添加您自己的自定义注释和标签。 1. 选择**发送测试通知**，使用给定的联系点测试警报。 您可以删除通知策略不使用的联系点。 **删除联系点** 1. 选择**联系点**，以打开现有联系点列表。 1. 选择要删除的联系点，然后选择**删除**图标（垃圾桶）。 1. 在确认对话框中，选择**是，删除**。 **注意** 如果通知策略正在使用该联系点，则必须先删除通知策略，或对其进行编辑以使用不同的联系点，然后再删除该联系点。 ## 支持的通知程序列表 | Name | Type | | --- | --- | | Amazon SNS | sns | | OpsGenie | opsgenie | | Pager Duty | pagerduty | | Slack | slack | | VictorOps | victorops | # 使用通知策略 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 通知策略决定如何将警报路由到联系点。策略具有树形结构，其中每个策略都可以有一个或多个子策略。除了根策略外，每个策略还可以匹配特定的警报标签。每个警报先由根策略进行评估，然后由每个子策略进行评估。如果为特定策略启用了 `Continue matching subsequent sibling nodes` 选项，则即使有一个或多个匹配项，评估仍会继续。父策略的配置设置和联系点信息控制着与任何子策略都不匹配的警报的行为。根策略将管理所有与特定策略不匹配的警报。 **注意** 您可以为 Grafana 托管的警报创建和编辑通知策略。Alertmanager 警报的通知策略是只读的。 **对通知进行分组** 分组将性质相似的警报通知归类到单个漏斗中。这样一来，当系统的许多部分同时发生故障，导致大量警报同时启动时，您就可以在大规模故障期间控制警报通知。 **分组示例** 假设有 100 个服务在不同的环境中连接到一个数据库。这些服务由标签 `env=environmentname` 区分。已设置警报规则，用于监控您的服务是否可以访问数据库。警报规则会创建名为 `alertname=DatabaseUnreachable` 的警报。 如果发生网络分区，有一半的服务无法再访问数据库，则会启动 50 个不同的警报。对于这种情况，您会希望收到列出受影响环境的单页通知（而不是 50 页）。 您可以将分组配置为 `group_by: [alertname]`（不使用 `env` 标签，该标签对于每个服务都不同）。完成此配置后，Grafana 会发送一条简要的通知，其中包含此警报规则的所有受影响环境。 **特殊组** Grafana 有两个特殊组。默认组 `group_by: null` 会将*所有*警报分组中到一个组中。您也可以使用名为 `...` 的特殊标签，按所有标签对警报进行分组，从而有效地禁用分组，并将每个警报发送到其自己的组中。 ## 使用通知 以下过程演示了如何创建和管理通知策略。 **编辑根通知策略** 1. 在 Grafana 控制台的 Grafana 菜单中，选择**警报**（铃铛）图标，打开**警报**页面。 1. 选择**通知策略**。 1. 从 **Alertmanager** 下拉列表中，选择要编辑的 Alertmanager。 1. 在**根策略**部分，选择**编辑**图标（笔）。 1. 在**默认联系点**中，更新当警报规则与任何特定策略都不匹配时，应向其发送规则通知的联系点。 1. 在**分组依据**中，选择用于对警报进行分组的标签（或特殊组）。 1. 在**定时选项**中，选择以下选项。 + **组等待**：在发送初始通知前，缓冲同一组警报的等待时间。默认值为 30 秒。 + **组间隔**：一个组的两次通知之间的最短时间间隔。默认值为 5 分钟。 + **重复间隔**：如果组内未添加新警报，在重新发送通知之前的最短时间间隔。默认为 4 小时。 1. 选择 **保存** 以保存您的更改。 **添加新的顶级特定策略** 1. 在 Grafana 控制台的 Grafana 菜单中，选择**警报**（铃铛）图标，打开**警报**页面。 1. 选择**通知策略**。 1. 从 **Alertmanager** 下拉列表中，选择要编辑的 Alertmanager。 1. 在**特定路由**部分，选择**新建特定策略**。 1. 在**匹配标签**部分，添加一个或多个匹配的警报标签。有关标签匹配的更多信息，请参阅本主题的后半部分。 1. 在**联系点**中，添加当警报与此特定策略匹配时，要向其发送通知的联系点。嵌套策略会覆盖此联系点。 1. （可选）启用**继续匹配后续同级节点**以继续匹配同级策略，即使警报与当前策略匹配后也是如此。启用此策略后，您可以收到关于同一警报的多个通知。 1. 可以选择**覆盖分组**，指定与根策略不同的分组。 1. 可以选择**覆盖一般定时**，以覆盖组通知策略中的定时选项。 1. 选择**保存策略**以保存您的更改。 **要添加嵌套策略** 1. 展开要在其下创建嵌套策略的特定策略。 1. 选择**添加嵌套策略**，然后添加详细信息（就和添加顶级特定策略时一样）。 1. 选择**保存策略**以保存您的更改。 **编辑特定策略** 1. 在**警报**页面，选择**通知策略**，打开列出现有策略的页面。 1. 选择要编辑的策略，然后选择**编辑**图标（笔）。 1. 进行任何更改（和添加顶级特定策略时一样）。 1. 选择**保存策略**。 **搜索策略** 您可以按*标签匹配程序*或*联系点*在策略树中进行搜索。 + 要按联系点搜索，请在**按联系点搜索**字段中输入联系点的部分或全部名称。 + 要按标签搜索，请在**按标签搜索**字段中输入有效的标签匹配程序。您可以输入多个匹配程序，以逗号分隔。例如，有效的匹配程序输入为 `severity=high, region=~EMEA|NA`。 **注意** 按标签搜索时，所有匹配的策略都将完全匹配。不支持部分匹配和正则表达式匹配。 **标签匹配的工作原理** 如果警报的标签与策略中指定的所有*匹配标签*相匹配，则策略与警报相匹配。 + **标签**：要匹配的标签名称。必须与警报的标签名称完全匹配。 + **运算符**：用于将标签值与匹配标签值进行比较的运算符。可用的运算符有： + `=` 选择其值与提供的字符串完全匹配的标签。 + `!=` 选择其值与提供的字符串不匹配的标签。 + `=~` 选择其值与所提供字符串的正则表达式解释值相匹配的标签（提供的字符串被解释为正则表达式）。 + `!=` 选择与提供的正则表达式不匹配的标签。 + **值**：要与标签值匹配的值。可作为字符串或正则表达式进行匹配，具体取决于所选的运算符。 # 自定义通知 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 使用通知模板自定义通知。 您可以使用通知模板来更改通知中消息的标题、内容和格式。 通知模板不与电子邮件或 Slack 等特定联系点集成绑定。但您可以选择为不同的联系点集成创建单独的通知模板。 您可以使用通知模板： + 在通知中添加、移除或重新排序信息，包括摘要、描述、标签和注释、值和链接 + 为文本设置粗体和斜体格式，添加或移除换行符 您不能使用通知模板： + 更改 Slack 和 Microsoft Teams 等即时消息服务中的通知设计 **Topics** + [使用 Go 的模板语言](v9-alerting-notifications-go-templating.md) + [创建通知模板](v9-alerting-create-templates.md) + [模板参考](v9-alerting-template-reference.md) # 使用 Go 的模板语言 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.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 的特殊光标，写成`.`了。您可以将此光标看作一个变量，其值会根据在模板中使用的位置而变化。例如，在通知模板 `.` 的开头引用 `ExtendedData` 对象，该对象包含多个字段，例如包括 `Alerts`、`Status`、`GroupLabels`、`CommonLabels`、`CommonAnnotations` 和 `ExternalURL`。但是，当在列表上的 `range` 中使用、在 `with` 中使用或编写要在其他模板中使用的功能模板时，dot 可能引用其他内容。您可以在 [创建通知模板](v9-alerting-create-templates.md) 中看到相关示例，在 [模板参考](v9-alerting-template-reference.md) 中看到所有数据和函数。 ## 开始和结束标签 在 text/template 中，模板以 `{{` 开头，以 `}}` 结尾，无论模板是打印变量还是运行 if 语句等控制结构。这与 Jinja 等其他模板语言不同，在 Jinja 中，打印变量使用 `{{` 和 `}}`，控制结构使用 `{%` 和 `%}`。 ## Print（打印） 要打印某项的值，请使用 `{{` 和 `}}`。您可以打印 dot 的值、dot 的字段、函数的结果和[变量](#v9-go-variables)的值。例如，要打印 `Alerts` 字段，其中 dot 引用 `ExtendedData`，您可以编写以下内容： ``` {{ .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 引用警报列表中的当前警报，然后在排序标签上使用第二个范围，使 dot 第二次更新以引用当前标签。在第二个范围内，使用 `.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 }} ``` ## If 语句 可在模板中使用 if 语句。例如，要在 `.Alerts` 中没有警报的情况下打印 `There are no alerts`，您可以编写以下内容： ``` {{ if .Alerts }} There are alerts {{ else }} There are no alerts {{ end }} ``` ## With With 与 if 语句类似，但又有所不同，`with` 会更新 dot 以引用 with 的值： ``` {{ with .Alerts }} There are {{ len . }} alert(s) {{ else }} There are no alerts {{ end }} ``` ## 变量 中的变量 text/template 必须在模板中创建。例如，要使用 dot 的当前值创建一个名为 `$variable` 的变量，您可以编写以下内容： ``` {{ $variable := . }} ``` 您可以在范围或 `with` 内使用 `$variable`，以引用定义变量时的 dot 值，而不是当前 dot 的值。 例如，您不能编写在第二个范围中使用 `{{ .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 }} ``` 您可以在第一个范围内和第二个范围之前定义一个名为 `$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 }} ``` ## 带索引的范围 您可以在范围的开头定义 index 和 value 变量来获取范围内每个警报的索引： ``` {{ $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 不会阻止或显示错误消息。 ``` {{ 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 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 创建可重用的通知模板发送给联系点。 您可以向通知模板添加一个或多个模板。 通知模板名称必须唯一。同一通知模板或不同通知模板中不能有两个同名的模板。避免定义与默认模板同名的模板，例如：`__subject`、`__text_values_list`、`__text_alert_list`、`default.title` 和 `default.message`。 在“联系点”选项卡中，您可以看到通知模板的列表。 ## 创建通知模板 **创建通知模板** 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. 输入整个通知模板的名称。例如 `email`。 1. 在内容字段中写入每个模板，包括每个模板开头和结尾的 `{{ define "name-of-template" }}` 和 `{{ end }}`。您可以为通知模板中的每个模板使用描述性名称，例如，`email.subject` 或 `email.message`。在这种情况下，不要重复使用您在上面输入的通知模板的名称。 下面的部分展示了您可能创建的模板的详细示例。 1. 点击保存。 ## 为电子邮件主题创建模板 为电子邮件主题创建模板，其中包含触发和已解决的警报数量，如以下示例所示： ``` 1 firing alerts, 0 resolved alerts ``` **为电子邮件主题创建模板** 1. 使用以下内容创建一个名为 `email.subject` 的模板： ``` {{ define "email.subject" }} {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts {{ end }} ``` 1. 创建联系点集成时，请使用模板将其放入带有 `template` 关键字的**主题**字段中。 ``` {{ template "email.subject" . }} ``` ## 为电子邮件消息创建模板 为电子邮件消息创建模板，其中包含所有触发和已解决的警报数量，如以下示例所示： ``` 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 ``` **为电子邮件消息创建模板** 1. 创建一个名为 `email` 的通知模板，内容中包含两个模板：`email.message_alert` 和 `email.message`。 `email.message_alert` 模板用于打印每个触发和已解决警报的标签和值，而 `email.message` 模板包含电子邮件的结构。 ``` {{- 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` 关键字的**标题**字段中。 ``` {{ template "slack.title" . }} ``` ## 为 Slack 消息内容创建模板 为 Slack 消息内容创建模板，其中包含所有触发和已解决警报的描述，包括其标签、注释和控制面板 URL： ``` 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` 的模板，内容中包含两个模板：`slack.print_alert` 和 `slack.message`。 `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` 关键字的**正文**字段中。 ``` {{ template "slack.message" . }} ``` ## 使用共享模板对电子邮件和 Slack 进行模板化 您可以共享同一个模板，而不是为每个联系点创建单独的通知模板，例如电子邮件和 Slack。 例如，如果要发送包含此主题的电子邮件和包含标题 `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. 对于电子邮件，请从电子邮件联系点集成中的主题字段运行模板： ``` {{ template "common.subject_title" . }} ``` 1. 对于 Slack，请从 Slack 联系点集成中的标题字段运行模板： ``` {{ template "common.subject_title" . }} ``` ## 使用通知模板 使用联系点中的模板来自定义通知。 **在创建联系点时使用模板** 1. 从**警报**菜单中，选择**联系点**，以查看现有联系点列表。 1. 选择**添加联系点**。或者，您可以选择要编辑的联系点旁边的**编辑**图标（笔）来编辑现有联系点。 1. 在一个或多个字段（如**消息**或**主题**）中输入要使用的模板。要输入模板，请使用表单`{{ template "template_name" . }}`，*template\$1name*替换为要使用的模板的名称。 1. 单击**保存联系点**。 # 模板参考 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 本节提供了创建模板的参考信息。 ## 模板数据 以下数据将传递给消息模板。 | Name | Type | 注意 | | --- | --- | --- | | `Receiver` | 字符串 | 要向其发送通知的联系点的名称。 | | `Status` | 字符串 | 如果至少有一个警报已触发，则为“触发”，否则为“已解决”。 | | `Alerts` | 警报 | 此通知中包含的警报对象列表（见下文）。 | | `GroupLabels` | KeyValue | 这些警报的分组标签。 | | `CommonLabels` | KeyValue | 此通知中包含的所有警报的通用标签。 | | `CommonAnnotations` | KeyValue | 此通知中包含的所有警报的通用注释。 | | `ExternalURL` | 字符串 | 指向发送通知的 Grafana 的返回链接。如果使用外部 Alertmanager，则是指向此 Alertmanager 的返回链接。 | `Alerts` 类型公开了两个函数，用于筛选返回的警报。 + `Alerts.Firing`：返回已触发警报的列表。 + `Alerts.Resolved`：返回已解决警报的列表。 **警报（类型）** 警报类型包含以下数据。 | Name | Type | 注意 | | --- | --- | --- | | Status | 字符串 | `firing` 或 `resolved`。 | | 标签 | KeyValue | 附加到警报的一组标签。 | | Annotations | KeyValue | 附加到警报的一组注释。 | | 值 | KeyValue | 所有表达式的值，包括经典条件 | | StartsAt | time.Time | 警报开始触发的时间。 | | EndsAt | time.Time | 仅在知道警报结束时间时设置。否则，设置为从收到最后一次警报的时间起算的可配置的超时周期。 | | GeneratorURL | 字符串 | 指向 Grafana 或外部 Alertmanager 的返回链接。 | | SilenceURL | 字符串 | 指向静默警报的链接（其中预填了此警报的标签）。仅适用于 Grafana 管理的警报。 | | DashboardURL | 字符串 | 指向 Grafana 控制面板的链接（适用于警报规则属于 Grafana 控制面板的情况）。仅适用于 Grafana 管理的警报。 | | PanelURL | 字符串 | 指向 Grafana 控制面板中面板的链接（适用于警报规则属于 Grafana 控制面板中面板的情况）。仅适用于 Grafana 管理的警报。 | | 指纹 | 字符串 | 可用于识别警报的指纹。 | | ValueString | 字符串 | 该字符串包含警报中每个简化表达式的标签和值。 | **ExtendedData** 该 ExtendedData 对象包含以下属性。 | Name | 类型 | 说明 | 示例 | | --- | --- | --- | --- | | 接收方 | `string` | 发送通知的联系点名称。 | `{{ .Receiver }}` | | Status | `string` | 状态为 `firing if at least one alert is firing, otherwise 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 工作区或 Alertmanager 的链接。 | `{{ .ExternalURL }}` | **KeyValue type** `KeyValue`类型是一组表示标签和注释的 key/value 字符串对。 除了直接访问存储为 `KeyValue` 的数据外，还有方法可以对这些数据进行排序、删除和转换。 | Name | 参数 | 返回值 | 注意 | 示例 | | --- | --- | --- | --- | --- | | SortedPairs | | 键值字符串对的排序列表 | | `{{ .Annotations.SortedPairs }}` | | 删除 | []string | KeyValue | 返回不带给定键 Key/Value 的地图副本。 | `{{ .Annotations.Remove "summary" }}` | | 名称 | | []string | 标签名称列表 | `{{ .Names }}` | | 值 | | []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" }} ``` 您可以在[此处](https://pkg.go.dev/time#pkg-constants)找到 Go 的时间格式参考。 ## 模板函数 使用模板函数，您可以处理标签和注释，以生成动态通知。可使用以下函数。 | Name | 参数类型 | 返回类型 | 说明 | | --- | --- | --- | --- | | `humanize` | 数字或字符串 | 字符串 | 使用公制前缀将数字转换为更易读的格式。 | | `humanize1024` | 数字或字符串 | 字符串 | 与 humanize 类似，但使用 1024 作为基数，而不是 1000。 | | `humanizeDuration` | 数字或字符串 | 字符串 | 将以秒为单位的持续时间转换为更易读的格式。 | | `humanizePercentage` | 数字或字符串 | 字符串 | 将比率值转换为百分比。 | | `humanizeTimestamp` | 数字或字符串 | 字符串 | 将以秒为单位的 Unix 时间戳转换为更易读的格式。 | | `title` | 字符串 | 字符串 | strings.Title，将每个单词的第一个字符大写。 | | `toUpper` | 字符串 | 字符串 | 字符串。 ToUpper，将所有字符转换为大写。 | | `toLower` | 字符串 | 字符串 | 字符串。 ToLower，将所有字符转换为小写。 | | `match` | 模式、文本 | 布尔值 | regexp。 MatchString 测试未锚定的 regexp 匹配项。 | | `reReplaceAll` | 模式、置换、文本 | 字符串 | Regexp。 ReplaceAllString 正则表达式替换，未锚定。 | | `graphLink` | 字符串：包含 `expr` 和 `datasource` 字段的 JSON 对象 | 字符串 | 返回给定表达式和数据来源在 Explore 中图形视图的路径。 | | `tableLink` | 字符串：包含 `expr` 和 `datasource` 字段的 JSON 对象 | 字符串 | 返回给定表达式和数据来源在 Explore 中表格视图的路径。 | | `args` | []interface\$1\$1 | map[string]interface\$1\$1 | 将对象列表转换为带键的映射，例如 arg0、arg1。使用此函数可将多个参数传递给模板。 | | `externalURL` | nothing | 字符串 | 返回代表外部 URL 的字符串。 | | `pathPrefix` | nothing | 字符串 | 返回外部 URL 的路径。 | 下表列出了每个函数的使用示例。 | 函数 | TemplateString | Input | 预期 | | --- | --- | --- | --- | | humanize | \$1 humanize \$1value \$1 | 1234567.0 | 1.235M | | humanize1024 | \$1 humanize1024 \$1value \$1 | 1048576.0 | 1Mi | | humanizeDuration | \$1 humanizeDuration \$1value \$1 | 899.99 | 14m 59s | | humanizePercentage | \$1 humanizePercentage \$1value \$1 | 0.1234567 | 12.35% | | humanizeTimestamp | \$1 humanizeTimestamp \$1value \$1 | 1435065584.128 | 2015-06-23 13:19:44.128 \$10000 UTC | | 删除实例快照 | \$1 \$1value \$1 title \$1 | aa bB CC | Aa Bb Cc | | toUpper | \$1 \$1value \$1 toUpper \$1 | aa bB CC | AA BB CC | | toLower | \$1 \$1value \$1 toLower \$1 | aa bB CC | aa bb cc | | match | \$1 match "a\$1" \$1labels.instance \$1 | aa | true | | reReplaceAll | \$1\$1 reReplaceAll “localhost :( .\$1)” “我的.domain：\$11" \$1labels.instance\$1\$1 | localhost:3000 | my.domain:3000 | | graphLink | \$1\$1 graphLink "\$1\$1"expr\$1": \$1"up\$1", \$1"datasource\$1": \$1"gdev-prometheus\$1"\$1" \$1\$1 | | /explore?left=["now-1h","now","gdev-prometheus",\$1"datasource":"gdev-prometheus","expr":"up","instant":false,"range":true\$1] | | tableLink | \$1\$1 tableLink "\$1\$1"expr\$1":\$1"up\$1", \$1"datasource\$1":\$1"gdev-prometheus\$1"\$1" \$1\$1 | | /explore?left=["now-1h","now","gdev-prometheus",\$1"datasource":"gdev-prometheus","expr":"up","instant":true,"range":false\$1] | | args | \$1\$1define "x"\$1\$1\$1\$1.arg0\$1\$1 \$1\$1.arg1\$1\$1\$1\$1end\$1\$1\$1\$1template "x" (args 1 "2")\$1\$1 | | 1 2 | | externalURL | \$1 externalURL \$1 | | http://localhost/path/prefix | | pathPrefix | \$1 pathPrefix \$1 | | /path/prefix | # 静默 Prometheus 数据来源的警报通知 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 对于外部警报管理器数据来源（包括 Amazon Managed Service for Prometheus），您可以通过*静默*来抑制警报通知。静默只会阻止创建通知：静默不会阻止评估警报规则，也不会阻止警报实例显示在用户界面中。当警报静默时，您可以指定抑制警报的时间范围。 您可以为外部 Alertmanager 数据来源配置静默。 **注意** 要按固定的时间间隔或针对其他数据来源（例如，定期维护期间）抑制警报通知，请使用 [静音定时](v9-alerting-notification-muting.md) 而不是静默。 **添加静默** 1. 在 Grafana 控制台的 Grafana 菜单中，选择**警报**（铃铛）图标，打开**警报**页面。 1. 选择**静默**以打开列出现有 [使用联系点](v9-alerting-contact-points.md) 的页面。 1. 从 **Alertmanager** 下拉列表中选择外部 Alertmanager。 1. 选择**添加静默**。 1. 在**静默开始和结束**中选择开始和结束日期，以指示静默应何时生效和结束。 除了设置结束时间之外，还可以在**持续时间**中指定强制静默的时长。这会自动更新**静默开始和结束**字段中的结束时间。 1. 在**名称**和**值**字段中，输入一个或多个*匹配标签*。匹配程序决定静默适用于哪些规则。在此过程之后，我们将详细介绍标签匹配。 1. （可选）添加**注释**，或修改**创建者**以设置静默的所有者。 1. 选择**创建**以创建静默。 您可以选择**编辑**图标（钢笔）来编辑现有静默。 **警报抑制的标签匹配** 创建静默时，可以创建一组*匹配标签*作为静默的一部分。这是一组关于标签的规则，标签必须匹配才能抑制警报。匹配标签由三部分组成： + **标签**：要匹配的标签名称。必须与警报的标签名称完全匹配。 + **运算符**：用于将标签值与匹配标签值进行比较的运算符。可用的运算符有： + `=` 选择其值与提供的字符串完全匹配的标签。 + `!=` 选择其值与提供的字符串不匹配的标签。 + `=~` 选择其值与所提供字符串的正则表达式解释值相匹配的标签（提供的字符串被解释为正则表达式）。 + `!=` 选择与提供的正则表达式不匹配的标签。 + **值**：要与标签值匹配的值。可作为字符串或正则表达式进行匹配，具体取决于所选的运算符。 静默将在指定的结束日期结束，但您可以随时手动结束抑制。 **手动结束静默** 1. 在**警报**页面中，选择**静默**以查看现有静默列表。 1. 选择要结束的静默，然后选择**取消静默**。这将结束警报抑制。 **注意** 取消静默会结束警报抑制，就像为当前时间设置的结束时间一样。已结束（自动或手动）的静默会保留并列出五天。您无法从列表中手动删除静默。 **创建指向静默创建表单的链接** 您可以创建一个指向静默创建表单的 URL，其中已填写详细信息。操作员可使用此表单在操作事件期间快速抑制警报。 创建指向静默表单的链接时，使用 `matchers` 查询参数来指定匹配的标签，使用 `comment` 查询参数来指定注释。`matchers` 参数需要使用表单中的一个或多个 `[label][operator][value]` 值（以逗号分隔）。 **示例 URL** 要链接到带有匹配标签 `severity=critical` 和 `cluster!~europe-.*` 以及注释 `Silencing critical EU alerts` 的静默表单，请使用如下 URL。*mygrafana*替换为您的 Grafana 实例的主机名。 ``` https://mygrafana/alerting/silence/new?matchers=severity%3Dcritical%2Ccluster!~europe-*&comment=Silence%20critical%20EU%20alert ``` 要链接到外部 Alertmanager 的新静默页面，请添加带有 Alertmanager 数据来源名称的 `alertmanager` 查询参数，比如 `alertmanager=myAlertmanagerdatasource`。 # 静音定时 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 静音定时是一个重复的时间间隔，在此期间，不会针对某个策略生成或发送新的通知。使用静音定时可防止警报在特定的重复时间段（如定期维护时间段）内触发。 与静默类似，静音定时不会阻止对警报规则进行评估，也不会阻止警报实例显示在用户界面中。只会阻止创建通知。 您可以配置 Grafana 管理的静音定时，以及外部 Alertmanager 数据来源的静音定时。 **静音定时与静默的对比** 下表重点说明了静音定时与静默之间的区别。 | 静音定时 | 静默 | | --- | --- | | 使用可重复发生的时间间隔定义。 | 有固定的开始时间和结束时间。 | | 创建后添加到通知策略中。 | 使用标签与警报进行匹配，以确定是否静默。 | | 可与 Grafana Alerting 和外部 Alertmanager 配合使用。 | 仅适用于外部 Alertmanager。 | **创建静音定时** 1. 在 Grafana 控制台的 Grafana 菜单中，选择**警报**（铃铛）图标，打开**警报**页面。 1. 选择**通知策略**。 1. 从 **Alertmanager** 下拉列表中，选择要编辑的 Alertmanager。 1. 在**静音定时**部分，选择**添加静音定时**按钮。 1. 选择要应用静音定时的时间间隔。 1. 选择**提交**，以创建静音定时。 **向通知策略添加静音定时** 1. 选择要向其添加静音定时的通知策略，然后选择**编辑**按钮。 1. 从**静音定时**下拉列表中，选择要添加到策略中的静音定时。 选择**保存策略**按钮。 **时间间隔** 时间间隔是对时间范围的定义。如果警报在此时间间隔中启动，该警报将被抑制。使用 `:` 可支持范围（例如 `monday:thursday`）。静音定时可以包含多个时间间隔。时间间隔由多个字段组成（详细信息见下表），所有字段都必须匹配才能抑制警报。例如，如果指定一周中的天数为 `monday:friday`，时间范围为 8:00 到 9:00，则星期一至星期五的 8 到 9 点会抑制警报，但星期六的 8 到 9 点不会。 + **时间范围**：一天中抑制通知的时间。包含**开始时间**和**结束时间**两个子字段。以时间 `14:30` 为例。时间以 24 小时制表示，采用 UTC 时区。 + **星期几**：一周中的哪几天。可以是单日（例如 `monday`）、范围（例如 `monday:friday`），也可以是逗号分隔的多日列表（例如 `monday, tuesday, wednesday`）。 + **月份**：要选择的月份。您可以用数字指定月份，也可以用完整的月份名称指定月份，例如 `1` 或 `january` 都是指定 1 月。您可以指定单个月份、月份范围，或以逗号分隔的月份列表。 + **月中日期**：一个月中的哪几天。值范围为 `1` 到 `31`。负值可按相反顺序指定月中日期，因此 `-1` 代表月中最后一天。可以将月中日期指定为单日、日期范围，或用逗号分隔的多日列表。 + **年份**：间隔的年份。例如 `2023:2025`。 这些元素中的每一个都可以是一个列表，并且必须满足元素中的至少一项才能匹配。因此，如果将年份设置为 `2023:2025, 2027`，那么 2023 年、2024 年、2025 年和 2027 年（2026 年除外）都满足条件。 如果字段留空，则任何时刻都将与该字段匹配。时刻必须与所有字段匹配，才能匹配完整的时间间隔。 如果要指定确切的持续时间，请指定该持续时间所需的所有选项。例如，如果您想为当月第一个星期一（3 月、6 月、9 月和 12 月）创建一个介于 12:00 和 24:00 UTC 之间的时间间隔，则您的时间间隔规范可以是： + 时间范围： + 开始时间：`12:00` + 结束时间：`24:00` + 星期几：`monday` + 月份：`3, 6, 9, 12` + 月中日期：`1:7` # 按警报组查看和筛选 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 警报组显示来自 Alertmanager 实例的分组警报。默认情况下，警报规则按通知策略中根策略的标签键进行分组。将常见警报规则分组到一个警报组中可以防止触发重复的警报规则。 您可以查看警报组，也可以筛选符合特定条件的警报规则。 **查看警报分组** 1. 在 Grafana 菜单中，单击**警报**（铃铛）图标以打开列出现有警报的“警报”页面。 1. 单击**警报组**，打开列出现有组的页面。 1. 从 **Alertmanager** 下拉菜单中，选择外部 Alertmanager 作为数据来源。 1. 从**自定义分组依据**下拉菜单中，选择标签组合，以查看默认分组以外的分组。这对于调试和验证通知策略分组非常有用。 如果警报不包含根策略分组或自定义分组中指定的标签，则会将警报添加到标题为 `No grouping` 的全包分组中。 **按标签筛选** + 在**搜索**中，输入现有标签，以查看与该标签匹配的警报。 例如 `environment=production,region=~US|EU,severity!=warning`。 **按状态筛选** + 在**状态**中，从“活动”、“已抑制”或“未处理”状态中选择，以查看与所选状态匹配的警报。所有其他警报均已隐藏。 # 查看通知错误 **** 本文档主题专为支持 **Grafana 9.x 版本**的 Grafana 工作区而设计。 对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。 对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。 查看通知错误，了解发送失败或未收到通知的原因。 **注意** 只有 Grafana Alertmanager 支持此功能。 **查看通知错误** 1. 在 Grafana 菜单中，单击**警报**（铃铛）图标以打开列出现有警报的“警报”页面。 1. 选择**联系点**，以查看现有联系点列表。 如果有任何联系点出现故障，屏幕右上角会显示一条消息，提醒用户注意存在错误以及错误数。 1. 单击某个联系点，查看该联系点的错误详情。 如果将鼠标悬停在错误图标上，则会显示错误详情。 如果联系点有多个集成，您会看到列出的每个集成的所有错误。 1. 在“运行状况”列中，检查通知的状态。 可能是“正常”、“未尝试”或“错误”。