配置标签

注意
此功能仅适用于Grafana Cloud。

标签是Grafana OnCall中的一个强大功能，可以帮助您对集成和警报组进行分类和组织。本指南将指导您如何为集成分配标签、通过标签过滤集成以及探索与警报组标签相关的各种功能。

集成与标签

您可以将标签分配给集成，以便根据特定标准进行管理和过滤。您可能会发现根据服务、区域或其他自定义属性来组织集成很有用。

为集成分配标签

转到“集成”选项卡，并从列表中选择一个集成。
单击集成名称旁边的三个点，并选择“集成设置”。
在“集成标签”部分中单击“添加”按钮。您可以使用旁边的X按钮删除标签。
为标签定义键值对，您可以选择现有列表中的选项或在字段中输入新内容。按回车键或返回键接受。
完成后单击“保存”。

通过标签过滤集成

转到“集成”选项卡。
找到“搜索或过滤结果…”下拉菜单，并选择“标签”。
开始键入以找到建议，并选择您想要过滤的键值对。

根据分配给集成的标签自动将标签分配给每个警报组。

警报组标签

警报组标签提供了更细致的控制。使用警报组标签，您可以

为警报组分配标签。
通过标签过滤警报组。
自定义警报组表格。
在Webhooks中传递标签。

将标签分配给警报组

可以为每个集成配置警报组标签。要查找警报组标签设置

导航到集成选项卡。
从启用集成的列表中选择一个集成。
点击集成名称旁边的三个点。
选择集成设置。您可以在映射部分配置警报组标签映射。

最多可以将15个标签分配给警报组。如果有超过15个标签，则只有前15个将被分配。

动态标签

动态标签允许您将任意标签分配给警报组。动态标签使用Jinja从警报负载中提取值，键保持静态。这些标签将不会附加到集成。

在集成设置选项卡中，导航到动态标签。
点击添加标签按钮。

添加动态标签

从下拉列表中选择或创建一个键。
输入一个模板，用于从警报负载中解析给定键的值。

为了说明动态标签功能，让我们考虑一个例子，其中创建了一个具有severity键和用于解析该键值的模板的动态标签

{{ payload.get("severity) }}

创建的动态标签：

收到了两个警报，并分组到两个不同的警报组

警报 1

{
  "title": "critical alert",
  "severity": "critical"
}

警报 2

{
  "title": "warning alert",
  "severity": "warning"
}

结果

第一个警报组将有一个标签：severity: critical。
第二个警报组将有一个标签：severity: warning。

多标签提取模板

此功能允许用户使用单个模板从警报负载中提取和修改多个标签。它支持动态值和动态键，模板应生成有效的JSON对象。

考虑以下示例，该示例演示了从Grafana警报负载中提取标签

传入负载

{
  ...
  "commonLabels": {
    "job": "node",
    "severity": "critical",
    "alertname": "InstanceDown"
  },
  ...
}

解析它的模板

{{ payload.commonLabels | tojson }}

结果，将job、severity和alertname标签分配给警报组

一个高级示例展示了使用Grafana警报负载从警报负载的各个字段中提取标签

{%- set labels = {} -%}
{# add several labels #}
{%- set labels = dict(labels, **payload.commonLabels) -%}
{# add one label #}
{%- set labels = dict(labels, **{"status": payload.status}) -%}
{# add label not from payload #}
{%- set labels = dict(labels, **{"service": "oncall"}) -%}
{# dump labels dict to json string, so OnCall can parse it #}
{{ labels | tojson }}