Sentry 是应用监控平台,主要用于错误追踪、性能监控和告警。资料以 Next.js 为例说明集成方式。
安装:可用向导 npx @sentry/wizard@latest -i nextjs,或手动 npm install @sentry/nextjs。需配置环境变量 SENTRY_DSN、SENTRY_AUTH_TOKEN、SENTRY_ORG、SENTRY_PROJECT,并分别创建客户端、服务端与 Edge 配置文件,在 next.config.js 中用 withSentryConfig 包裹。
主要能力:自动捕获未处理异常、未处理的 Promise 拒绝和控制台错误;也可用 Sentry.captureException、captureMessage 手动捕获,并通过 setUser、setTag、setExtra、setContext、withScope 添加上下文。提供 React Error Boundary 与 Sentry.ErrorBoundary。性能监控支持 startSpan 自定义事务与嵌套 span、withServerActionInstrumentation 包装 Server Actions。会话回放通过 replayIntegration 配置采样率与脱敏。Source Maps 可在构建时上传或使用 @sentry/cli 手动上传。告警在 Sentry 控制台配置错误阈值、性能下降、崩溃率与 Slack/邮件通知。可用 beforeSend、beforeSendTransaction、ignoreErrors、beforeBreadcrumb 过滤事件。
限制与注意:资料未提供具体收费与价格信息;采样率建议开发环境 100%、生产环境调低;需正确上传 Source Maps 以获得可读堆栈;DSN 可安全暴露在客户端。