eas-observe

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

EAS Observe

EAS service - costs apply. EAS Observe is a paid Expo Application Services product with free-tier limits. Ingesting and querying production metrics counts against your plan's event/usage allowance. Review https://expo.dev/pricing before enabling it in production.

EAS Observe tracks startup, navigation, and custom-event performance from production Expo apps.

Source of truth: https://docs.expo.dev/eas/observe/ — always consult the canonical docs when API details matter, especially get-started, configuration, integrations, and the metrics reference. EAS Observe is evolving; this skill's references are written to stay accurate but may lag the docs.

EAS服务 - 需付费使用。 EAS Observe是Expo Application Services旗下的付费产品，提供免费额度。采集和查询生产环境指标会消耗您套餐的事件/使用额度。在生产环境启用前，请查看https://expo.dev/pricing。

EAS Observe用于追踪Expo生产应用的启动、导航和自定义事件性能。

权威来源： https://docs.expo.dev/eas/observe/ — 当涉及API细节时，请务必参考官方文档，尤其是入门指南、配置、集成和指标参考部分。EAS Observe仍在迭代中；本技能的参考内容力求准确，但可能会滞后于官方文档。

Which reference to read

选择合适的参考文档

The three reference files in

./references/

cover the three things people typically need this skill for:

Adding EAS Observe to a project →
```
./references/setup.md
```
. Install, wrap the root layout (
```
AppMetricsRoot
```
on SDK 55,
```
ObserveRoot
```
on SDK 56+), call
```
markInteractive()
```
(global on SDK 55, via the
```
useObserve()
```
hook on SDK 56+), optional per-route navigation metrics through the Expo Router / React Navigation integrations, and user-defined events via
```
Observe.logEvent
```
(SDK 56+).
Querying metrics from the terminal →
```
./references/queries.md
```
. The five
```
eas observe:*
```
commands —
```
metrics-summary
```
,
```
metrics
```
,
```
routes
```
,
```
events
```
,
```
versions
```
— with flags, table layouts, JSON shapes, and common workflows.
Reading a dashboard or CLI output →
```
./references/metrics.md
```
. Target thresholds per metric, what the TTI
```
frameRate.*
```
params mean, and diagnostic patterns for telling slow-but-smooth startup apart from main-thread contention or hard blocks.

./references/

目录下的三份参考文档分别对应人们使用该技能的三类典型需求：

在项目中集成EAS Observe →
```
./references/setup.md
```
。包括安装依赖、包裹根布局（SDK 55使用
```
AppMetricsRoot
```
，SDK 56+使用
```
ObserveRoot
```
）、调用
```
markInteractive()
```
方法（SDK 55为全局方法，SDK 56+通过
```
useObserve()
```
钩子调用）、可选的基于路由的导航指标（通过Expo Router/React Navigation集成），以及通过
```
Observe.logEvent
```
自定义事件（SDK 56+支持）。
通过终端查询指标 →
```
./references/queries.md
```
。介绍5个
```
eas observe:*
```
命令——
```
metrics-summary
```
、
```
metrics
```
、
```
routes
```
、
```
events
```
、
```
versions
```
——包括命令参数、表格布局、JSON格式以及常见使用流程。
解读仪表盘或CLI输出 →
```
./references/metrics.md
```
。包括各指标的目标阈值、TTI的
```
frameRate.*
```
参数含义，以及区分“缓慢但流畅的启动”与“主线程竞争”或“阻塞”问题的诊断方法。

Quick links to the docs

官方文档快速链接

Get started: https://docs.expo.dev/eas/observe/get-started/
Dashboard guide: https://docs.expo.dev/eas/observe/dashboard/
Metrics reference: https://docs.expo.dev/eas/observe/reference/metrics/
Expo Router integration: https://docs.expo.dev/eas/observe/integrations/expo-router/
React Navigation integration: https://docs.expo.dev/eas/observe/integrations/react-navigation/
User-defined events: https://docs.expo.dev/eas/observe/events/
Configuration: https://docs.expo.dev/eas/observe/configuration/

入门指南：https://docs.expo.dev/eas/observe/get-started/
仪表盘指南：https://docs.expo.dev/eas/observe/dashboard/
指标参考：https://docs.expo.dev/eas/observe/reference/metrics/
Expo Router集成：https://docs.expo.dev/eas/observe/integrations/expo-router/
React Navigation集成：https://docs.expo.dev/eas/observe/integrations/react-navigation/
自定义事件：https://docs.expo.dev/eas/observe/events/
配置说明：https://docs.expo.dev/eas/observe/configuration/