用途:在任意项目中配置 Sentry Tracing(性能监控),用于追踪应用性能、测量延迟并创建跨服务的分布式追踪。适用于用户要求“设置追踪”“启用性能监控”“追踪事务/span”“测量延迟”或询问 tracesSampleRate、自定义 span 的场景。
主要能力:先检测平台(检查 package.json 中的 @sentry/nextjs、@sentry/react、@sentry/node、@sentry/browser、@sentry/vue、@sentry/angular、@sentry/sveltekit,或 Python 的 sentry-sdk、Ruby 的 sentry-ruby),再解释 Trace、Transaction、Span、Sample Rate 等概念,并给出各平台配置。
使用方式:JavaScript/TypeScript 在 Sentry.init() 中设置 tracesSampleRate,浏览器/React 需加入 Sentry.browserTracingIntegration(),并配置 tracePropagationTargets;Next.js 需在 instrumentation-client.ts、sentry.server.config.ts、sentry.edge.config.ts 中配置,App Router 还需在根布局 metadata 中加入 Sentry.getTraceData()。Python 使用 traces_sample_rate,Ruby 使用 config.traces_sample_rate。采样可选统一比率或 tracesSampler 动态函数(两者同时设置时 tracesSampler 优先)。自定义 span 可用 Sentry.startSpan()、@sentry_sdk.trace 或 start_span()。分布式追踪通过 sentry-trace 与 baggage 头传播,SSR 可用 meta 标签,非 HTTP 通道可手动 continueTrace。
适用场景:浏览器页面加载与导航、Next.js API 路由与服务端组件、Node.js HTTP 请求与数据库查询、Python 的 Django/Flask/FastAPI/SQLAlchemy/Celery、Ruby 应用等。
限制:设置 tracesSampleRate: 0 不会禁用追踪,只是不发送;要完全禁用需省略两个采样选项。生产环境采样率需按流量调整。资料未提供具体收费、价格或平台支持范围之外的信息。