SuperAPI AI 工具集

sentry-automation

部署与运维

查看项目

更新于 10-15 08:04

技能介绍

Sentry Automation 通过 Composio 的 Sentry 工具包,经由 Rube MCP 自动化 Sentry 的错误跟踪与监控操作。

用途

该工具集用于以自动化方式执行 Sentry 中的常见运维任务,包括调查问题、管理项目问题、配置告警规则、管理发布版本、监控组织与团队,以及管理 Cron 监控。

主要能力

  1. 调查问题:列出组织内问题、获取问题详情、查看问题事件、获取完整事件堆栈、检查标签分布。
  2. 管理项目问题:列出项目、查看特定项目的问题、按 ID 获取问题事件。
  3. 配置告警规则:列出已有规则、创建项目告警规则、创建组织级指标告警、更新告警规则、查看规则详情。
  4. 管理发布:列出发布、创建发布、更新发布元数据、记录部署、上传源映射或文件。
  5. 监控组织与团队:获取组织信息、列出团队、列出成员、列出可访问项目。
  6. 管理监控(Cron Monitoring):更新监控配置,包括名称、调度、检查余量和最大运行时间。

使用方式

前置条件:

  • Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用)。
  • 通过 RUBE_MANAGE_CONNECTIONS 建立活动的 Sentry 连接,工具包为 sentry。
  • 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具架构。

设置步骤:

  1. 获取 Rube MCP:在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥,添加端点即可使用。
  2. 确认 RUBE_SEARCH_TOOLS 有响应,验证 Rube MCP 可用。
  3. 调用 RUBE_MANAGE_CONNECTIONS,工具包为 sentry。
  4. 若连接未处于 ACTIVE 状态,按返回的认证链接完成 Sentry OAuth。
  5. 确认连接状态显示 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。