用户体验监控支持通过 Sentry SDK 上报应用数据。对于已使用 Sentry 进行错误追踪和性能监控的用户，可将数据写入阿里云，并在用户体验监控控制台查看和分析。本文介绍 Sentry SDK 接入方案的适用场景、方案优势和整体架构。
适用场景
Sentry SDK 接入方案适用于以下场景：
场景 | 说明 |
新用户接入 | 使用 Sentry SDK 采集应用数据，利用阿里云用户体验监控的分析能力 |
自建 Sentry 迁移 | 已自建 Sentry 服务，希望降低运维成本，将数据存储迁移至阿里云 |
双平台观测 | 同时使用 Sentry 控制台和阿里云用户体验监控控制台进行数据分析 |
方案优势
降低运维成本
自建 Sentry 服务需要维护包含 Kafka、ClickHouse、Snuba 等组件在内的 70 余个容器服务。采用本方案后，核心数据存储和消息处理由阿里云托管，可大幅降低运维工作量。
高可用保障
数据存储链路托管于阿里云 SLS，具备高可用、高可靠的服务保障。
平滑迁移
支持 Nginx 流量镜像双写模式，可在不中断现有 Sentry 服务的前提下，逐步将数据同步至阿里云。
双平台统一观测
开发团队可继续使用 Sentry 控制台进行错误排查。
运维团队可在阿里云用户体验监控控制台进行统一监控和告警配置。
整体架构
本方案将 SLS 作为统一的数据底座，同时支持 Sentry 控制台和阿里云用户体验监控控制台进行数据查询。
数据写入链路
写入方式 | 说明 | 适用场景 |
SDK 直写 | 修改 Sentry SDK 的 DSN 配置，将数据直接上报至 SLS | 新用户接入、完成迁移后的存量用户 |
Nginx 双写 | 通过 Nginx 流量镜像，将数据同时发送至原 Sentry 服务和 SLS | 迁移过渡期，需验证数据完整性 |
数据读取链路
读取方式 | 说明 |
用户体验监控控制台 | 数据写入时自动转换为 RUM 标准格式，可直接在控制台查看 |
Sentry 控制台 | 部署定制版 Sentry Web 和 Snuba API 容器，从 SLS 读取数据 |
使用限制
限制项 | 说明 |
数据格式 | 仅支持 Sentry Envelope 协议格式，不支持旧版 Store 协议 |
Sentry SDK 版本 | 需使用支持 Envelope 协议的 SDK 版本，具体要求见下表 |
Sentry 控制台读取 | 需部署定制版容器，原生 Sentry 服务无法直接读取 SLS 数据 |
数据保留 | 数据保留时间默认 30 天 |
SDK 版本要求
本方案仅支持 Sentry Envelope 协议格式的数据上报。各平台 SDK 的最低版本要求如下：
SDK | 最低版本 | 说明 |
@sentry/vue | 7.0.0 | JavaScript SDK v7 起仅支持 Envelope 格式 |
@sentry/browser | 7.0.0 | JavaScript SDK v7 起仅支持 Envelope 格式 |
@sentry/react | 7.0.0 | JavaScript SDK v7 起仅支持 Envelope 格式 |
@sentry/node | 7.0.0 | JavaScript SDK v7 起仅支持 Envelope 格式 |
@sentry/electron | 4.0.0 | 底层依赖 JavaScript SDK v7 |
sentry-java（Android） | 3.0.0 | v3.0.0 起支持 Envelope 格式 |
sentry-cocoa（iOS/macOS） | 6.0.0 | v6.0.0 起支持 Envelope 格式 |
说明 如您当前使用的 SDK 版本低于上述要求，请先升级 SDK 后再接入。
后续步骤
完成方案了解后，您可以按以下步骤接入：
配置 Sentry SDK 数据写入：将 Sentry SDK 的数据上报至阿里云。
配置 Sentry 控制台读取用户体验监控数据（可选）：部署定制版容器，在 Sentry 界面查看数据。