跳转到主要内容
通过配置一个 HTTP 端点,Flashduty 会按照您设定的周期主动发起请求,将响应解析为符合 标准告警事件 协议的事件并写入告警通道。整个过程不需要您的系统具备推送能力,只要能对外暴露一个可读的告警查询接口即可。
拉取类集成仅专业版可用,其他版本不会执行拉取(含手动触发)。
HTTP 拉取适合 无法主动 webhook、接口本身就是查询型 或 不希望对告警源做改造 的场景。如果您的系统已经支持 webhook 推送,优先使用对应的推送式集成(Prometheus、Zabbix 等),延迟更低、资源开销更小。

操作步骤

在 Flashduty

当您不需要根据告警内容路由到不同的协作空间时,优先选择此方式,更简单。
  1. 进入 Flashduty 控制台,选择 协作空间,进入某个空间的详情页面。
  2. 选择 配置 → 集成数据 → 专属集成,点击 新增集成,进入添加集成页面。
  3. 选择 HTTP Pull 集成。
  4. 按下文步骤填写表单,点击 保存。
当您需要根据告警事件的 Payload 信息,将告警路由到不同协作空间时,优先选择此方式。
  1. 进入 Flashduty 控制台,选择 集成中心 ⇒ 告警事件,进入集成选择页面。
  2. 选择 HTTP Pull 集成,并填写 集成名称。
  3. 配置 默认路由,选择对应的协作空间(集成创建后可前往 路由 配置更多路由规则)。
  4. 按下文步骤填写表单,点击 保存 完成。

在 Flashduty 中配置

HTTP Pull 在 Flashduty 内完成全部配置,不需要在上游系统中做任何设置,只需保证上游接口可被 Flashduty 访问。
1

在 Flashduty 中配置 HTTP 请求

操作路径:集成中心 › 告警事件 › HTTP Pull › HTTP 请求(专属集成:协作空间 › 配置 › 集成数据 › 专属集成 › 新增集成 › HTTP Pull)
2

在 Flashduty 中配置分页(接口分页返回时)

操作路径:集成中心 › 告警事件 › HTTP Pull › 分页配置(专属集成:协作空间 › 配置 › 集成数据 › 专属集成 › 新增集成 › HTTP Pull)很多查询型接口在单次返回时会做条数限制,需要按游标分页才能拿到完整数据。Flashduty 支持基于游标的分页:每次响应中提取下一页游标,注入到下一次请求里,直到响应中不再返回游标或达到上限。接口一次返回全部数据时,保持 无分页 即可,跳过本步。
3

在 Flashduty 中配置严重程度映射

操作路径:集成中心 › 告警事件 › HTTP Pull › 高级配置 › 严重程度映射(专属集成:协作空间 › 配置 › 集成数据 › 专属集成 › 新增集成 › HTTP Pull)外部系统的告警级别字段名称、取值往往不一致,Flashduty 通过 严重程度映射 将外部值翻译为标准的 Critical / Warning / Info。
  • 系统读取响应中的 event_status 字段值(标准告警事件协议中的告警级别字段),按映射表查找对应的 Flashduty 严重程度。
  • 默认映射:P1 → Critical、P2 → Warning、P3 → Info。您可以删除默认项、新增任意条目。
  • 未命中兜底:如果响应中的 event_status 没有命中映射表中的任何 Key,将统一降级为 Warning。
4

保存并确认收到事件

操作路径:集成中心 › 告警事件 › HTTP Pull › 保存(专属集成:协作空间 › 配置 › 集成数据 › 专属集成 › 新增集成 › HTTP Pull)点击 保存。共享集成还须配置 默认路由(见下文「默认路由」),否则拉取到的事件会被丢弃。保存后 Flashduty 按 拉取周期(最小 30 秒)发起请求,一个周期后回到集成列表,集成显示 最新事件时间,说明拉取成功。

响应格式

接口响应必须符合 Flashduty 的 标准告警事件 协议(response_mode = standard),核心字段包括 event_status、title_rule、alert_key、description、labels 等。请直接参考标准告警事件文档了解每个字段的语义与长度限制。 启用分页时,您的响应需要在标准事件载荷之外,额外暴露一个用于提取下一页游标的字段,路径由 游标路径 指定。常见的形态如下:

默认路由

新增「共享集成」(即在 集成中心 ⇒ 告警事件 中创建)时,必须配置默认路由,否则新拉取到的事件将被丢弃。集成创建后可在 路由 中追加更细粒度的规则。 「专属集成」(在某个协作空间的 配置 → 集成数据 → 专属集成 中创建)会自动绑定到所在空间,不需要单独配置默认路由。

模板变量

URL 与请求体支持 Go 模板语法。当前仅有 一个 内置变量: 使用规则:
  • 启用游标分页时,必须在 URL(注入位置为 URL Query)或 Body(注入位置为 Body)中至少出现一次 {{.PageValue}},否则下一页游标无法生效。
  • GET 请求自动将注入位置锁定为 URL Query,但仍需您自行决定把变量写在 URL 的哪个查询参数上,或直接使用 参数名 让系统拼接。
  • 不启用分页(无分页 模式)时,该变量始终渲染为空字符串。