用途:在应用中接入 Sentry SDK,实现异常捕获、上下文附加、性能追踪与结构化日志,属于 Sentry 使用实践指南。前置条件:需先完成 Sentry Setup 等设置类配方。
主要能力与用法:捕获已处理但仍需追踪的错误,用 Sentry.captureException(err) 上报。添加上下文方面,Sentry.setUser 在会话期间持续生效,可传入 id、email;captureException 可带 tags(可索引、可过滤)与 extra(任意明细),例如 tags 中标注 feature、plan,extra 中记录 orderId、items;退出登录时用 Sentry.setUser(null) 清除用户。性能追踪方面,用 Sentry.startSpan 包裹有意义的操作,同步形式会收到 span 以设置属性,示例包括 op 为 http.client 的 GET /api/users,以及 op 为 ui.click 的按钮点击并 setAttribute。面包屑方面,控制台日志、fetch 与 UI 点击会自动捕获,自定义事件可用 Sentry.addBreadcrumb 手动添加,包含 category、message、level。日志方面,可使用 Sentry.logger 输出结构化日志,logger.info、logger.warn、logger.error 可在 Logs 标签页中查看,日志可附带 orderId、amount 等字段。
适用场景:需要在 Next.js 应用中统一做错误监控、性能追踪和上下文补充的工程场景。
限制:资料未提供具体的收费、价格、平台支持范围、配额或效果数据,也暂未提供安装命令与更完整的配置步骤;相关细节需参考 Sentry Next.js SDK 与 Custom Instrumentation 文档。