Skip to main content
通过 Postman 的 Webhook 集成「Post monitoring results」，将 Postman Monitor 每次运行的结果推送到 Flashduty On-call。每个 Monitor 对应一条 Flashduty 告警：运行出现失败的测试或请求错误时触发，之后某次运行全部通过时恢复。

​
在 Flashduty On-call

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

​
使用专属集成

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

​
使用共享集成

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

​
在 Postman 中配置

1

添加 Webhook 集成

  1. 登录 Postman，为要监控的集合（Collection）创建 Monitor（工作区的 Monitors 面板 → Create）。Postman 免费版最短支持每小时运行一次
  2. 打开 Integrations，选择 Custom Webhooks，进入 Connections 标签页，在 Post monitoring results 一项右侧点击 Add integration
  3. 填写 Nickname，选择包含目标 Monitor 的工作区（Workspace），再选择需要推送结果的 Monitor
  4. 将 Flashduty 集成的完整推送地址粘贴到 Webhook URL，地址中需包含 integration_key
  5. 选择通知方式：
    • Notify for all completed monitor runs（请选择这一项）：每次运行都推送。失败的运行触发告警，通过的运行恢复告警
    • Notify for 3 failures and then first success：Postman 只按选项名称描述其行为，没有说明具体推送哪些运行，通过的运行是否推送、何时推送无法保证，告警可能无法恢复，也会晚触发
Postman 的推送里没有状态字段，Flashduty 依靠通过的运行来恢复告警，所以只有选择 Notify for all completed monitor runs，恢复才能可靠生效。 6. 点击 Add Integration每个 Monitor 需要单独添加一条 Webhook 集成。
2

验证

  1. 让 Monitor 中的一个测试失败（例如修改断言），然后在 Monitor 页面点击 Run Now，或等待下一次定时运行
  2. 在 Flashduty 中确认收到活动告警
  3. 还原断言，再次运行 Monitor，确认原告警恢复
Postman 文档未提供 Webhook 的测试推送功能。

​
Alert Key

Flashduty 使用 monitor_uid（Monitor 的唯一 ID）作为 Alert Key，同一个 Monitor 的失败和恢复推送使用同一个 Alert Key。修改 Monitor 名称、测试数量、耗时等字段不会改变 Alert Key。缺少 monitor_uid 的请求会被拒绝。

​
状态和告警等级

Postman 的推送内容里没有状态字段，Flashduty 根据 metrics 中的计数判断本次运行的结果： metrics 对象缺失，或 errorCount、failedTestCount 任一缺失、不是非负整数的请求会被拒绝，不会被当作通过的运行。没有活动告警的 Monitor 收到通过的运行时，不会创建新告警。

​
标签

触发推送的用户信息（user_id、user_name）不会写入标签。

​
排查问题

  • Flashduty 返回参数错误：确认 URL 完整且包含 integration_key
  • 告警没有恢复：确认 Monitor 之后有一次所有测试都通过且没有请求错误的运行；请确认通知方式选择的是 Notify for all completed monitor runs
  • 没有收到推送：确认 Webhook 集成选择的是正确的工作区和 Monitor；每个 Monitor 需单独添加
更多字段含义请参阅 Postman Webhooks。