Skip to main content
通过 Raygun Crash Reporting 应用的 Webhook 集成，将错误通知同步到 Flashduty On-call。每个错误组（Error group）对应一条 Flashduty 告警：错误首次出现或再次出现时触发，持续出现时更新，在 Raygun 中被标记为已解决（Resolved）或忽略（Ignore）时恢复。

​
在 Flashduty On-call

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

​
使用专属集成

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

​
使用共享集成

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

​
在 Raygun 中配置

Webhook 集成按应用配置，只有 Raygun 的 Team 及更高套餐提供。多个应用需要分别配置，可以使用同一个推送地址。
1

添加 Webhook 集成

  1. 在 Raygun 中打开需要接入的应用
  2. 在左侧菜单点击 Integrations，在集成列表中点击 Webhooks
  3. 在 Setup 页签中，将 Flashduty 集成的完整推送地址粘贴到 Url 输入框，地址中需包含 integration_key
  4. 勾选 Enabled，点击 Save Changes
2

了解推送的事件

Raygun 对应用的每个错误组推送以下事件，个人通知设置（My notifications）不影响 Webhook 推送。Flashduty 的处理方式如下：错误组被标记为 Permanently Ignored 或 Active，以及分配（AssignedToUser）和评论（CommentAdded）事件不会创建告警，Flashduty 收到后直接返回成功。
3

验证

Webhooks 集成没有测试按钮，请用真实错误验证：
  1. 在接入 Raygun SDK 的应用中触发一个新错误，确认 Flashduty 收到活动告警，首次通知通常在一分钟内到达
  2. 在 Raygun 的错误组页面打开状态菜单，选择 Resolve，确认原告警恢复
请使用应用级的 Integrations → Webhooks。Raygun Alerting 中的计划级 Webhook 推送的是另一种结构（EventType: Alert），不包含错误组的状态变更，Flashduty 会返回参数错误。

​
Alert Key

Flashduty 按 Raygun 错误组聚合告警：同一错误组的新增、复发、跟进和解决通知归入同一条告警。 Alert Key 由事件中的 error.url（Raygun 中错误组页面的链接）计算，只取链接的路径，协议、域名、末尾斜杠和查询参数都不参与计算。错误消息、发生次数、影响用户数和标签变化不会改变 Alert Key。缺少 error.url 的事件会被拒绝。

​
状态和告警等级

Raygun 的错误不携带等级，Flashduty 统一使用 Warning：

​
标签

受影响用户的标识、自定义数据（customData）和操作人姓名不会写入标签。

​
排查问题

  • 集成列表中没有 Webhooks：确认账号的套餐为 Team 或更高，或处于试用期
  • Flashduty 返回参数错误：确认 URL 完整且包含 integration_key，并且配置的是应用级 Webhook，而不是 Alerting 中的 Webhook
  • 告警没有恢复：确认在 Raygun 中对错误组执行了 Resolve 或 Ignore；Permanently Ignore 和 Active 不会恢复告警
  • 错误持续发生但没有新的推送：Raygun 只在 1、5、10、30 分钟和每小时发送跟进通知，不会为每次发生都推送
更多字段含义请参阅 Raygun Webhooks。