SuperAPI AI 工具集

sentry-integration

通用与其它

查看项目

更新于 10-16 01:26

技能介绍

用途:在实现或调试 Sentry 错误追踪、插桩、分布式追踪、性能问题、异常捕获时加载本技能。适用于 Sentry SDK 配置或迁移、错误追踪与异常捕获、预期错误分类、插桩与 span 设计、性能与慢请求分析、TRPC/HTTP 处理器/服务端函数的中间件接入,以及通过 Sentry API 操作 issues、projects、alerts。

强制操作顺序:1) 配置 SDK(先服务端,后客户端),显式定义 environment、release 和采样,排除健康检查与合成流量;2) 在框架边界接入中间件,需覆盖 publicProcedure、认证/受保护过程、管理或组织范围过程及自定义组合链,不要只接一个 procedure;3) 在捕获前和 beforeSend 中分类预期错误,将预期业务错误标记为 handled 以减少告警噪音;beforeSend 中必须从 hint.originalException 读取可抛对象;4) 仅在默认集成不足处添加追踪,数据库追踪优先用 postgresIntegration,标准查询路径不适用或需操作级命名时再用手动/代理追踪,避免同一查询路径重复产生 span;5) 先在非生产环境验证事件、span、标签与噪音过滤。

验证清单:触发一个预期错误,确认 warning 级 handled 事件;触发一个非预期错误,确认 error 级告警路径;执行一个已插桩请求,确认 trace 连续性;确认健康检查路由被排除;确认无重复数据库 span。

Sentry API 服务范围:issues/projects/token 验证等 API 服务工作可作为可选高级模块;仅当实现仍在 Sentry 集成边界内时保留在同一技能,否则应拆分为独立运维技能。

核心规则:遵循工作流顺序;预期错误保持可观测但标记为 handled;所有过程链中间件覆盖一致;优先内置数据库集成再考虑手动/代理追踪;上线前在非生产环境验证。大型代码示例保存在 references 文件中,决策规则放在 SKILL.md。

限制:资料未提供具体安装命令、依赖版本、支持框架清单、收费或价格信息,需结合项目实际与官方文档确认。