This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.
EAS 观察仪表板
编辑页面
在 EAS 观察仪表板中查看性能指标，按平台、环境和版本筛选，并调查单个会话。
EAS Observe 仪表盘为你的应用性能指标提供可视化概览。在 EAS 仪表盘中打开你的项目，并从导航菜单中选择 Observe。
摘要
在页面顶部，仪表盘会显示当前视图中的数据摘要：活跃用户、发布、构建和更新。随着你更改筛选条件，这些计数会更新。点击 显示全部 可清除发布筛选，并查看所有发布的汇总计数。
筛选器
筛选器控制下方指标中包含哪些事件。
- 平台：Android 或 iOS。
- 环境：筛选到某个特定的 环境，例如
production或preview。默认是 所有环境。 - 时间范围：1 小时、12 小时、1 天、3 天、7 天、14 天、21 天、30 天或 60 天。默认是 最近 14 天。
- 发布：筛选到某个特定的应用版本、某个特定的原生构建或某个 OTA 更新。
页面
仪表盘将数据分为五个页面：
- 应用启动：启动性能指标（冷启动、热启动、包加载时间、首次渲染时间、可交互时间）。有关完整说明，请参阅 指标参考。
- EAS Update：OTA 更新的下载时间和每次更新的表格。详情请参阅 EAS Update 下载性能。
- 事件（需要 SDK 56 及更高版本）：使用
Observe.logEvent记录的用户自定义事件，以及 SDK 及其集成发出的事件（例如expo.memory.warning和expo-image.oversized），其中包含计数和用于深入查看每个事件的链接。 - 导航（需要 SDK 56 及更高版本）：每个路由的导航耗时，其中包含冷启动与热启动的首次渲染时间和可交互时间。需要使用 Expo Router 或 React Navigation。
- 错误（预览版）：应用在 SDK 57 及更高版本上记录的 JavaScript 错误，以及使用
expo-observe57.0.21 及更高版本记录的原生崩溃。详情请参阅 错误报告。
指标卡片
每个指标都会以带有图表和统计细分的卡片形式显示。对于每个指标，仪表盘都会展示：
- 中位数：中间值，代表典型的用户体验。
- 平均值：所有事件的算术平均值。
- 最小值 和 最大值：记录到的最快和最慢值。
- P90 和 P99：90% 或 99% 的事件低于这些值，有助于识别尾部延迟。
在“应用启动”页面上，可以在列表布局（每行一个图表）和网格布局之间切换。使用 显示构建 和 显示更新 开关，控制图表上是否显示发布标记。
发布标记与对比
当你发布新的原生构建或 OTA 更新时，每个图表都会在部署时间显示一个发布标记。时间轴上彼此接近的标记会合并为一个指示器，以保持图表清晰易读。
点击某个标记会打开一个弹出层，其中包含该发布的详细信息，包括版本、构建号或更新 ID、用户和事件数量，以及该时间点的指标值。从弹出层中可以进一步查看该发布的事件。
在没有发布筛选器的情况下，“应用启动”卡片还会在卡片顶部显示 最新 和 上一版 发布的指标。这样可以更容易一眼发现回归问题。
调查会话
当某些情况看起来不正常时，可以从 事件 页面或发布标记弹出层中深入查看单个会话。会话时间线会显示：
- 该会话期间记录的所有事件（启动、用户自定义和更新下载事件）。
- 设备元数据：平台、应用版本、构建号、操作系统和时间戳。
- 按类型划分的事件数量。
这有助于你了解为什么特定用户或设备会出现较慢的性能表现，以及问题是否与某个特定的操作系统版本、网络条件或发布有关。
使用 eas observe:session，也可以从终端查看相同的时间线。请参阅 使用 EAS CLI 查询。
Handoff to AI
使用页面标题栏中的 Handoff to AI 按钮，可将当前仪表盘状态复制为结构化提示词。将其粘贴到 Claude 或其他 AI 助手中，以便针对你看到的指标提问，例如某个发布为什么回归了，或者哪些路由最慢。