用途:通过 Sentry 工作流引擎 API 创建告警与通知规则,例如当问题匹配特定条件时发送邮件、Slack 或 PagerDuty 通知,适用于优先级告警、降级告警和工作流自动化配置。该 API 目前处于 beta 阶段,属于 New Monitors and Alerts,可能不在旧版 Alerts UI 中显示。
前提条件:shell 中可用 curl;Sentry 组织认证令牌需具备 alerts:write 权限(也接受 org:admin 或 org:write)。
使用方式分五个阶段。一、收集配置:组织 slug、认证令牌、区域(默认 us,de 对应 de.sentry.io)、告警名称、触发事件、可选条件、动作类型(email、slack、pagerduty 等)与动作目标。二、查 ID:通过 members、teams、integrations 等接口把邮箱、团队名、集成名解析为 ID。三、构建 payload:triggers 的 logicType 固定为 any-short,条件支持 issue_priority_greater_or_equal、event_frequency_count、tagged_event、level、age_comparison 等;动作统一放在 actionFilters[].actions 中。四、创建:POST 到 /api/0/organizations/{org}/workflows/,预期返回 HTTP 201 及 workflow id。五、验证:提供 UI 链接 /monitors/alerts/{workflow_id}/;若组织缺少 workflow-engine-ui 特性标志,则显示在 /alerts/rules/。
管理:可列出、获取、PUT 更新与 DELETE 删除工作流(删除预期 204)。frequency 可选 0、5、10、30、60、180、720、1440 分钟。
限制:API 为 beta 可能变更;401 表示令牌缺少 alerts:write,403 表示令牌不属于目标组织,404 需检查组织 slug 与区域。