用途:把 Temps 错误追踪接入现有应用。Temps 与 Sentry 线路兼容,其 DSN 可替代 Sentry DSN,因此按平台使用官方 Sentry SDK 即可。若 CLI 中已安装 Sentry 官方按框架技能(如 /sentry-nextjs-sdk、/sentry-react-sdk 等),可复用该技能,仅替换 DSN;Sentry 无专用技能的平台则按本技能步骤配置。
主要能力:按代码库推断平台(如 package.json 含 next → Next.js,含 vue → Vue,requirements.txt 含 Flask/Django/FastAPI → Python,go.mod → Go,Cargo.toml → Rust 等),给出对应 SDK 安装与初始化方式,并支持手动捕获异常与消息(captureException、captureMessage)。JS/TS 还支持上传 source maps 以还原堆栈。
使用方式:从 Temps 项目 Error Tracking → DSN & Setup 获取形如 https://<public_key>@<temps-host>/<project_id> 的 DSN,始终存入环境变量。浏览器打包器常用公共前缀变量:Next.js 用 NEXT_PUBLIC_SENTRY_DSN,Vite/React/Vue 用 VITE_SENTRY_DSN,SvelteKit 用 PUBLIC_SENTRY_DSN,其余(Node、Python、Go、Rust、Ruby、Java、PHP、.NET、Flutter)用 SENTRY_DSN。浏览器 SDK 还应传 tunnel(Next.js 用 NEXT_PUBLIC_SENTRY_TUNNEL,Vite/React/Vue 用 VITE_SENTRY_TUNNEL,SvelteKit 用 PUBLIC_SENTRY_TUNNEL;Angular 无公共前缀约定,跳过 tunnel),以同源路径 /api/_temps 代理,避免跨域与被广告拦截器阻断。若部署在 Temps 之外,可省略 tunnel(回退直连 DSN 主机),或把 tunnel 指向 Temps 实例的绝对隧道地址。
限制:Temps 目前不接收 Sentry 的会话回放与性能事务,浏览器项目应省略 Sentry.replayIntegration() 与 tracesSampleRate,改用 Temps 自身的会话录制与分析 SDK。Next.js 中不要设置 tunnelRoute,它不适用于自托管 Sentry。配置后可通过触发测试错误在 Error Tracking → Error Groups 验证。