用途:在项目中接入 Sentry Tracing(性能监控),跟踪应用性能、测量请求延迟,并创建跨服务的分布式追踪。适用于用户提出“设置追踪”“启用性能监控”“跟踪事务”“测量延迟”“分布式追踪”“跟踪 API 响应时间或页面加载性能”或询问 tracesSampleRate、自定义 span 的场景。
主要能力:先检测项目平台,再在对应 Sentry.init 位置启用追踪。JS/TS 可在浏览器/React 中添加 browserTracingIntegration,配置 tracesSampleRate 与 tracePropagationTargets;Next.js 需同时配置 instrumentation-client.ts、sentry.server.config.ts、sentry.edge.config.ts,App Router 还需在根布局 metadata 中调用 getTraceData()。Python 使用 traces_sample_rate,Ruby 使用 traces_sample_rate。支持统一采样率与动态采样(tracesSampler / traces_sampler),并支持自定义 span:JS 用 Sentry.startSpan、startSpanManual、startInactiveSpan,Python 用 @sentry_sdk.trace、start_span 或 start_transaction。分布式追踪通过 sentry-trace 与 baggage 头传播,SSR 可用 meta 标签,非 HTTP 通道可手动 continueTrace。
必要用法:按平台选择采样选项;生产环境按流量调整采样率,重要事务可动态采样;通过 startSpan 回调创建嵌套 span,并统一 op 取值。验证时触发测试事务后在 Sentry 的 Performance 中查看事务与 trace 瀑布图。
限制与注意:设置 tracesSampleRate: 0 不会禁用追踪,只是不发送数据;要完全禁用应同时省略 tracesSampleRate 与 tracesSampler。若两者同时设置,tracesSampler 优先。分布式追踪需配置 tracePropagationTargets 并允许相关 CORS 头,SSR 需渲染追踪 meta 标签。资料中未提供具体的 Sentry 定价或收费信息。