用途:为 Next.js 应用配置 Sentry 错误追踪与 OpenTelemetry(OTel)性能监控,实现自动错误捕获、分布式追踪和自定义日志。
主要能力:安装 @sentry/nextjs 并用向导生成客户端、服务端、Edge 运行时配置及 instrumentation.ts;通过环境变量配置 DSN、组织与项目;提供结构化日志封装、React 错误边界、自定义错误页与全局错误处理;支持 Server Actions 手动埋点、用户上下文、自定义标签、面包屑与性能事务;Prisma 查询可经 OTel 自动追踪。
使用方式:执行 npm install @sentry/nextjs,再运行 npx @sentry/wizard@latest -i nextjs 自动生成配置。在 .env.local 中设置 SENTRY_DSN、SENTRY_ORG、SENTRY_PROJECT、NEXT_PUBLIC_SENTRY_DSN。按模板定制 sentry.server.config.ts、sentry.client.config.ts、instrumentation.ts、lib/logger.ts、components/error-boundary.tsx、app/error.tsx、app/global-error.tsx。instrumentation.ts 需 next.config.js 中的 experimental.instrumentationHook(由向导添加)。
适用场景:Next.js 项目的错误监控、性能追踪、用户行为排查与数据库查询追踪。
限制:需自行准备 Sentry 账号与 DSN;采样率需按配额调整;部分 Server Components 仅自动部分埋点;具体价格与平台支持暂未提供。