SuperAPI AI 工具集

error-tracking

部署与运维

查看项目

更新于 10-16 06:44

技能介绍

用途:该技能用于在项目各服务中按 Sentry v8 模式统一接入错误追踪与性能监控,适用于添加错误处理、创建控制器或路由、为定时任务埋点、追踪数据库性能、添加性能 span 以及处理工作流错误。

主要能力:提供控制器错误处理(继承 BaseController 并调用 handleError)、路由错误处理(Sentry.captureException 并附 tags 与 extra)、工作流错误处理(WorkflowSentryHelper.captureWorkflowError)、定时任务强制模式(首行导入 instrument,使用 Sentry.startSpan 包裹并捕获异常)、数据库性能监控(DatabasePerformanceMonitor.withPerformanceTracking)以及异步操作 span。还定义错误级别(fatal、error、warning、info、debug)和必需上下文(用户、service、environment 标签及操作上下文)。

使用方式:在服务入口 instrument.ts 中调用 Sentry.init,配置 dsn、environment、nodeProfilingIntegration、tracesSampleRate 与 profilesSampleRate;配置可写入 config.ini 的 [sentry] 与 [databaseMonitoring] 段。定时任务必须在 shebang 后首行导入 instrument。可通过测试端点(如 curl http://localhost:3002/blog-api/api/sentry/test-error)验证集成。

适用场景:Form Service 与 Email Service 等 Node 服务;要求所有 API 端点有事务追踪、数据库查询超过 100ms 被标记、检测 N+1 查询、定时任务追踪执行时间。

限制与注意:资料未提供安装命令、价格、平台支持范围及完整依赖版本;Form Service 已完成集成,Email Service 仍在进行中(22 项任务完成 6 项,剩余 189 处 ErrorLogger.log() 调用)。禁止单独使用 console.error、静默吞掉错误、在上下文中暴露敏感数据或使用无上下文的通用错误信息。