SuperAPI AI 工具集

sentry-react-sdk

编程与开发

查看项目

更新于 10-15 21:51

技能介绍

本技能用于在 React 应用中完成 Sentry SDK 的完整接入。适用场景包括:用户要求在 React 项目里“添加 Sentry”、安装 @sentry/react,或需要错误监控、链路追踪、会话回放、性能剖析与日志能力;也覆盖 React Router v5/v6/v7 非框架导航、Redux 状态与组件性能监控。注意:若项目为 React Router Framework 模式且使用 @sentry/react-router,应改用 sentry-react-router-framework-sdk。

工作流程分四个阶段。第一阶段检测:通过查看 package.json 判断 React 版本、是否已装 @sentry/react、路由类型(react-router-dom/react-router/@tanstack/react-router)、状态管理、构建工具(Vite/CRA/webpack)与日志库,并检查相邻后端目录。第二阶段给出具体建议:错误监控始终推荐;React SPA 推荐链路追踪;面向用户的应用推荐会话回放;需要结构化日志检索时推荐日志;性能关键项目可选剖析(实验性)。第三阶段按功能逐一引导:安装 npm install @sentry/react --save;创建 src/instrument.ts 并在入口文件首行导入,确保 Sentry.init() 最先执行;React 19+ 在 createRoot 传入 reactErrorHandler(),React 16–18 使用 Sentry.ErrorBoundary。路由集成按版本选择:v7 用 reactRouterV7BrowserTracingIntegration,v6 用 reactRouterV6BrowserTracingIntegration,v5 用 reactRouterV5BrowserTracingIntegration 并配合 withSentryRouting,TanStack 用 tanstackRouterBrowserTracingIntegration(router),无路由用 browserTracingIntegration。Redux 项目加入 createReduxEnhancer()。源码映射推荐使用 sentryVitePlugin(Vite)或 @sentry/webpack-plugin(CRA 经 CRACO),需配置 SENTRY_ORG、SENTRY_PROJECT、SENTRY_AUTH_TOKEN(密钥不可提交)。第四阶段在完成后检查相邻后端并建议对应 SDK。

关键配置项包括 dsn、environment、release、tracesSampleRate(生产建议 0.1–0.2)、tracePropagationTargets、replaysSessionSampleRate、replaysOnErrorSampleRate、enableLogs 等;dataCollection 可细粒度控制用户信息、Cookie、请求/响应头与体、查询参数、AI 输入输出等采集。验证方式为触发测试错误与消息,在控制台查看 Issues、Traces、Replays、Logs,必要时设 debug: true。具体参考文件、SDK 版本与 API 请以 docs.sentry.io 为准;未提供收费、价格或效果承诺等信息。