已解决：实时服务器健康监控：Grafana 到 Telegram 集成

Source: Dev.to

为什么这很重要

作为一名 DevOps 工程师，你了解其中的流程：时刻保持警惕、不断收到电子邮件警报、处理复杂的仪表盘，以及偶尔出现的“用户报告”事件。这种被动的做法：

• 增加停机时间并损害声誉。
• 产生警报疲劳。
• 在你可能永远不会使用的 SaaS 功能上浪费预算。

想象一下，您可以通过熟悉的消息应用程序即时在手机上收到关键的服务器健康警报。 本教程将手把手教你构建这样的一整套工作流。

前置条件

1. Grafana – 运行中的实例（v7.0 或更高），已配置仪表盘和数据源（例如 Prometheus、Node Exporter）。
2. Telegram – 已安装桌面或移动端应用的账户。
3. Telegram Bot – 能够通过 BotFather 创建/管理机器人。
4. CLI access – 可以运行 curl 的服务器（或本地机器）。
5. 基础的服务器管理知识以及对 Grafana 告警规则创建的熟悉程度。

第 1 步 – 创建专用 Telegram 机器人

curl -s "https://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates" \
  | grep -oP '"chat":{"id":\K[^,]*'

输出将是一个或多个数字 ID：

• 私人聊天 → 你的个人聊天 ID（正数）。
• 群组聊天 → 群组聊天 ID（通常为负数，例如 -123456789）。

复制相应的 ID 以供下一步使用。

第 2 步 – 配置 Grafana 的 Telegram 通知渠道

1. 打开通知渠道

   • 在 Grafana 中，点击 Alerting（铃铛）图标 → Notification channels。

2. 添加新渠道

   • 点击 Add channel。

3. 填写设置

4. 测试渠道

   • 点击底部的 Test。你应该在 Telegram 聊天中收到 “Test notification”。
   • 如果没有收到，请检查：
     • Bot Token 和 Chat ID 是否正确。
     • Grafana 服务器能否访问 api.telegram.org（外部互联网访问）。

5. 保存 渠道。

第3步 – 创建使用 Telegram 通道的警报规则

1. 导航到仪表板 包含您想监控的指标（例如 CPU 使用率、内存、磁盘 I/O）。
2. 打开面板的警报标签（或创建新面板）。
3. 定义警报条件（例如 “当 node_cpu_seconds_total > 80 % 持续 5 分钟”）。
4. 添加通知 → 选择您刚创建的 Telegram 警报 通道。
5. 保存仪表板 – 警报规则现已生效，当条件触发时会向 Telegram 推送通知。

高级：自定义 Telegram 消息模板（Go 模板）

Grafana 允许您使用 Go 的模板语法来构建丰富的消息。示例模板：

{{ define "telegram.default.message" }}
🚨 *{{ .Title }}* 🚨
{{ if .State }}*State:* {{ .State }}{{ end }}
{{ if .Message }}*Message:* {{ .Message }}{{ end }}

*Labels:* {{ range $key, $value := .Labels }}{{ $key }}={{ $value }} {{ end }}
*Annotations:* {{ range $key, $value := .Annotations }}{{ $key }}={{ $value }} {{ end }}

{{ if .EvalMatches }}
*Metrics:* {{ range .EvalMatches }}
- {{ .Metric }} = {{ .Value }}{{ end }}
{{ end }}

[View Dashboard]({{ .RuleUrl }})
{{ end }}

• 将此 放入 Telegram 渠道的 Message Template（消息模板）字段中。
• 使用 *bold*、_italic_ 或 `code` 进行 Markdown 格式化（Telegram 只支持其子集）。

故障排查清单

回顾

通过遵循这些步骤，你现在拥有：

• 一个可以接收消息的 Telegram 机器人。
• 一个已连接到该机器人的 Grafana 通知渠道。
• 告警规则，可将实时服务器健康通知直接推送到你的移动设备。

享受更快的事件响应、降低告警疲劳，并拥有更精简的监控体系——无需昂贵的 SaaS 订阅。 🎉

Source: …

为服务器健康设置 Grafana 警报（Telegram 集成）

1. 编辑面板

1. 将鼠标悬停在需要设置警报的面板上（例如 CPU 使用率 图表）。
2. 点击 编辑 图标（铅笔）。

2. 进入警报标签页

在面板编辑器中，点击 Alert 标签（铃铛图标）。

3. 创建警报规则

1. 点击 Create Alert。
2. 填写必填字段：

4. 定义查询和条件

查询

选择数据源并编写获取指标的查询。

示例（Prometheus）：

avg(node_cpu_seconds_total{mode="idle",instance="server-x:9100"}) by (instance)

随后可以将其转换为当 100 - (AVG_IDLE_CPU_PERCENTAGE) > 80 时触发。

条件

设置警报阈值。

WHEN last() OF A IS ABOVE 80

5. 配置通知

1. 在 Send to 部分，从下拉列表中选择你的 Telegram Alerts 通道。
2. （可选）为此警报添加自定义消息——它会覆盖通道的默认模板。

6. 保存警报

点击面板编辑器右上角的 Save。

7. 为其他指标重复上述操作

为以下指标创建类似的警报：

• 内存使用率
• 磁盘空间
• 网络错误

根据实际运营需求调整阈值和消息内容。

使用 Go 模板发送丰富的 Telegram 消息

Grafana 的告警引擎支持 Go 模板，允许您编写动态、上下文丰富的通知。

示例消息模板

将以下内容添加到 Telegram 通知渠道（或单个告警规则）的 Message Template 字段中：

{{ range .Alerts }}
🔥 ALERTING 🔥
{{ .Labels.alertname }} on {{ .Labels.instance }} is FIRING!
Severity: {{ .Labels.severity | default "critical" }}
Summary: {{ .Annotations.summary }}
Description: {{ .Annotations.description }}
Value: {{ .ValueString }}
Dashboard: {{ .DashboardURL }}
Panel: {{ .PanelURL }}
{{ end }}

模板拆解

• {{ .Alerts }} – 包含本次通知中所有触发的告警的切片。
• {{ .Labels }} – 访问来自 Prometheus 指标或 Grafana 告警的标签（例如 alertname、instance、severity）。
• {{ .Annotations }} – 在告警规则中定义的自定义键‑值对（例如 summary、description）。
• {{ .ValueString }} – 触发告警的实际数值。
• {{ .DashboardURL }} / {{ .PanelURL }} – 返回 Grafana 的直接链接，便于快速调查。

提示： 在告警规则中定义注解，例如：

annotations:
  summary: "CPU 利用率过高"
  description: "检查消耗过多 CPU 的进程。考虑扩容或优化应用程序。"

常见问题与故障排除

后续步骤

• 警报分组与静音： 通过对相关警报进行分组或在维护窗口期间静音来降低噪音。
• 值班集成： 将 Telegram 警报连接到 Grafana OnCall、PagerDuty 或其他升级工具，实现 24/7 覆盖。
• 高级模板： 为消息添加更多上下文（例如，运行手册、工单系统链接）。

您已经将 Grafana 与 Telegram 集成，为团队提供即时、可操作的服务器健康通知，无需依赖电子邮件或昂贵的 SaaS 解决方案。