Grafana Slack告警模板无法渲染traces注解问题排查

1. 检查Slack通知渠道的模板引用 #

这是最常见的原因：你编写了自定义的slack.text模板，但Grafana的Slack通知渠道仍在使用默认模板，没有调用你自定义的模板。

解决步骤：

• 进入Grafana的「Alerting」→「Notification channels」，找到你的Slack渠道
• 在「Message」输入框中，替换默认内容为：{{ template "slack.text" . }}
• 保存配置后重新触发告警测试

2. 调整模板中注解的引用方式 #

部分Grafana版本中，直接使用.Annotations.traces可能无法正确解析，尝试改用索引方式引用：

修改Slack模板中的对应行：

*Go to traces*: {{ index .Annotations "traces" }}

3. 移除不必要的注解长度判断 #

你的模板中使用了{{ if gt (len .Annotations ) 0 }}来包裹注解内容，虽然逻辑上没问题，但可以尝试移除这个判断，直接输出所有注解相关内容，避免因长度计算异常导致内容被隐藏：

修改后的slack.text模板片段：

{{- define "slack.text" -}}
{{- range .Alerts -}}
*Description*: {{ .Annotations.description }}
*Instance*:
{{ range .Labels.SortedPairs }}{{ if or (eq .Name "env") (eq .Name "instance") (eq .Name "cluster") (eq .Name "http_host")}}• {{ .Name }}: `{{ .Value }}`
{{ end }}{{ end }}
*Silence alert*: {{ .SilenceURL }}
*Go to dashboard*: {{ .DashboardURL }}
*Go to panel directly*: {{ .PanelURL }}
{{ if .Annotations.traces }}*Go to traces*: {{ .Annotations.traces }}{{ end }}
{{ end }}
{{ end }}

4. 验证Terraform配置的完整性 #

虽然你提到UI中能看到traces注解，但还是要确认Terraform代码的闭合性：你的告警规则配置片段末尾缺少了}来闭合annotations块、rule块以及整个grafana_rule_group资源块，确保代码完整后重新应用配置：

补充完整后的示例：

resource "grafana_rule_group" "prometheus_metrics_rule_group" {
  name             = "Prometheus metrics"
  folder_uid       = grafana_folder.prometheus_rule_folder.uid
  interval_seconds = 300
  org_id           = 1
  rule {
    name           = "5xx HTTP server side errors"
    for            = "2m"
    condition      = "B"
    no_data_state  = "OK"
    exec_err_state = "Alerting"
    annotations = {
      __dashboardUid__ = grafana_dashboard.prometheus_http_errors.uid
      __panelId__      = "1"
      "description" = "{{ with $values }} 5xx server side HTTP errors have exceeded 10% of all requests within the last 10 minutes {{ end }}"
      "traces" = "{{ graphLink \"{\"expr\": \"up\", \"datasource\": \"Tempo\"}\" }}"
    }
  }
}

内容的提问来源于stack exchange，提问作者DisplayName