Sentry+NextJS集成：事务与Web Vitals数据缺失问题排查

问题背景 #

我们将Sentry与NextJS集成，设置tracesSampleRate为0.75。错误报告正常且数量充足，但性能事务数据被截断。近24小时数据对比：

• Sentry事务：/home 9.5k、/login 2.1k、/register 224
• Web Vitals：/home 2.9k、/login 110、/register 157
• Google Analytics（同期6k用户）：/home 14k、/login 5.4k、/register 1.6k

数据比例相近但总量差异显著，需排查该数据缺失/限流问题的原因。集成配置涉及next.client.config.js/next.server.config.js中的Sentry.init，以及next.config.js中的withSentryConfig。设置0.75的采样率是因为错误量极大。

核心排查方向与解决方法 #

1. 采样配置的一致性问题 #

Sentry的客户端（浏览器）和服务端（Node.js）事务采样是完全独立的，需确保两端配置统一：

• 检查next.client.config.js和next.server.config.js中的Sentry.init，确认两者都明确设置了tracesSampleRate: 0.75，没有被自定义tracesSampler函数覆盖（若存在采样逻辑，可能会强制替换固定采样率）。
• 若仅一端配置了采样率，对应端的事务会按默认规则（通常为0.1）采样，直接拉低整体数据总量。

2. Sentry性能事务配额耗尽 #

Sentry对性能事务有明确的套餐配额限制，当月度配额用尽后，超出部分的事务会被自动丢弃，表现为数据截断：

• 登录Sentry后台，进入项目「Settings > Usage」页面，查看性能事务的已使用量是否接近或超过套餐限额。
• 若配额不足，可采取以下方案：
  • 临时调整tracesSampleRate（需平衡错误采样需求，避免错误数据被限流）；
  • 优化错误采样规则（比如通过ignoreErrors过滤重复或无关错误，释放配额给性能数据）；
  • 升级Sentry套餐获取更高配额。

3. 事务捕获不完整 #

NextJS的多渲染模式（CSR/SSR/SSG）可能导致部分事务未被正确捕获：

• 客户端路由跳转：验证使用Link组件跳转时，Sentry是否监听routeChangeComplete事件并生成事务。可在浏览器控制台搜索transaction关键字，确认每次路由跳转都有对应的上报日志。
• 服务端渲染事务：检查withSentryConfig是否开启autoInstrumentServerFunctions（默认开启，需确保配置未被手动关闭），确保SSR/API路由的事务被捕获。
• 静态生成页面：SSG页面的客户端交互事务依赖客户端SDK的自动埋点，确认SDK在_app.js中正确初始化，未被延迟加载或屏蔽。

4. 自定义事务过滤逻辑干扰 #

若配置了beforeSendTransaction钩子，可能无意中过滤了部分事务：

• 检查Sentry.init中的beforeSendTransaction函数，确认没有添加不合理的过滤规则（比如错误丢弃特定路由的事务）。

5. 统计口径天然差异 #

GA与Sentry的统计逻辑存在本质区别：

• GA统计所有页面访问请求（包括同一用户的重复访问），而Sentry的采样是基于单个事务实例（同一用户多次访问可能仅被采样部分）。
• 若Sentry的独立用户数接近GA的6k，但事务数按0.75比例计算仍有差距，需排查是否存在Sentry未捕获的异常场景（比如页面加载失败、跳转中断等）。

快速验证步骤 #

1. 对比Sentry后台的「Unique Users」数据与GA用户数，若前者远低于6k，说明存在事务捕获或采样配置问题。
2. 临时将tracesSampleRate设为1.0，观察1小时内的事务数据是否接近GA的对应比例，验证采样率是否为核心因素。
3. 查看Sentry「Transactions」页面，检查是否有大量事务被标记为「dropped」，确认是否由配额或过滤规则导致。

内容的提问来源于stack exchange，提问作者slava