Sentry 集成指引
title: "Sentry告警事件"
description: "通过 webhook 的方式同步 Sentry 告警事件到快猫星云,实现告警事件自动化降噪处理"
date: "2024-07-05T10:00:00+08:00"
url: "https://docs.flashcat.cloud/zh/flashduty/Sentry-integration-guide"
通过 webhook 的方式同步 Sentry 告警事件到快猫星云,实现告警事件自动化降噪处理。
在 Flashduty
您可通过以下2种方式,获取一个集成推送地址,任选其一即可。
使用专属集成
当您不需要将告警事件路由到不同的协作空间,优先选择此方式,更简单。
展开
- 进入 Flashduty 控制台,选择 协作空间,进入某个空间的详情页面
- 选择 集成数据 tab,点击 添加一个集成,进入添加集成页面
- 选择 Sentry 集成,点击 保存,生成卡片。
- 点击生成的卡片,可以查看到 推送地址,复制备用,完成。
使用共享集成
当您需要根据告警事件的 Payload 信息,将告警路由到不同的协作空间,优先选择此方式。
展开
- 进入 Flashduty 控制台,选择 集成中心=>告警事件,进入集成选择页面。
- 选择 Sentry 集成:
- 集成名称:为当前集成定义一个名称。
- 点击 保存 后,复制当前页面的新生成的 推送地址 备用。
- 点击 创建路由,为集成配置路由规则。您可以按条件匹配不同的告警到不同的协作空间,也可以直接设置默认协作空间作为兜底,后续再按需调整。
- 完成。
在 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
- 登录 Sentry 管理控制台。
- 在左侧导航栏,找到 Settings => Custom Integrations。
- 点击 Create New Integration 并选择 Internal Integration。
- 在编辑页面。Name 处填写 FlashDuty,WebhookURL 处复制写入集成的推送地址。
- 开启 Alert Rule Action,参考如下图配置:
- 在 PERMISSIONS 配置中为 Issue & Event 配置 Read 权限 。
- 在 WEBHOOKS 配置中,勾选 issue ,请不要勾选 error 和 comment。
- 配置完成后,点击 Save Changes 完成创建。
关于 WEBHOOKS 配置的特殊说明:
- 勾选 issue 后 FlashDuty 可以接收 issue 的 resolved 事件,即在 issue 列表中对某个问题进行手动触发 resolved 时,我们会自动恢复 FlashDuty 中关联的故障。
- 不支持 issue 的其他事件,如 create、assigned、archived 和 unresolved。
- 如果同时勾选了 error 和 comment ,FlashDuty 并不会接收和处理这类事件。
步骤2:在 Alerts 中使用 FlashDuty Integration
- 在左侧导航栏,找到 Alerts => Create Alert。
- 选择要创建的 Alert 类型,如 Issue 。
触发条件请按需配置。
在 THEN perform these actions 处 Add action 并选择 Send a notification via。
- 通知渠道选择上面添加的 FlashDuty。
- 配置好其他选项后,点击 Save Rule 保存即可。
三、状态对照
Sentry | 快猫星云 | 状态 |
---|---|---|
critical | Critical | 严重 |
warning | Warning | 警告 |
triggered | Warning | 警告 |
resolved | Ok | 恢复 |
修改于 3 个月前