SuperAPI AI 工具集

sentry-setup-tracing

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

用途:为项目启用 Sentry 的 Tracing(性能监控),跟踪应用性能、测量延迟,并在服务之间建立分布式追踪。触发场景包括用户要求“设置 tracing”“启用性能监控”“跟踪 transactions/spans”“分布式追踪”“span 埋点”或询问 tracesSampleRate、自定义 span。

主要能力:配置前先探测项目平台,检查 package.json 中的 @sentry/nextjs、@sentry/react、@sentry/node、@sentry/browser、@sentry/vue、@sentry/angular、@sentry/sveltekit,Python 检查 requirements 中的 sentry-sdk,Ruby 检查 Gemfile 中的 sentry-ruby。可设置统一采样率 tracesSampleRate(0-1)或动态采样 tracesSampler(两者同时存在时 tracesSampler 优先),并解释 Trace、Transaction、Span、Sample Rate 概念。浏览器端可添加 browserTracingIntegration,配置 tracePropagationTargets、beforeStartSpan、shouldCreateSpanForRequest、idleTimeout、finalTimeout、childSpanTimeout、instrumentNavigation、instrumentPageLoad、enableLongTask、enableInp 等选项。支持自定义埋点:JS 用 Sentry.startSpan、startSpanManual、startInactiveSpan;Python 用 @sentry_sdk.trace、start_span()、start_transaction(),Ruby 用 start_span()。分布式追踪通过 sentry-trace 与 baggage 头传播,SSR 场景可用 getTraceData() 写入 meta 标签,非 HTTP 通道可手动 continueTrace。

使用方式:定位 Sentry.init()(Next.js 为 instrumentation-client.ts、sentry.server.config.ts、sentry.edge.config.ts),按平台加入采样配置与集成。Next.js 14+ App Router 需在根布局 metadata 注入 getTraceData() 才能跨服务追踪。生产采样建议:开发/测试 1.0,低流量 0.5-1.0,中流量 0.1-0.5,高流量 0.01-0.1,也可用 tracesSampler 对重要事务提高采样。

限制与注意:设置 tracesSampleRate: 0 不会关闭 tracing,只是不上报;要完全关闭需同时省略两个采样选项。distributed tracing 需正确配置 tracePropagationTargets 并允许 CORS 携带相关头。资料未提供具体价格、平台支持范围之外的信息。