用途:为项目服务统一接入 Sentry v8 的错误跟踪与性能监控,覆盖控制器、路由、工作流、定时任务和数据库性能等场景。
主要能力:强制所有错误上报 Sentry;提供 BaseController 统一处理控制器错误;路由可用 Sentry.captureException 附带 tags、extra 上下文;工作流使用 WorkflowSentryHelper.captureWorkflowError;定时任务必须首行导入 instrument.ts,并用 Sentry.startSpan 包裹;数据库可用 DatabasePerformanceMonitor.withPerformanceTracking 或 Sentry.startSpan 追踪。支持 fatal/error/warning/info/debug 错误级别,并建议附带 userId、service、environment 及操作上下文。
使用方式:按示例模式在 try/catch 中捕获并上报;服务初始化在 instrument.ts 中执行 Sentry.init,配置 dsn、environment、nodeProfilingIntegration、tracesSampleRate、profilesSampleRate;config.ini 中配置 [sentry] 与 [databaseMonitoring] 项;可通过 curl 访问各服务的 /api/sentry/test-* 测试端点验证。
适用场景:新增错误处理、创建控制器或路由、插桩定时任务、跟踪数据库性能、添加性能 span、处理工作流错误。
限制:资料未提供价格、平台支持范围与性能效果数据;文档中表单服务标注完成,邮件服务仍在进行且剩余 189 处 ErrorLogger.log() 调用,另需注意不得在错误上下文中暴露敏感数据、不得静默吞掉错误、异步操作不得跳过错误处理。