在 MonstarX 中使用 Sentry

要点创建一个带读取权限范围的 Sentry 个人令牌，粘贴到“后端 → 云服务”中的 Sentry 一行。之后，MonstarX 的构建助手就能列出你的组织和项目、搜索问题并读取问题详情，所以你可以直接说“修复 Sentry 上最多的那个错误”。它只读取。

读取你 Sentry 项目中的错误和问题。

类型: 业务工具 · API 密钥
类别: 分析与监控
连接方式: API 密钥

Sentry 会记录软件中发生的错误和崩溃，并把它们归类为问题（issue）。用令牌（一串类似密码的代码，让软件可以读取你的 Sentry 账户）连接后，MonstarX 的构建助手（就是和你聊天的那个 AI）在工作时就能读取这些问题：直接查看真实用户遇到了什么错误并修复，不用你再把堆栈跟踪复制到聊天里。

这是一个业务工具：由 MonstarX 替你读取 Sentry。你构建的应用永远拿不到你的令牌。

MonstarX 能用它做什么？

MonstarX 能做什么	什么时候
列出你的组织	任何模式
列出某个组织的项目	任何模式
搜索某个组织的问题，可使用 Sentry 自己的搜索语法（如 `is:unresolved`），也可限定某个项目	任何模式
读取单个问题的详情	任何模式

它绝不会做的事：解决、分配、忽略或删除问题，修改告警或项目设置，或向 Sentry 发送任何内容。

开始之前

一个 sentry.io 上的 Sentry 账户。不支持自托管的 Sentry 服务器，MonstarX 只与 sentry.io 通信。
你是这个 MonstarX 项目的所有者。只有所有者可以连接或断开工具。

获取你的令牌

在 Sentry 中打开 User settings > Personal Tokens，创建一个新令牌。
给它以下读取权限范围：org:read（连接时 MonstarX 会检查这一项）、project:read 和 event:read。
保存并复制令牌。

Sentry 官方指南：Authentication 和 Permissions & scopes。

在 MonstarX 中连接

打开你的项目，点击顶部栏中的后端，再点击云服务。
滚动到连接器，找到 Sentry，点击连接。
把令牌粘贴到 API 密钥输入框中，点击连接。
MonstarX 会通过列出你的组织来检查令牌。检查通过后，这一行会显示已连接。如果令牌被拒绝，你会看到错误信息，并且不会保存任何内容。

让 MonstarX 使用它

你输入	会发生什么
“我的 Sentry 项目‘booking-web’里，排在最前面的未解决问题有哪些？”	MonstarX 搜索问题，并在聊天中列出来。
“读取 Sentry 问题 4512 并修复它。”	它读取问题详情，并在构建模式下修改应用代码，从根源上修复。
“我有哪些 Sentry 项目？”	它列出你的组织及其项目。

安全与隐私

只留在 MonstarX。 令牌加密存储在 MonstarX 的服务器上，绝不会写进应用代码，也不会交给你的应用。
只读。 MonstarX 只读取。只给令牌读取权限范围，即使令牌泄露，也无法改动 Sentry 中的任何内容。
只当作信息。 错误信息和事件数据只当作信息，绝不当作指令。
随时断开。 在后端云服务中点击 Sentry 旁边的断开连接，并确认 从此项目断开 Sentry？。MonstarX 会删除这个令牌。如果不再需要，也请在 Sentry 中吊销它。

小贴士

个人令牌代表你本人，所以 MonstarX 能看到的组织和项目，就是你能看到的那些。
提问时说明是哪个组织或项目，可以帮 MonstarX 省一步。
如果是你正在 MonstarX 中构建的应用出了错，可能根本不需要 Sentry：MonstarX 可以直接读取应用自己的日志。

常见问题

MonstarX 能解决或分配 Sentry 问题吗？

不能。它可以列出组织和项目、搜索问题和读取问题。修复上线后，请你自己在 Sentry 中把问题标记为已解决。

支持自托管的 Sentry 吗？

不支持。这个连接只与 sentry.io 通信。

我的应用能把错误上报到 Sentry 吗？

这和这个连接是两回事。请让 MonstarX 为你的应用添加 Sentry 错误上报；它会向你索要项目的 DSN 或密钥，这些要放在后端 → 密钥中。详见用“密钥”安全保存 API 密钥。