跳转到主要内容
通过 Calibre 站点的 Webhook,把性能预算(Performance Budget)的状态变化同步到 Flashduty On-call。每个预算对应一条 Flashduty 告警:预算进入 At risk(有风险)或 Exceeded(超标)时触发,状态回到 Met(达标)时关闭这条告警。

在 Flashduty On-call

您可通过以下两种方式获取集成推送地址,任选其一即可。

使用专属集成

  1. 进入 Flashduty 控制台,选择 协作空间,打开一个协作空间
  2. 选择 配置 → 集成数据 → 专属集成,点击 新增集成
  3. 选择 Calibre,点击 保存
  4. 打开生成的集成卡片,复制 推送地址

使用共享集成

  1. 进入 Flashduty 控制台,选择 集成中心 → 告警事件
  2. 选择 Calibre,填写集成名称
  3. 配置默认路由并选择协作空间;创建后可在 路由 中增加更多规则
  4. 点击 保存,复制生成的 推送地址

在 Calibre 中配置

1

在 Calibre 中添加 Webhook

操作路径:Calibre › Synthetic › Settings › Integrations › Add a webhook先在 Calibre 中选择要接入的站点。点击 Save。
2

在 Calibre 中确认已创建性能预算

操作路径:Calibre › Synthetic › Budgets为需要监控的指标(如 LCP)创建预算。没有预算就不会有预算通知。
3

验证生命周期

Calibre 的 Webhook 没有测试按钮,请用真实预算验证:让某个预算的指标超过预算值,确认 Flashduty 收到活动告警;指标回到预算以内后,确认原告警恢复。预算通知在整体状态发生持续变化时发送,需要等待下一次测试完成。
可以在 Synthetic → Settings → Integrations 中打开该 Webhook 设置共享密钥(Calibre 通过 Calibre-HMAC-SHA256-Signature 请求头签名)。Flashduty 不校验该签名,推送地址中的 integration_key 即是凭据,请勿公开。

推送内容

预算通知的主要字段如下,Flashduty 直接解析,无需配置模板:

Alert Key

Flashduty 使用站点标识 site_id 和预算 ID id 组合出 Alert Key。同一个预算的风险、超标和达标通知使用相同的 Alert Key,落在同一条告警上;不同预算或不同站点生成不同的告警。修改预算名称、状态或测量值不会改变 Alert Key。 请求中缺少 id 或 site_id 时,Flashduty 会返回参数错误,因为无法可靠地把达标通知关联到原告警。

状态和告警等级

status 为空或为其他值的预算通知会被拒绝,避免把无法判断状态的请求写入错误的告警生命周期。

常见问题

Calibre 默认不发送预算通知,需要在站点 Webhook 中勾选 Budget notifications。预算通知只在预算的整体状态发生持续变化时发送,状态没有变化就不会再次推送。
不会。Snapshot 通知只表示一次测试完成,不是告警,Flashduty 收到后直接返回成功。

排查问题

  • Calibre 推送失败:确认 Payload URL 是完整的推送地址,且包含 integration_key
  • Flashduty 返回参数错误:确认请求为预算通知,且 id、site_id、status 非空
  • 告警没有恢复:确认恢复通知的 id 与 site_id 和触发通知相同
字段说明请参阅 Calibre 官方文档 Webhooks 和 Create a Performance Budget。