Prometheus 集成

Prometheus + Alertmanager 是广泛使用的开源监控与告警体系。将 Alertmanager 集成到 Echobell 后，当告警规则触发时，你可以立即在手机上收到通知（支持“时间敏感”或“来电式”提醒）。

准备

一个 Echobell 账号，并已创建至少一个频道
已运行的 Prometheus 与 Alertmanager
可编辑 Alertmanager 配置（alertmanager.yml）的权限

步骤概览

创建 Echobell 频道
配置通知模板（可选配置链接模板）
选择集成方式：
- Webhook（推荐）：Alertmanager webhook 接收器
- 邮箱（可选）：Alertmanager 邮件接收器
创建/更新告警规则
测试与优化

详细步骤

1) 创建 Echobell 频道

打开 Echobell App
新建频道（例如「Prometheus Alerts」）
选择易识别的颜色

2) 配置通知模板

Alertmanager 的 Webhook 负载包含 status、commonLabels、commonAnnotations、externalURL 以及 alerts 数组等字段。可以在 Echobell 模板中直接引用。

建议模板：

标题模板：

{{commonLabels.alertname}} - {{status}}

正文模板：

🔔 告警: {{commonLabels.alertname}}
📊 严重级别: {{commonLabels.severity}}
🖥️ 实例: {{alerts[0].labels["instance"]}}
⏰ 开始时间: {{alerts[0].startsAt}}
ℹ️ 摘要: {{commonAnnotations.summary}}
🧾 描述: {{commonAnnotations.description}}

可选链接模板（高级设置）：

{{alerts[0].generatorURL || externalURL}}

这会在记录中显示指向相关图表/看板的链接；若没有 generatorURL，则回退到 externalURL。

3) 方式 A — Webhook（推荐）

在 Echobell 频道的触发器里复制 Webhook URL
在 Alertmanager 中新增 webhook 接收器，指向该 URL

alertmanager.yml 最小示例：

route:
  receiver: echobell-webhook
 
receivers:
  - name: echobell-webhook
    webhook_configs:
      - url: "https://hook.echobell.one/t/REPLACE_WITH_YOUR_TOKEN"
        send_resolved: true
        http_config:
          follow_redirects: true

说明：

send_resolved: true 表示在告警恢复时也会发送通知
Echobell 直接解析 JSON 体，上述模板可正确渲染

3 可选) 方式 B — 邮箱

如需使用邮箱，在 Alertmanager 中配置 email 接收器，并发送到频道绑定的邮箱地址。

在 Echobell 中复制频道邮箱地址（触发器处）
在 Alertmanager 中配置邮箱接收器并使用简洁模板

示例：

receivers:
  - name: echobell-email
    email_configs:
      - to: "粘贴频道邮箱地址"
        send_resolved: true
        subject: "{{ .CommonLabels.alertname }} - {{ .Status }}"
        html: |
          <p><strong>摘要：</strong> {{ .CommonAnnotations.summary }}</p>
          <p>{{ .CommonAnnotations.description }}</p>
          <p>
            <a href='{{ (index .Alerts 0).GeneratorURL }}' target='_blank' rel='noopener'>在 Prometheus 中打开</a>
          </p>

在基于邮箱触发的模板中，可使用 Echobell 自动提供的 subject、text、html 等变量。

4) 示例告警规则

groups:
  - name: example
    rules:
      - alert: HighCPU
        expr: avg(rate(process_cpu_seconds_total[5m])) > 0.8
        for: 2m
        labels:
          severity: critical
        annotations:
          summary: "CPU 使用率过高"
          description: "CPU 已超过 80% 持续 2 分钟"