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。

🌐 The EAS Observe dashboard provides a visual overview of your app's performance metrics. Open your project in the EAS dashboard and select Observe from the navigation menu.

概括

🌐 Summary

在页面顶部，仪表板显示正在查看的数据摘要：活跃用户、版本、构建和更新。随着你更改筛选条件，计数会更新。点击 显示全部 可以清除版本筛选并查看所有版本的汇总计数。

🌐 At the top of the page, the dashboard shows a summary of the data in view: active users, releases, builds, and updates. The counts update as you change filters. Click Show all to clear release filtering and see aggregate counts across every release.

过滤器

🌐 Filters

过滤器控制哪些事件被包含在下面的指标中。

🌐 Filters control which events are included in the metrics below.

• 平台：Android 或 iOS。
• 环境：过滤到特定的环境，例如 production 或 preview。默认是所有环境。
• 时间范围：1 小时、12 小时、1 天、3 天、7 天、14 天、21 天、30 天或 60 天。默认为 过去 14 天。
• 版本发布：筛选到特定的应用版本、特定的原生构建或特定的OTA更新。

选项卡

🌐 Tabs

仪表板将数据分为四个选项卡：

🌐 The dashboard groups data into four tabs:

• 应用启动：启动性能指标（冷启动、热启动、包加载时间、首次渲染时间、可交互时间）。完整描述请参见指标参考。
• EAS 更新：OTA 更新的下载时间及每次更新的表格。详情见 EAS 更新下载性能。
• 事件（需要 SDK 56 及更高版本）：通过 Observe.logEvent 记录的用户自定义事件，包含计数和可深入查看每个事件的链接。
• 导航（需要 SDK 56 及更高版本）：每条路线的导航时间，包括冷启动与热启动的首次渲染时间和可交互时间。需要 Expo Router 或 React Navigation。

度量卡

🌐 Metric cards

每个指标以卡片形式显示，包含图表和统计细分。对于每个指标，仪表板显示：

🌐 Each metric appears as a card with a chart and statistical breakdowns. For every metric, the dashboard displays:

• 中位数：中间值，代表典型的用户体验。
• 平均：所有事件的算术平均值。
• 最小值和最大值：记录的最快和最慢数值。
• P90 和 P99：低于这些值的事件分别占 90% 或 99%，用于识别尾部延迟。

在应用启动标签上，可以在列表布局（每行一个图表）和网格布局之间切换。使用 显示版本 和 显示更新 切换按钮来控制图表上是否显示发布标记。

🌐 On the App startup tab, switch between a list layout (one chart per row) and a grid layout. Use the Show builds and Show updates toggles to control whether release markers appear on charts.

释放标记和比较

🌐 Release markers and comparison

当你发布新的原生构建或 OTA 更新时，每个图表都会在部署时间显示一个发布标记。时间轴上靠得很近的标记会合并为一个指标，以保持图表的可读性。

🌐 When you publish a new native build or OTA update, each chart shows a release marker at the deployment time. Markers that fall close together on the time axis group into a single indicator to keep charts readable.

点击一个标记以打开显示该版本详细信息的弹出窗口，包括版本号、构建号或更新 ID、用户和事件数量，以及该点的指标值。通过弹出窗口，可以深入查看该版本的事件。

🌐 Click a marker to open a popover with details for that release, including the version, build number or update ID, user and event counts, and the metric value at that point. From the popover, drill into the events for that release.

如果没有发布筛选器，应用启动卡还会在卡片顶部显示最新和前一次发布的指标。这使得回归问题能够一眼就被发现。

🌐 Without a release filter, App startup cards also show the metric for the latest and previous releases at the top of the card. This makes regressions easier to spot at a glance.

调查会议

🌐 Investigating sessions

当某些东西看起来不对时，可以从 事件 标签或发布标记弹出窗口深入查看单个会话。会话时间轴显示：

🌐 When something looks off, drill into individual sessions from the Events tab or from a release marker popover. A session timeline shows:

• 在该会话期间记录的所有事件（启动、用户定义和更新下载事件）。
• 设备元数据：平台、应用版本、构建号、操作系统和时间戳。
• 按类型统计的事件数量。

这可以帮助你理解为什么特定用户或设备会遇到性能较慢的问题，无论是特定的操作系统版本、网络状况还是发布版本。

🌐 This helps you understand why specific users or devices experience slower performance, whether it's a particular OS version, network condition, or release.

交给人工智能

🌐 Handoff to AI

使用页面标题中的 Handoff to AI 按钮，将当前仪表板状态复制为结构化提示。将其粘贴到 Claude 或其他 AI 助手中，询问关于你正在查看的指标的问题，例如为什么某个版本出现回退，或哪些路线最慢。

🌐 Use the Handoff to AI button in the page header to copy the current dashboard state as a structured prompt. Paste it into Claude or another AI assistant to ask questions about the metrics you're seeing, such as why a particular release regressed or which routes are slowest.