EAS Observe
EAS 서비스 – 비용이 부과됩니다. EAS Observe는 Expo Application Services의 제품입니다. 무료 EAS 플랜은 제한된 기능과 함께 최대 10,000명의 월간 활성 사용자를 허용하며, 더 많은 사용량은 유료 구독이 필요합니다. 자세한 내용은 https://expo.dev/pricing#plan-features 를 참조하세요.
EAS Observe는 프로덕션 Expo 앱의 시작, 탐색 및 사용자 정의 이벤트 성능을 추적하고, JavaScript 오류 및 네이티브 크래시를 기록합니다. 개발 또는 프로덕션 빌드가 필요합니다 — 네이티브 라이브러리는 Expo Go에 포함되어 있지 않습니다.
진리의 원천: https://docs.expo.dev/eas/observe/ — API 세부사항이 중요할 때(특히 시작하기, 설정, 통합, 지표 참조)는 항상 공식 문서를 확인하세요. EAS Observe는 계속 진화 중이며, 이 스킬의 참조는 정확성을 유지하기 위해 작성되었지만 공식 문서보다 뒤처질 수 있습니다.
어떤 참조 문서를 읽을까요
./references/ 디렉토리에 있는 네 개의 참조 파일은 이 스킬이 일반적으로 필요한 작업을 다룹니다:
- 프로젝트에 EAS Observe 추가하기 →
./references/setup.md. 설치, 루트 레이아웃 래핑 (SDK 55에서는AppMetricsRoot, SDK 56+에서는ObserveRoot), 앱 인터랙티브 표시 (SDK 55에서는 전역markInteractive(), SDK 56+에서는useObserve()훅 또는<ObserveInteractiveMarker />), Expo Router / React Navigation 통합을 통한 선택적 경로별 탐색 지표,Observe.logEvent를 통한 사용자 정의 이벤트 (SDK 56+), 오류 보고, 런타임 설정 (샘플링, 디스패치, 환경, 사용자 정의 엔드포인트). - 터미널에서 지표 조회하기 →
./references/queries.md.eas observe:*명령어 —metrics-summary,metrics,routes,events,session,versions,errors,event— 플래그, 지표 별칭, 테이블 레이아웃, JSON 형태 및 일반적인 워크플로와 함께. - 대시보드 또는 CLI 출력 읽기 →
./references/metrics.md. 지표별 목표 임계값, 자동 TTI 매개변수(frameRate.*,device.*,network.*)의 의미, 느리지만 부드러운 시작과 메인 스레드 경합, 하드 블록, 또는 제한된 장치를 구별하는 진단 패턴. - 라이브러리에 Observe 통합 제공하기 →
./references/third-party.md. 패키지 작성자 전용 (SDK 57+): 선택적 피어 종속성, 설정 선언 병합,Observe.registerIntegration(), 이벤트 명명.
문서 빠른 링크
- 시작하기: https://docs.expo.dev/eas/observe/get-started/
- 대시보드 가이드: https://docs.expo.dev/eas/observe/dashboard/
- EAS CLI로 조회: https://docs.expo.dev/eas/observe/eas-cli/
- 지표 참조: 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/errors/
- 설정: https://docs.expo.dev/eas/observe/configuration/
- 서드파티 통합: https://docs.expo.dev/eas/observe/integrations/third-party/
- EAS 업데이트 다운로드 성능: https://docs.expo.dev/eas/observe/eas-update/
- 문제 해결: https://docs.expo.dev/eas/observe/reference/troubleshooting/
피드백 제출
이 스킬에서 오류, 오해의 소지가 있거나 오래된 정보를 발견하면, Expo가 개선할 수 있도록 보고해 주세요:
npx --yes @expo/agent-cli@latest feedback --category skills --subject "eas-observe" "<구체적인 피드백>"
구체적이고 실행 가능한 내용이 있을 때만 제출하세요. 관련 컨텍스트를 최대한 많이 포함하세요.
에이전트가 Expo 작업에서 반복적으로 실패하거나 사용자가 개입해야 하는 경우, 작업, 예상 결과 및 발생한 문제에 대한 간단한 보고서를 --category evals와 관련 Expo 패키지 또는 명령어를 --subject로 사용하여 제출하세요.