EAS Observe 简介

编辑页面

EAS Observe 是一项性能监控服务,可跟踪你的应用在真实设备和各种条件下于生产环境中的表现。


For the complete documentation index, see llms.txt. Use this file to discover all available pages.

重要 EAS Observe 处于开放测试版阶段。每月活跃用户的前 10,000 名免费。更高用量请联系 sales@expo.dev

EAS Observe 是 Expo 提供的一项性能监控服务,用于跟踪你的应用在生产环境中的表现。它能让你了解真实世界中的启动时间、渲染性能,以及不同设备、网络和条件下的用户体验。

React Native 中的性能调试传统上仅限于开发工具。EAS Observe 关注的是生产环境,因为那里的性能特征与你在开发过程中看到的情况有很大不同。

快速开始

Terminal
# 安装该库
npx expo install expo-observe

使用 AppMetricsRoot 组件(SDK 55)或 ObserveRoot 组件(SDK 56 及更高版本)包裹你的根布局,并在应用准备好接受用户输入时调用 markInteractive()。完整设置指南请参见 开始使用

为什么选择 EAS Observe

传统的开发期分析工具展示的是应用在你自己机器上的表现。EAS Observe 展示的是它在真实用户环境中的表现:

  • 生产环境性能数据:跟踪来自真实用户会话的启动时间、渲染性能和 bundle 加载时间,覆盖多种设备
  • 版本对比:查看不同应用版本和 OTA 更新之间指标如何变化,以便尽早发现回归问题
  • 会话调查:深入分析单个用户会话,了解为什么某些设备或条件会导致更慢的性能
  • CLI 和仪表板访问:通过终端使用 eas observe: 命令查询指标,或在 EAS 仪表板中查看它们

何时使用 EAS Observe

场景建议
监控生产环境中的应用启动性能
比较不同版本和 OTA 更新之间的性能
调查特定设备上的慢会话
通过 CLI 查询性能指标
开发期分析与调试
崩溃报告和错误跟踪
自定义分析和事件跟踪

开发期分析与调试:使用 React Native DevTools 进行调试,并使用 Expo Atlas 检查 bundle。

崩溃报告和错误跟踪:这是 EAS Observe 未来计划添加的功能。目前我们建议使用 SentryBugSnag 等崩溃报告服务。

自定义分析和事件跟踪:这是 EAS Observe 未来计划添加的功能。目前请从 React Native 分析指南 中选择一个分析提供商,例如 PostHog、Amplitude 或 Firebase Analytics。

常见问题(FAQ)

EAS Observe 跟踪哪些指标?

EAS Observe 主要关注启动指标:冷启动时间、热启动时间、首次渲染时间、可交互时间以及 bundle 加载时间。有关每项指标的详细说明,请参阅 指标参考

支持哪些平台?

EAS Observe 支持 Android 和 iOS。指标会从生产构建中收集,并可在仪表板和 CLI 中按平台筛选。

EAS Observe 会收集个人身份信息吗?

不会。用户通过一个匿名 ID 进行标识,该 ID 在每次应用安装中都是唯一的。此 ID 不可识别个人身份,且当用户卸载并重新安装应用时会重置。更多详情请参见指标参考:用户

设备离线时会发生什么?

离线期间收集的指标会存储在设备本地。当应用切换到后台且网络连接可用时,它们会自动发送。你也可以使用 dispatchEvents() 手动刷新事件。

我可以在开发期间测试指标吗?

默认情况下,从调试构建中收集的指标不会发送。不过,你仍可以通过 configure()dispatchInDebug 设置为 true 来进行测试。详情请参见配置

指标数据会保留多久?

指标数据至少保留 60 天。

入门

设置 EAS Observe

安装此库,并开始从你的生产应用中收集指标。

EAS Observe 仪表板

查看指标,按平台或版本筛选,并调查单个会话。

配置

控制环境、发送机制以及开发模式设置。

指标参考

每项指标、相关概念和数据处理方式的详细说明。