自建Sentry平台中INP指标显示问题的排查与解决

问题背景

在自建Sentry平台(版本24.8.0)中，用户遇到了Interaction to Next Paint(INP)指标无法显示的问题。虽然前端SDK已经成功发送了包含INP数据的请求，并且服务器返回了200状态码，但在Sentry的Web Vitals面板中始终显示"无INP数据"。

技术分析

INP是Google提出的核心Web指标之一，用于衡量页面对用户交互的响应速度。在Sentry中，INP数据的收集和展示依赖于多个技术组件的协同工作：

1. 前端SDK：负责捕获用户交互事件并计算INP值
2. 后端处理：接收并处理SDK发送的性能数据
3. 数据存储：将处理后的指标存入ClickHouse数据库
4. 前端展示：从数据库查询并可视化INP数据

排查过程

1. 确认数据发送

首先需要确认前端SDK是否正确发送了INP数据。通过浏览器开发者工具的Network面板，可以观察到包含INP数据的请求确实被发送到了Sentry服务器，并且得到了200响应。

2. 检查功能标志

Sentry的许多功能都受功能标志控制。对于INP指标，需要确保以下关键功能标志已启用：

• organizations:insights-addon-modules
• projects:span-metrics-extraction-addons
• organizations:starfish-browser-webvitals-replace-fid-with-inp
• organizations:performance-vitals-inp

这些标志需要在sentry.conf.py配置文件中明确设置为True。

3. 数据库查询验证

通过直接查询ClickHouse数据库，可以验证INP数据是否被正确存储：

SELECT 
    project_id,
    transaction_name AS page,
    start_ts AS start_timestamp,
    finish_ts AS finish_timestamp,
    arrayJoin(measurements.key) AS measurement_key,
    arrayJoin(measurements.value) AS measurement_value
FROM 
    transactions_local
WHERE 
    arrayJoin(measurements.key) = 'inp'

4. 数据延迟问题

性能指标数据在Sentry中通常会有一定的处理延迟。INP数据可能需要几个小时甚至更长时间才会出现在仪表板中，这与Sentry的数据聚合和处理机制有关。

解决方案

1. 确保功能标志正确配置：参考Sentry官方文档或对应版本的sentry.conf.example.py文件，配置所有必要的功能标志。

2. 重新运行安装脚本：修改功能标志后，需要重新运行./install.sh脚本使配置生效。

3. 生成足够的数据量：INP指标可能需要积累一定数量的数据点才会显示。在生产环境中持续收集数据，通常24小时内会开始显示。

4. 升级SDK版本：确保使用较新版本的Sentry JavaScript SDK(建议8.7.0以上)。

5. 耐心等待：即使所有配置都正确，INP数据也可能需要一段时间才会出现在界面中。

经验总结

1. 功能标志是关键：Sentry的许多高级功能都依赖功能标志控制，必须确保相关标志已启用。

2. 数据延迟是常态：性能指标数据通常不会实时显示，需要理解Sentry的数据处理流程。

3. 生产环境验证更可靠：在测试环境中生成的数据量可能不足以触发指标显示，生产环境验证更有参考价值。

4. 数据库查询是终极验证：当界面显示有问题时，直接查询数据库可以确认数据是否确实存在。

通过系统性的排查和正确的配置，最终可以解决自建Sentry平台中INP指标不显示的问题，从而获得完整的Web性能监控能力。