集成
连接 Bugsnag
Bugsnag 项目中未解决的错误会显示在项目中,新错误会立即显示。
在哪里连接
在 VentionDesk 中的运维 › 来源 › “添加来源”,类别选择错误,然后选择Bugsnag。只有所有者可以连接、编辑和移除。
分步说明
- Bugsnag 令牌没有作用范围:令牌能看到其账户能看到的一切。因此请创建一个独立的协作者账户“VentionDesk”,只能看到客户的项目,且没有管理员权限。
- 使用该账户登录,在 Settings › My account › “Personal auth tokens”下创建令牌。作为协作者,VentionDesk 用它只读取(Data Access API)。
- 如需使用“已解决”按钮,该账户在 Bugsnag 中必须是该项目的 Organization Administrator 或 Project Owner——只有这样 Bugsnag 才接受“fix”操作。VentionDesk 会先在 Bugsnag 中将错误标记为已解决,然后才在自己这边标记。没有此权限时,VentionDesk 只读取:“已解决”会让错误保持未解决,并告知缺少哪项权限。
- 在这里填写令牌;VentionDesk 通过查询项目来检查令牌。
- 保存后,VentionDesk 会在“运维” › “来源” › Bugsnag 下显示一个内含密钥的 Webhook 地址。请在项目的 Project settings › “Integrations and email” › “Webhook”中填写该地址,并选择“New errors”、“Frequently occurring errors”和“Reopened errors”。
- VentionDesk 每 15 分钟获取一次已分配项目中未解决的错误——比 Sentry 少,因为 Bugsnag 严格限制每个账户的请求数。然后在项目页面的“分析” › “关联错误来源”中,将每个项目与其在服务商处的项目对应起来。
- 对于每个错误,VentionDesk 只获取标识、缩短的标题(其中的电子邮件和 IP 地址会被遮盖)、级别、状态、事件数和受影响用户数、首次和最近出现时间以及指向服务商的链接。堆栈跟踪、事件、用户数据、IP 地址和请求保留在服务商处,也不会从 Webhook 中存储。
对话框需要填写的内容
| 字段 | 填写内容 | 来源 |
|---|---|---|
| Personal auth token | 必填 | 机密 | Bugsnag › Settings › My account › “Personal auth tokens” › “Generate new token”。 |
| 组织 ID | 可选 | 仅当您的账户属于多个组织时需要(24 个字符,0–9 和 a–f)。留空:使用该账户的第一个组织。 |
| 自动创建任务 | 可选 | “an”(默认,开启)或“aus”(关闭)。开启时:达到阈值或级别为“fatal”的错误会为 Claude 创建一次任务。 |
| 阈值(事件数) | 可选 | 事件数达到该值时创建任务。留空则为 10。 |
VentionDesk 加密存储机密信息,且不会再次显示。只有在服务商确认访问后才会保存;编辑连接时如果机密字段留空,则保留原有值。