4. 告警通知渠道：Contact Point 配置与通知模板语法

Contact Point（联系人点）是 Grafana 告警引擎将告警实例发送到外部系统的出口。每个 Contact Point 绑定一个或多个通知渠道（Integration），并可通过通知模板（Notification Template）自定义消息载荷。本章覆盖 Email、Slack、PagerDuty、Webhook 四种核心渠道的配置要点，以及 Go 模板语法在告警通知中的实战用法。

4.1 Contact Point 核心概念

4.2 渠道配置详解

4.2.1 Email

Grafana 使用内置 SMTP 客户端发送告警邮件。配置路径：Alerting → Contact Points → New Contact Point → Email。

4.2.2 Slack

通过 Slack Incoming Webhook 发送消息。配置时需提供 Webhook URL，Grafana 自动构造消息块（Blocks）或附件（Attachments）。

4.2.3 PagerDuty

使用 PagerDuty Events API v2 创建事件。需要提供 Integration Key（路由键）。

4.2.4 Webhook

最灵活的渠道，支持自定义 HTTP 请求方法与载荷。适用于自建通知系统、工单系统或 ChatOps 机器人。

4.3 通知模板（Notification Template）语法

Grafana 使用 Go text/template 引擎，所有模板上下文（Context）通过 . 传递。核心数据对象为 Alert 结构体，包含告警名称、标签、注解、时间戳、静默/抑制状态等字段。

4.3.1 常用模板变量

4.3.2 模板函数与管道

Grafana 内置了丰富的模板函数，常用函数如下：

4.3.3 模板示例：Slack 消息自定义

{{ define "slack_custom" }}
{
  "blocks": [
    {
      "type": "header",
      "text": {
        "type": "plain_text",
        "text": "{{ .Subject }}"
      }
    },
    {
      "type": "section",
      "fields": [
        {
          "type": "mrkdwn",
          "text": "*Severity:*\n{{ .Labels.severity | upper }}"
        },
        {
          "type": "mrkdwn",
          "text": "*Team:*\n{{ .Labels.team | default "platform" }}"
        }
      ]
    },
    {
      "type": "section",
      "text": {
        "type": "mrkdwn",
        "text": "{{ .Annotations.summary }}"
      }
    },
    {
      "type": "actions",
      "elements": [
        {
          "type": "button",
          "text": {
            "type": "plain_text",
            "text": "View Runbook"
          },
          "url": "{{ .Annotations.runbook_url }}"
        }
      ]
    }
  ]
}
{{ end }}

4.4 通知模板与 Contact Point 绑定流程

4.5 模板管理最佳实践

• 模板复用：在 Grafana 的 Alerting → Contact Points → Templates 中创建全局模板，使用 {{ define "template_name" }} 定义，在 Contact Point 中通过 {{ template "template_name" . }} 引用。
• 版本控制：将模板代码存储在 Git 仓库中，通过 Grafana Provisioning 的 alerting.templates 配置自动同步。
• 测试验证：使用 grafana-cli alerting test-template 命令或 Grafana API POST /api/v1/alert-templates/test 在部署前验证模板输出。
• 避免敏感信息：不要在模板中硬编码 、密码等敏感信息，应通过环境变量或 Secret 管理工具注入。

4.6 多渠道对比与选型建议