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 dashboard 上显示的所有内容，也可以通过终端获取。使用 eas observe 命令比较版本、调查缓慢的会话，并将结果传递给脚本。

前置条件

EAS CLI 帮助

运行任何命令时添加 --help，即可查看你所安装的 EAS CLI 版本支持的标志。

某些数据仅在特定方案中提供。如果你的账户方案不包含命令所请求的内容，该命令会失败，并显示链接到账单页面的升级提示。在交互式选择器运行之前，会先检查会话时间线，因此如果方案不支持，会立即报告。有关各方案包含的内容，请参阅定价。

命令

每条命令都支持以下标志：

• --platform android 或 --platform ios：按平台筛选。默认包含两个平台。observe:session 不支持此标志，因为该命令的目标已是单个会话。
• --days <number>：显示最近 N 天的数据。
• --start <ISO date> 和 --end <ISO date>：设置明确的时间范围。不能与 --days 同时使用。
• --project-id <id>：无需在项目目录中运行即可查询项目。
• --json：输出机器可读的数据。隐含启用 --non-interactive。
• --non-interactive：遇到需要提示的情况时直接失败。

未指定时间范围时，命令会返回最近 60 天的数据。

指标名称

应用完成埋点后，会自动收集启动指标。有关每项指标的含义，请参阅指标参考。

导航指标按路由统计。需要使用 SDK 56 或更高版本，并集成以下导航库之一：Expo Router 或 React Navigation。

observe:metrics 和 observe:metrics-summary 接受全部九个名称。observe:routes 接受三个导航指标名称。

eas observe:metrics-summary

显示按应用版本分组的汇总统计数据，每个平台各有一个表格。可用于比较不同版本的启动性能。

命令标志：

• --metric <name>：要显示的指标。重复该标志可指定多个指标。
• --stat <name>：要为每项指标显示的统计数据。可选值为 min、median、max、average、p80、p90、p99 或 eventCount。

默认情况下，表格显示 median 和 eventCount，并将它们合并到一个单元格中，例如 0.45s (150)。App version 列会在括号中包含构建编号。为保持表格易读，表格中省略了更新 ID，但 --json 会将它们作为每个版本对应的数组返回。

eas observe:metrics

显示单个样本，而不是汇总数据。可用于调查异常值并查找导致启动缓慢的会话。

指标是一个位置参数。省略该参数时，命令会提示你选择；在非交互模式下则会失败。

命令标志：

• --sort <order>：可选值为 oldest（默认值）、newest、slowest 或 fastest。
• --limit <number>：每页的样本数。默认为 10，最大为 100。
• --after <cursor>：上一次运行返回的 endCursor。
• --app-version <version>：按应用版本筛选。
• --update-id <id>：按 EAS Update ID 筛选。

如果还有更多结果，命令会输出用于获取下一页的标志。JSON 输出还会添加 sessionId、easClientId，以及附加到样本的任何自定义参数。

eas observe:routes

显示按路由名称分组的导航指标，每个平台都有单独的部分。可用于查找到达速度最慢的屏幕。

命令标志：

• --metric <name>：可选值为 nav_cold_ttr、nav_warm_ttr 或 nav_tti。重复该标志可指定多个指标。默认包含全部三项。
• --stat <name>：可选值为 median、p90 或 count。
• --route-name <name>：按路由名称筛选。重复该标志可指定多个路由。
• --app-version <version> 和 --build-number <number>：筛选单个版本。
• --update-id <id>：按 EAS Update ID 筛选。
• --limit <number>：每页显示的路由数。默认为 50，最大为 200。
• --after <cursor>：上一次运行返回的 endCursor。

路由名称是模式，例如 /(tabs)/sessions/[sessionId]，因此不同的参数值会归为一组。每个平台分别分页，因此下一页提示会注明其适用的平台。

eas observe:session

按顺序显示单个会话期间记录的所有指标和日志事件。observe:metrics 找到缓慢的样本后，可使用此命令查看该次启动期间还发生了什么。

会话 ID 是一个位置参数。在交互模式下省略该参数时，命令会提示你从候选会话列表中选择。在非交互模式下（包括使用 --json 时），必须提供会话 ID。observe:metrics 和 observe:events 的 --json 输出中也包含会话 ID。

命令标志：

• --event-name <name>：用于生成候选列表的指标或用户自定义事件，例如 tti 或 onboarding.completed。
• --sort <order>：对候选事件进行排序。可选值为 slowest、fastest、newest 或 oldest。

用于生成候选列表的标志——--event-name、--sort、--days、--start 和 --end——用于描述如何_查找_会话，因此不能与会话 ID 一起使用。要检查已有会话，请单独传入 ID。

eas observe:events

显示使用 Observe.logEvent 记录的用户自定义事件，以及 SDK 及其集成发出的事件，例如 expo.memory.warning 和 expo-image.oversized。不带参数时，会列出事件名称及其计数。

命令标志：

• --all-events：列出每个事件，而不是事件名称摘要。不能与事件名称同时使用。
• --session-id <id>：筛选单个会话。要查看包含指标在内的完整时间线，请使用 observe:session。
• --app-version <version>：按应用版本筛选。
• --update-id <id>：按 EAS Update ID 筛选。
• --limit <number> 和 --after <cursor>：对结果分页。

查询没有事件的名称时，会输出相同时间范围内可用的名称，便于发现拼写错误。

eas observe:versions

列出线上用户使用的应用版本及其构建编号、更新 ID 和事件数。可用于查找其他命令所需的筛选标识符。

表格显示应用版本、首次发现时间、事件数、用户数、构建版本和更新版本。JSON 输出会返回完整的层级结构，其中每个版本下嵌套了 EAS Build 和更新的详细信息。

常见工作流

比较当前版本与上一版本：

查找并调查启动最慢的会话：

检查哪些屏幕达到可交互状态最慢：

检查线上用户的空中更新下载情况：

根据指标控制脚本或 CI 任务：