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 is in Open Beta. The first 10,000 monthly active users are free. For higher usage, contact sales@expo.dev.

expo-observe is a library that collects performance metrics from your app and dispatches them to EAS Observe, a performance monitoring service from Expo, or to your preferred OpenTelemetry (OTEL)-compliant backend. It measures real-world startup performance, such as Time to First Render (TTR) and Time to Interactive (TTI), from apps running in production.

expo-observe is not available in Expo Go. To use it, create a development build.

Installation

If you are installing this in an existing React Native app, make sure to install expo in your project.

Configuration

In release builds, installing the expo-observe library is all that is needed to configure the library to start sending startup metrics (though you will need to follow the usage instructions below to call AppMetrics.markInteractive to track TTI). The library will not dispatch events in debug builds, but you can change this and other config options such as sample rate and environment name with the AppMetrics.configure({}) call. For all available options, see the EAS Observe configuration guide.

Usage

On SDK 55, wrap your root layout with AppMetricsRoot to measure Time to First Render automatically. Then, call AppMetrics.markInteractive when your app is ready for user interaction to record Time to Interactive:

import { AppMetrics, AppMetricsRoot } from 'expo-observe';
import { Stack } from 'expo-router';
import { useEffect } from 'react';

function RootLayout() {
  useEffect(() => {
    // Call markInteractive() after any initialization work behind the
    // splash screen completes.
    AppMetrics.markInteractive();
  }, []);

  return <Stack />;
}

export default AppMetricsRoot.wrap(RootLayout);

For step-by-step instructions, including how to handle apps with multiple entry screens, see the EAS Observe Get started guide.

User-defined events and the navigation integrations require SDK 56 and later.

API

import { AppMetrics, AppMetricsRoot } from 'expo-observe';

Component

Interfaces

import Observe from 'expo-observe';

Observe.configure({
  environment: 'production',
  dispatchingEnabled: true,
});

import Observe from 'expo-observe';

await Observe.dispatchEvents();

Types