AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

eas-observe

Use for anything related to EAS Observe - adding `expo-observe` to an Expo project (AppMetricsRoot/ObserveRoot HOC, markInteractive and ObserveInteractiveMarker, the useObserve hook, the Expo Router / React Navigation integrations for per-route metrics, the expo-image and Reanimated integrations, user-defined events via `Observe.logEvent`, error reporting via ObserveErrorBoundary and `Observe.reportError`, native crash reporting, source map upload for symbolicated stack traces, and runtime config such as sampleRate and dispatchInDebug), querying via the EAS CLI (`eas observe:metrics-summary`, `observe:metrics`, `observe:routes`, `observe:events`, `observe:session`, `observe:versions`, `observe:errors`, `observe:event`) or the Expo MCP `observe_*` tools, interpreting the resulting metrics (cold/warm launch, TTR, TTI, navigation cold/warm TTR, update download, and the TTI frameRate/device/network params for triaging slow startups), or shipping an Observe integration inside a third-party package.

Original source
expo
License
MIT
Pinned revision
05754e71d02abe0d2d7a2fb5259ccac41f5ea59c

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read expo--eas-observe at revision 05754e71d02abe0d2d7a2fb5259ccac41f5ea59c, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 6

references/setup.md · 24000

s collected from debug builds. No effect on release builds. | | sampleRate | number | undefined (all installations) | Fraction of installations that dispatch, in [0, 1]. | | errorHandlingEnabled | boolean | true | Record unhandled JS errors as exception events. | | integrations | object | undefined | Opt in to expo-router, react-navigation, expo-image, react-native-reanimated, or a third-party integration. For expo-image and react-native-reanimated, see ./library-integrations.md. |

Network request monitoring is automatic and has no off switch. expo-observe observes URLSession traffic on iOS and OkHttpClient traffic on Android from launch, and attaches a rollup of the launch window to the TTI event — including the host of the slowest request (see ./metrics.md). Observe's own uploads are excluded. No configure() option disables it as of expo-observe 57.0.9, so treat request hosts as data that leaves the device.

Sampling is deterministic per installation: an installation is permanently in-sample or out-of-sample for a given rate, so the slice is stable across launches rather than a random subset of sessions. Out-of-sample installations drop pending metrics instead of accumulating them, so lowering the rate later does not retroactively send earlier sessions. Values outside [0, 1] are clamped. Sampling depends on dispatchingEnabled.

Manual flush. Events dispatch automatically when the app backgrounds — on Android through a background worker once connectivity returns, on iOS when the app resigns active or is about to terminate. Call await Observe.dispatchEvents() to flush early, which is mainly useful while testing.

Custom endpoint. EAS Observe sends OTLP over HTTP with a JSON payload, posting to <endpointUrl>/<project-id>/v1/metrics and <endpointUrl>/<project-id>/v1/logs. Point it at any OpenTelemetry-compatible backend or collector through the app config, not configure():

{ "expo": { "extra": { "eas": { "observe": { "endpointUrl": "https://your-endpoint.com" } } } } }

The URL is baked into the native layer at build time, so run npx expo prebuild and rebuild after changing it. If the backend expects standard OTLP paths without the project-ID prefix, route through a collector.

Quick checklist

  • [ ] SDK ≥ 55, EAS project linked, development or production build (not Expo Go).
  • [ ] expo-observe installed via npx expo install.
  • [ ] Root component exported through AppMetricsRoot.wrap(...) (SDK 55) or ObserveRoot.wrap(...) (SDK 56+).
  • [ ] markInteractive() called from every entry screen once it is genuinely interactive — global AppMetrics.markInteractive() on SDK 55, or useObserve() hook on SDK 56+.
  • [ ] (Optional, SDK 56+) Per-route metrics enabled via Observe.configure({ integrations: { ... } }), plus <ObserveNavigationContainer> (dynamic) or <ObserveNavigationProvider> (static) for React Navigation.
  • [ ] (Optional, SDK 57+) Sensitive route/query params listed in filteredParams.
  • [ ] (Optional, SDK 56+) User-defined events emitted via Observe.logEvent(name, { attributes }) with stable, lowercase, dot-separated names and no PII.
  • [ ] (Optional) Library problem reports enabled via integrations: { 'expo-image': true } (SDK 57+) or integrations: { 'react-native-reanimated': true } (SDK 58+, Reanimated 4.7.0+), with no configureReanimatedLogger call in the app. See ./library-integrations.md.
  • [ ] (Optional, SDK 57+) <ObserveErrorBoundary> (or errorBoundaryFallback on ObserveRoot) around risky subtrees, Observe.reportError in recovery paths, "uploadSourceMaps": true in the eas.json build profile, and eas update --upload-source-maps when publishing updates.
  • [ ] New build produced with eas build and metrics visible in the Observe dashboard.