跳转到主要内容
通过 JumpCloud 的 Webhook 通知渠道,将 Insights 规则产生的告警同步到 Flashduty On-call。每条 JumpCloud 告警对应一条 Flashduty 告警:告警产生时触发,在 JumpCloud 中被处理(Resolved)或自动恢复(Auto-Resolved)时恢复。

在 Flashduty On-call

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

使用专属集成

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

使用共享集成

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

在 JumpCloud 中配置

1

在 JumpCloud 中创建 Webhook 通知渠道

操作路径:JumpCloud Admin Portal › Settings › Notification Channels › Webhooks › +Add填写 URL 和认证后,保存前可以点击表单里的 Test Webhook:JumpCloud 用它检查渠道配置,并在弹窗中显示模拟的请求和响应,JumpCloud 文档未说明请求内容,它不会产生真实告警。然后点击 Save。需使用管理员账号。如果保存时 Webhook Status 选了 Disabled,在 Webhooks 页面点击该渠道右侧的省略号(更多菜单),选择 Enable 启用,渠道才会推送。
2

在 Insights 规则中选择该渠道

操作路径:JumpCloud Admin Portal › Monitoring › Alerts › Rules › +Rule › Insights › Directory Insights Event Monitoring(或打开已有规则)Alert Resolution 和 Alert Acknowledgement 仅在 Generate Alerts 与 Send Notifications 都开启时显示。保存规则。
3

在 JumpCloud 中触发告警并确认

操作路径:JumpCloud Admin Portal › Monitoring › Alerts规则条件满足后,JumpCloud 生成告警并向渠道推送。在 Flashduty 中确认出现一条活动告警,再到上述 Alerts 页面找到已触发的告警,把它标记为 Resolved,确认 Flashduty 告警恢复。创建渠道时的 Test Webhook 只检查渠道配置,不等于真实告警,请以真实告警验证。Flashduty 按真实告警的格式解析请求,缺少 alert_id 的请求会返回 400,如果测试请求因此失败,不影响真实告警。

Alert Key

Flashduty 用 alert_id(JumpCloud 告警的 ID)生成 Alert Key。同一条 JumpCloud 告警在每次状态变化(Open、Acknowledged、Resolved、Auto-Resolved)时推送的都是同一个 alert_id,所以触发和恢复落在同一条 Flashduty 告警上。标题、优先级、描述、更新时间等字段变化不会改变 Alert Key。缺少 alert_id 的请求会被拒绝。 JumpCloud 文档规定同一条告警在阈值达到后的新事件会更新已有告警,这些更新都归入同一条 Flashduty 告警。

状态和告警等级

恢复事件保留该告警最后一次推送的等级。

标签

告警标题取自 alert_title,描述取自 description。

排查问题

  • Flashduty 返回参数错误:确认 URL 完整且包含 integration_key,并确认请求体是 JSON
  • 告警没有恢复:确认规则中勾选了 Alert Resolution,并且渠道处于启用状态
  • 收不到通知:确认 Insights 规则选择了该 Webhook 渠道,并且触发事件发生在规则的监控窗口内
更多字段含义请参阅 JumpCloud Webhook 通知渠道 和 创建 Insights 规则。