在 Flashduty On-call
您可通过以下两种方式获取集成推送地址,任选其一即可。
使用专属集成
- 进入 Flashduty 控制台,选择 协作空间,打开一个协作空间
- 选择 配置 → 集成数据 → 专属集成,点击 新增一个集成
- 选择 Logpoint,点击 保存
- 打开生成的集成卡片,复制 推送地址
使用共享集成
- 进入 Flashduty 控制台,选择 集成中心 → 告警事件
- 选择 Logpoint,填写集成名称
- 配置默认路由并选择协作空间;创建后可在 路由 中增加更多规则
- 点击 保存,复制生成的 推送地址
在 Logpoint 中配置
Logpoint 的 HTTP Notification 没有固定报文,Body 由您填写的 Jinja 模板决定。Flashduty 只解析下面的模板。
1
打开告警规则的通知设置
在 Logpoint 中进入 Settings → Knowledge Base → Alert Rules,找到需要通知的告警规则,点击操作列的 Setup Notification 图标。也可以勾选多条规则,在 MORE 下拉菜单中选择 Setup Notifications of Selected Alert Rules。
2
配置 HTTP Notification
- 点击 HTTP Notification,选择 Notify via HTTP
- Notification Trigger 选择 Automatic(每次规则触发都发送)
- Protocol 选择 HTTPS,Base URL 填写推送地址中的域名部分,Request Type 选择 POST
- Query String 填写推送地址中
?之后的部分(包含integration_key) - 在 Body 中粘贴下面的模板
- 设置 Threshold,点击 Finish
3
验证
触发该告警规则(或等待其命中),确认 Flashduty 收到一条告警,标题为规则名称。Logpoint 的 HTTP Notification 没有测试按钮。
Alert Key
Flashduty 使用
alertrule_id({{alertrule_id}})作为 Alert Key。Logpoint 文档将其定义为“告警的 ID”。同一条规则再次触发会合并到仍未关闭的同一条告警;incident_id 每次触发都会变化,只作为标签。规则名称、风险等级和命中数量的变化不会改变 Alert Key。
状态和告警等级
Flashduty 按
risk_level({{risk_level}})映射等级:
Logpoint 文档未列出
risk_level 的完整取值,其示例使用 medium 和 high,critical 与 low 按规则编辑页的风险选项推断。
告警不会恢复
Logpoint 触发后不会发送恢复通知。请在接收该集成的协作空间中开启 超时自动关闭,建议 24 小时,并按团队处理告警的时效调整。
排查问题
- Logpoint 没有发出请求:确认通知的 Notification Trigger 为 Automatic,且规则已启用并真正命中
- Flashduty 返回参数错误:确认 Body 是有效 JSON 且保留了
alertrule_id;日志源或规则名称含双引号时会破坏 JSON - 告警标题是
Logpoint alert <id>:alert_name为空或未被渲染,检查模板中的占位符拼写 - 告警一直不关闭:属于预期,请开启超时自动关闭