Sentry 集成指引

一、前置说明

Sentry 提供了两类告警机制：Issue Alerts 和 Metric Alerts。Issue Alerts 支持通过 Integrations 中的 WebHooks 实现通知功能，而 Metric Alerts 则限定于使用 Internal Integration 进行告警通知。值得注意的是 Internal Integration 不仅适用于 Metric Alerts，也兼容 Issue Alerts。鉴于 Internal Integration 的广泛适用性，我们决定统一采用这一方式，不再单独依赖 WebHooks，以此来简化告警通知的配置。

二、Sentry 告警推送配置

步骤1：添加 FlashDuty Custom Integrations

1. 登录 Sentry 管理控制台。
2. 在左侧导航栏，找到 Settings => Custom Integrations。
3. 点击 Create New Integration 并选择 Internal Integration。
4. 在编辑页面。Name 处填写 FlashDuty，WebhookURL 处复制写入集成的推送地址。
5. 开启 Alert Rule Action，参考如下图配置：

5. 在 PERMISSIONS 配置中为 Issue & Event 配置 Read 权限 。
6. 在 WEBHOOKS 配置中，勾选 issue ，请不要勾选 error 和 comment。
7. 配置完成后，点击 Save Changes 完成创建。

关于 WEBHOOKS 配置的特殊说明：

1. 勾选 issue 后 FlashDuty 可以接收 issue 的 resolved 事件，即在 issue 列表中对某个问题进行手动触发 resolved 时，我们会自动恢复 FlashDuty 中关联的故障。
2. 不支持 issue 的其他事件，如 create、assigned、archived 和 unresolved。
3. 如果同时勾选了 error 和 comment ，FlashDuty 并不会接收和处理这类事件。

步骤2：在 Alerts 中使用 FlashDuty Integration

1. 在左侧导航栏，找到 Alerts => Create Alert。
2. 选择要创建的 Alert 类型，如 Issue 。

3. 触发条件请按需配置。

4. 在 THEN perform these actions 处 Add action 并选择 Send a notification via。

5. 通知渠道选择上面添加的 FlashDuty。

6. 配置好其他选项后，点击 Save Rule 保存即可。

三、状态对照