性能与链路追踪

性能监控回答“哪里慢”，链路追踪回答“一次请求在小程序和服务端分别花了多久”。两者共用 trace，但不是同一件事。

先开启性能采样

设置 tracesSampleRate 后，SDK 才会发送性能 transaction 和 span：

Sentry.init({
  dsn: 'YOUR_DSN',
  release: 'my-miniapp@1.0.0',
  tracesSampleRate: 0.2,
});

0.2 表示约 20% 的 trace 被采样。测试环境可临时使用 1.0，生产环境应结合流量和 Sentry 配额设置。

错误事件由 sampleRate 控制，性能数据由 tracesSampleRate 或 tracesSampler 控制，两套采样互不替代。

按页面或场景动态采样

关键链路全采、普通页面降采时使用 tracesSampler：

Sentry.init({
  dsn: 'YOUR_DSN',
  tracesSampler: ({ name, inheritOrSampleWith }) => {
    if (name.includes('pages/pay')) return 1;
    if (name.includes('pages/about')) return 0.05;
    return inheritOrSampleWith(0.2);
  },
});

设置 tracesSampler 后，它的优先级高于 tracesSampleRate。

自动采集哪些性能数据

默认性能集成会在宿主支持时读取小程序 Performance API：

数据	在 Sentry 中的用途
导航与启动	判断页面进入和启动阶段耗时
渲染与 `setData`	发现渲染过慢、更新过重
资源加载	定位大资源或慢资源
API 请求	包裹平台 `request`，作为 `http.client` span 查看请求耗时
小游戏冷启动、FPS、jank	作为小游戏专属 transaction 与 measurement

宿主没有 createObserver 时，默认性能集成会静默跳过导航、渲染和资源条目，不设置已启用标记，也不会启动定时汇总。API 请求由网络集成直接包裹平台 request 采集，不依赖 PerformanceObserver。微信 / 抖音小游戏的冷启动、FPS 和 jank 则由小游戏专属集成采集；详见小游戏接入与性能。

微信的 wx.reportPerformance() 属于小程序后台的自定义测速能力，不是 Sentry 性能监控的一部分；如需使用，请先在微信后台配置指标，再由业务代码主动调用。

添加业务 span

需要测量登录、支付、数据转换等业务操作时，可以使用熟悉的 Sentry API：

await Sentry.startSpan(
  {
    name: 'checkout.submit',
    op: 'ui.action',
    attributes: { paymentMethod: 'balance' },
  },
  async () => {
    await submitOrder();
  },
);

startSpan 会管理回调生命周期。只有确实需要跨越多个回调手动结束时，才使用 startInactiveSpan。

串联小程序与服务端

开启 tracing 后，SDK 可向 tracePropagationTargets 明确匹配的请求注入：

sentry-trace：trace id、span id 与采样状态；
baggage：Sentry Dynamic Sampling Context；
traceparent：仅在 propagateTraceparent: true 时额外注入，用于兼容 W3C Trace Context / OpenTelemetry 后端。

小程序没有浏览器可靠的 same-origin 基准，因此 tracePropagationTargets 默认为空时不注入任何追踪头。只把自己控制的 API 域名加入白名单：

Sentry.init({
  dsn: 'YOUR_DSN',
  tracesSampleRate: 0.2,
  tracePropagationTargets: [
    /^https:\/\/api\.example\.com\//,
    /^https:\/\/gateway\.example\.com\//,
  ],
  propagateTraceparent: true,
});

只有后端网关或 OpenTelemetry 链路明确需要 W3C traceparent 时才打开 propagateTraceparent。Sentry 原生服务只需要默认的 sentry-trace 与 baggage。

enableTracePropagation: false 只停止追踪头注入，不会关闭本地 http.client span。开启性能采样后：

请求发生在活跃 span 内时，记录为该流程的子 span；
没有活跃 span 时，默认发送为独立 segment span，因此长时间运行且没有页面 transaction 的小游戏也不会丢失请求性能；
独立 segment 是原生 span envelope，不会为每个请求制造一条根 transaction。若只想保留业务流程内的请求子 span，可设置 enableStandaloneHttpSpans: false。

需要把一组请求和业务操作组织成同一条完整流程时，仍应使用 Sentry.startSpan() 包住该流程。

请求名称基数

请求 span 名会保留 URL 路径，例如 GET https://api.example.com/users/123。如果路径中的订单号、用户 id 导致维度过高，可在 beforeSendSpan 中把动态段统一改为 :id。SDK 不会自行猜测路由模板，避免误改合法路径。

验证链路

测试环境临时设置 tracesSampleRate: 1.0。
直接发起一次目标 API 请求，在 Sentry Performance / Traces 中确认独立 http.client span；再按需在 Sentry.startSpan() 管理的业务流程内确认父子关系。
在真机网络面板或服务端日志中确认预期追踪头存在。
确认第三方域名没有收到不必要的追踪头。
打印 Sentry.getDiagnostics()，检查采样率、传播开关和 warnings。

没有 span 时，先确认性能采样已开启、默认 NetworkBreadcrumbs 集成没有被替换，并检查 enableStandaloneHttpSpans 是否被关闭；本地 span 正常但服务端没有串联时，再检查 tracePropagationTargets、网关透传和后端 Sentry / OpenTelemetry 配置。

所有相关选项见配置项参考 · 采样与配置项参考 · 分布式追踪。

性能与链路追踪 ​

先开启性能采样 ​

按页面或场景动态采样 ​

自动采集哪些性能数据 ​

添加业务 span ​

串联小程序与服务端 ​

请求名称基数 ​

验证链路 ​