This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.
EAS Observe 简介
编辑页面
EAS Observe 是一项性能监控服务，可跟踪你的应用在真实设备和各种条件下于生产环境中的表现。
重要 EAS Observe 处于开放测试版阶段。每月活跃用户的前 10,000 名免费。更高用量请联系 sales@expo.dev。
EAS Observe 是 Expo 提供的一项性能监控服务，用于跟踪你的应用在生产环境中的表现。它能让你了解真实世界中的启动时间、渲染性能，以及不同设备、网络和条件下的用户体验。
React Native 中的性能调试传统上仅限于开发工具。EAS Observe 关注的是生产环境，因为那里的性能特征与你在开发过程中看到的情况有很大不同。
了解 EAS Observe 如何从你的生产应用中，在不同设备、网络和条件下，呈现真实世界的启动和渲染性能。
快速开始
# 安装该库- npx expo install expo-observe使用 AppMetricsRoot 组件（SDK 55）或 ObserveRoot 组件（SDK 56 及更高版本）包裹你的根布局，并在应用准备好接受用户输入时调用 markInteractive()。完整设置指南请参见 开始使用。
面向 AI 代理的 Expo Skills
如果你使用 AI 代理，请安装 Expo Skills，教它如何设置 expo-observe 并查询应用的性能指标：
设置 expo-observe，使用 EAS CLI 查询指标，并解读启动和导航性能数据。
为什么选择 EAS Observe
传统的开发期分析工具展示的是应用在你自己机器上的表现。EAS Observe 展示的是它在真实用户环境中的表现：
- 生产环境性能数据：跟踪来自真实用户会话的启动时间、渲染性能和应用包加载时间，覆盖多种设备
- 版本对比：查看不同应用版本和 OTA 更新之间指标如何变化，以便尽早发现回归问题
- 会话调查：深入分析单个用户会话，了解为什么某些设备或条件会导致更慢的性能
- CLI 和仪表板访问：通过终端使用
eas observe:命令查询指标，或在 EAS 仪表板中查看它们
何时使用 EAS Observe
| 场景 | 建议 |
|---|---|
| 监控生产环境中的应用启动性能 | |
| 比较不同版本和 OTA 更新之间的性能 | |
| 调查特定设备上的慢会话 | |
| 通过 CLI 查询性能指标 | |
| 开发期分析与调试 | |
| 崩溃报告和错误跟踪 | |
| 自定义分析和事件跟踪 |
开发期分析与调试：使用 React Native DevTools 进行调试，并使用 Expo Atlas 检查 bundle。
崩溃报告和错误跟踪：这是 EAS Observe 未来计划添加的功能。目前我们建议使用 Sentry 或 BugSnag 等崩溃报告服务。
自定义分析和事件跟踪：这是 EAS Observe 未来计划添加的功能。目前请从 React Native 分析指南 中选择一个分析提供商，例如 PostHog、Amplitude 或 Firebase Analytics。
常见问题（FAQ）
EAS Observe 跟踪哪些指标？
EAS Observe 主要关注启动指标：冷启动时间、热启动时间、首次渲染时间、可交互时间以及 bundle 加载时间。有关每项指标的详细说明，请参阅 指标参考。
EAS Observe 是否可在 Expo Go 中使用？
不可以。EAS Observe 依赖于 expo-observe 原生库，而该库不包含在 Expo Go 中。要使用它，请创建一个 开发构建 或生产构建。
EAS Observe 会收集个人身份信息吗？
不会。用户通过一个匿名 ID 进行标识，该 ID 在每次应用安装中都是唯一的。此 ID 不可识别个人身份，且当用户卸载并重新安装应用时会重置。更多详情请参见指标参考：用户。
我可以在开发期间测试指标吗？
默认情况下，从调试构建中收集的指标不会发送。不过，你仍可以通过 configure() 将 dispatchInDebug 设置为 true 来进行测试。详情请参见配置。
入门
安装此库，并开始从你的生产应用中收集指标。
查看指标，按平台或版本筛选，并调查单个会话。
控制环境、发送机制以及开发模式设置。
每项指标、相关概念和数据处理方式的详细说明。