Sentry Automation 通过 Composio 的 Sentry 工具包,经由 Rube MCP 自动化 Sentry 的错误跟踪与监控操作。
用途
该工具集用于以自动化方式执行 Sentry 中的常见运维任务,包括调查问题、管理项目问题、配置告警规则、管理发布版本、监控组织与团队,以及管理 Cron 监控。
主要能力
- 调查问题:列出组织内问题、获取问题详情、查看问题事件、获取完整事件堆栈、检查标签分布。
- 管理项目问题:列出项目、查看特定项目的问题、按 ID 获取问题事件。
- 配置告警规则:列出已有规则、创建项目告警规则、创建组织级指标告警、更新告警规则、查看规则详情。
- 管理发布:列出发布、创建发布、更新发布元数据、记录部署、上传源映射或文件。
- 监控组织与团队:获取组织信息、列出团队、列出成员、列出可访问项目。
- 管理监控(Cron Monitoring):更新监控配置,包括名称、调度、检查余量和最大运行时间。
使用方式
前置条件:
- Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用)。
- 通过 RUBE_MANAGE_CONNECTIONS 建立活动的 Sentry 连接,工具包为 sentry。
- 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具架构。
设置步骤:
- 获取 Rube MCP:在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥,添加端点即可使用。
- 确认 RUBE_SEARCH_TOOLS 有响应,验证 Rube MCP 可用。
- 调用 RUBE_MANAGE_CONNECTIONS,工具包为 sentry。
- 若连接未处于 ACTIVE 状态,按返回的认证链接完成 Sentry OAuth。
- 确认连接状态显示 ACTIVE 后再运行任何工作流。
核心工作流示例:
- 调查问题:依次调用 SENTRY_LIST_AN_ORGANIZATIONS_ISSUES(必需)、SENTRY_GET_ORGANIZATION_ISSUE_DETAILS、SENTRY_LIST_AN_ISSUES_EVENTS、SENTRY_RETRIEVE_AN_ISSUE_EVENT、SENTRY_RETRIEVE_ISSUE_TAG_DETAILS。
- 管理项目问题:先调用 SENTRY_RETRIEVE_ORGANIZATION_PROJECTS 解析项目 slug,再调用 SENTRY_RETRIEVE_PROJECT_ISSUES_LIST,可选 SENTRY_RETRIEVE_ISSUE_EVENTS_BY_ID。
- 配置告警规则:先解析项目,可选列出已有规则,再调用 SENTRY_CREATE_PROJECT_RULE_FOR_ALERTS 或 SENTRY_CREATE_ORGANIZATION_ALERT_RULE,可选更新或查看详情。
- 管理发布:可选列出发布,调用 SENTRY_CREATE_RELEASE_FOR_ORGANIZATION 创建,可选更新元数据、记录部署、上传文件。
- 监控组织与团队:调用 SENTRY_GET_ORGANIZATION_DETAILS 或 SENTRY_GET_ORGANIZATION_BY_ID_OR_SLUG,可选列出团队、成员、项目。
- 管理监控:调用 SENTRY_UPDATE_A_MONITOR 更新配置。
适用场景
适用于需要以自动化方式在 Sentry 中执行错误跟踪与监控运维的团队或个人,例如批量调查问题、按项目筛选问题、创建或更新告警规则、管理发布与部署、查看组织与团队结构、调整 Cron 监控配置等。
限制与注意事项
- 必须已连接 Rube MCP 并建立活动的 Sentry 连接。
- 组织标识应使用 slug(如 'my-org'),而非显示名称;项目同样使用 slug。
- 问题 ID 为数字整数,事件 ID 为 UUID(32 位十六进制字符串),不可混淆。
- 查询语法使用 Sentry 搜索格式,如 is:unresolved、assigned:me、!has:release。
- 项目级规则与组织级指标告警不同;条件、动作和过滤器使用特定 JSON 架构。
- frequency 单位为分钟,设置过低会导致告警疲劳。
- 发布版本在组织内必须唯一;部署与创建是分开的操作;上传源映射需先存在发布。
- 监控 slug 由名称自动生成;调度变更立即生效;缺少检查会在余量期后触发告警。
- 分页使用游标(cursor),需按 Link 头或响应中的 cursor 继续请求。
- API 令牌权限范围需匹配所执行操作;组织级操作需组织级权限,项目级操作需项目访问权限。
- Sentry 对每个组织有速率限制,遇到 429 响应应实现退避;批量操作应错开执行。
- 团队和成员可见性取决于已认证用户的权限。
快速参考
- 列出组织问题:SENTRY_LIST_AN_ORGANIZATIONS_ISSUES,参数 organization_id_or_slug、query。
- 获取问题详情:SENTRY_GET_ORGANIZATION_ISSUE_DETAILS,参数 organization_id_or_slug、issue_id。
- 列出问题事件:SENTRY_LIST_AN_ISSUES_EVENTS,参数 issue_id。
- 获取事件详情:SENTRY_RETRIEVE_AN_ISSUE_EVENT,参数 organization_id_or_slug、event_id。
- 列出项目问题:SENTRY_RETRIEVE_PROJECT_ISSUES_LIST,参数 organization_id_or_slug、project_id_or_slug。
- 列出项目:SENTRY_RETRIEVE_ORGANIZATION_PROJECTS,参数 organization_id_or_slug。
- 获取组织详情:SENTRY_GET_ORGANIZATION_DETAILS,参数 organization_id_or_slug。
- 列出团队:SENTRY_LIST_TEAMS_IN_ORGANIZATION,参数 organization_id_or_slug。
- 列出成员:SENTRY_LIST_ORGANIZATION_MEMBERS,参数 organization_id_or_slug。
- 创建告警规则:SENTRY_CREATE_PROJECT_RULE_FOR_ALERTS,参数 organization_id_or_slug、project_id_or_slug。
- 创建指标告警:SENTRY_CREATE_ORGANIZATION_ALERT_RULE,参数 organization_id_or_slug。
- 创建发布:SENTRY_CREATE_RELEASE_FOR_ORGANIZATION,参数 organization_id_or_slug、version。
- 部署发布:SENTRY_CREATE_RELEASE_DEPLOY_FOR_ORG,参数 organization_id_or_slug、version。
- 列出发布:SENTRY_LIST_ORGANIZATION_RELEASES,参数 organization_id_or_slug。
- 更新监控:SENTRY_UPDATE_A_MONITOR,参数 organization_id_or_slug、monitor_id_or_slug。