---
title: 通过 Echobell 将 Grafana 告警转为来电通知
description: "使用 Echobell Webhook 为 Grafana 告警配置来电通知：逐步设置、最佳实践与故障排查。"
date: 2025-04-12
author: Nooc
authorAvatarLink: /images/avatars/nooc.webp
authorLink: https://nooc.me
---

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

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

相关文档：

- 什么是 Echobell → [/docs/what-is-echobell](/en/docs/what-is-echobell)
- 通知类型与重试 → [/docs/notification](/en/docs/notification)
- Webhooks 概览 → [/docs/webhook](/en/docs/webhook)
- Grafana 集成参考 → [/docs/developer/grafana](/en/docs/developer/grafana)

## 前提条件

1. 拥有 Echobell 账户、活跃频道和 Webhook URL（参见 [/docs/webhook](/en/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](/en/docs/webhook)）。请将其视为密钥妥善保管，泄露时及时更换。

### 第三步——测试集成

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

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

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

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

## 最佳实践

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

## 进阶选项

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

完整参考：[/docs/developer/grafana](/en/docs/developer/grafana)

## 故障排查

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

## 相关资源

- 自定义系统的 Webhook 告警 → [/blog/get-notified-with-webhook-mcp](/en/blog/get-notified-with-webhook-mcp)
- GitHub Actions 失败通知 → [/blog/github-actions-notifications](/en/blog/github-actions-notifications)
- Grafana 开发者文档 → [/docs/developer/grafana](/en/docs/developer/grafana)