SuperAPI AI 工具集

sentry-observability

部署与运维

查看项目

更新于 10-16 03:41

技能介绍

用途:为生产应用接入并使用 Sentry,做错误追踪与线上可观测性。技能分两种模式:未配置 Sentry 时的接入模式,以及已配置后的运维模式。资料称会在新 Next.js 项目(package.json 无 @sentry/*)、部署到生产、讨论错误处理模式时主动建议接入。

主要能力(脚本,路径保持原样):检测配置:~/.claude/skills/sentry-observability/scripts/detect_sentry.sh;初始化:init_sentry.sh;安装后验证:verify_setup.sh。运维侧:列出未解决 issue(list_issues.sh --env production,支撑 /triage)、按优先级评分(triage_score.sh --json)、查看 issue 完整上下文(issue_detail.sh PROJ-123)、创建告警规则(create_alert.sh --name "New Errors" --type issue)、标记已解决(resolve_issue.sh PROJ-123)。分诊优先级公式:Events(1x)+Users(5x)+Severity(3x)+Recency(2x)+Env(4x),分越高越优先。

使用方式与原则:优先用 Vercel 市场集成而非手工 token;环境命名用 production,而非 vercel-production;默认做 PII 脱敏并隐藏 source map;告警用 CLI 自动化、纳入版本控制。采样率不可硬编码 tracesSampleRate: 1,应读环境变量(如 NEXT_PUBLIC_SENTRY_TRACES_SAMPLE_RATE)并夹在 0–1,缺省 0.1。需要变量:SENTRY_AUTH_TOKEN 或 SENTRY_MASTER_TOKEN、SENTRY_ORG、SENTRY_DSN,SENTRY_PROJECT 可由 .sentryclirc 或 .env.local 自动识别。

适用场景与限制:适合 Next.js/Vercel 生产项目的错误监控与分诊;非生产原型可跳过。资料提及免费额度为每月 5k 错误,但未提供价格、具体配置细节与全部参考资料内容,相关部分暂未提供。