通过 Echobell 将 Grafana 告警转为来电通知

使用 Echobell Webhook 为 Grafana 告警配置来电通知：逐步设置、最佳实践与故障排查。

通过 Echobell 将 Grafana 告警转为来电通知

邮件和聊天通知在故障发生时很容易被忽略。对于关键告警，Echobell 可以将 Grafana 的 Webhook 通知转换为真实的来电，并支持升级和重试。本文带你完成完整的配置过程。

相关文档：

前提条件

  1. 拥有 Echobell 账户、活跃频道和 Webhook URL（参见 /docs/webhook）
  2. 具有 Grafana 管理员权限
  3. 已配置至少一条告警规则

配置步骤

第一步——在 Grafana 创建 Webhook 联系点

  1. 进入 Alerting → Contact points
  2. 点击"New contact point"，类型选择 Webhook
  3. 填写易于识别的名称，如"Echobell 来电通知"

第二步——填入 Echobell Webhook URL

将 URL 设置为频道的 Webhook 地址：

https://hook.echobell.one/t/xxxxxxxx

从 Echobell 频道设置中复制该 URL（详见 /docs/webhook）。请将其视为密钥妥善保管，泄露时及时更换。

第三步——测试集成

在 Grafana 中点击 Test 发送测试告警。几秒内你应该就会收到 Echobell 来电。

第四步——绑定到通知策略

  1. 进入 Alerting → Notification policies
  2. 创建或编辑针对关键告警的策略
  3. 添加"Echobell 来电通知"联系点

Grafana 将把匹配的告警路由到 Echobell。

最佳实践

  • 来电仅用于高优先级告警；低严重程度走聊天或邮件
  • 在 Echobell 中配置重试和超时，控制告警疲劳（参见 /docs/notification）
  • 设置升级机制，第一个电话未接时自动通知队友
  • 配置安静时段，避免低紧急度告警在夜间打扰
  • 与值班团队共享频道，保持排班信息最新

进阶选项

  • 与团队成员共享频道，扩大覆盖范围
  • 使用模板为不同告警类型定制语音内容
  • 配置重试次数和升级路径
  • 设置备用联系人以增强可靠性

完整参考：/docs/developer/grafana

故障排查

  • 未收到来电：确认通知策略已路由到 Echobell 联系点
  • Webhook 返回 4xx：验证 Webhook URL 是否正确，频道是否处于活跃状态
  • 来电过多：缩小策略范围或降低告警严重级别阈值
  • 来电过少：提高严重级别，或添加标签过滤器确保关键告警能匹配到策略

相关资源