用途:通过 Sentry 的工作流引擎 API 创建告警,适用于创建告警、设置通知、配置问题优先级告警或构建工作流自动化。该 API 目前为 beta,属于 New Monitors and Alerts,可能不在旧版 Alerts UI 中显示。
前提条件:shell 中有 curl;Sentry 组织认证令牌具备 alerts:write 权限(也接受 org:admin 或 org:write)。
使用方式分阶段:先收集组织 slug、令牌、区域(默认 us)、告警名称、触发事件、条件、动作类型与目标;再用接口将名称解析为 ID(如 /members/、/teams/、/integrations/);然后构建负载并调用: curl -s -w "\n%{http_code}" -X POST "https://{region}.sentry.io/api/0/organizations/{org}/workflows/" -H "Authorization: Bearer {token}" -H "Content-Type: application/json" -d '{payload}' 预期返回 HTTP 201,响应含 workflow id。验证链接为 https://{org_slug}.sentry.io/monitors/alerts/{workflow_id}/;若组织无 workflow-engine-ui 特性标志,则告警出现在 https://{org_slug}.sentry.io/alerts/rules/。
主要能力:触发事件包括新建问题、回归、重新出现、已解决等;过滤条件支持优先级、事件频率、受影响用户数、标签、指派、级别、问题年龄、类别、出现次数等;动作支持 email、slack、pagerduty、discord、msteams、opsgenie、jira、github 集成。注意 triggers.actions 始终为空数组,动作位于 actionFilters[].actions;frequency 允许 0、5、10、30、60、180、720、1440 分钟。
限制:API 为 beta 可能变化;需正确令牌权限与组织归属;常见错误包括 401(权限)、403(组织不匹配)、404(区域或 slug 错误)、400(负载结构问题)。管理操作支持列出、获取、更新与删除工作流。