React Native RUM SDK

L9Rum.initialize({
  // --- Required ---------------------------------------------------------

  // OTLP collector endpoint
  baseUrl: "https://otlp-ext-aps1.last9.io/v1/otlp/organizations/<org>",

  // Authentication token from Last9 — use the Android or iOS Client token
  // for the platform this build is running on.
  clientToken: Platform.OS === "ios"
    ? "your-ios-client-token"
    : "your-android-client-token",

  // Application identifier (maps to service.name)
  serviceName: "my-rn-app",

  // App version string (maps to service.version)
  serviceVersion: "1.0.0",

  // Environment name
  deploymentEnvironment: "production",

  // --- Optional ---------------------------------------------------------

  // Origin sent as X-LAST9-ORIGIN header. Required for client_monitoring
  // tokens. Must match the origin on the platform's Client token —
  // android://<package> on Android, ios://<bundle-id> on iOS. Pass the
  // matching clientToken for the same platform. Needs `import { Platform }
  // from "react-native"` as shown in the Installation section above.
  origin: Platform.OS === "ios"
    ? "ios://com.yourcompany.yourapp"
    : "android://com.yourcompany.yourapp",

  // Specific build identifier (maps to app.build_id)
  appBuildId: "1.0.0-build-42",

  // Optional override for the app.installation.id resource attribute.
  // The Client-ID header always uses the native SDK-generated per-install UUID.
  appInstallationId: undefined,

  // Session sampling rate: 0-100 (percentage). 100 = sample everything.
  sampleRate: 100,

  // Print debug logs to console
  debugLogs: false,

  // Automatically instrument network requests through native hooks
  networkInstrumentation: true,

  // Automatically capture unhandled JS errors
  errorInstrumentation: true,

  // Max spans per export batch
  maxExportBatchSize: 100,

  // Export timeout in milliseconds
  exportTimeoutMs: 30000,

  // ANR detection (Android only)
  anrDetectionEnabled: true,
  anrThresholdMs: 5000,

  // Periodically sample memory and CPU
  resourceMonitoringEnabled: true,
  resourceSamplingIntervalMs: 30000,

  // Setting this to true will hide network requests (and their
  // DNS/TCP/TLS/TTFB phase child spans) from the Last9 dashboard's
  // Sessions → APIs tab. Each request would get its own traceId
  // instead of sharing the current view's traceId, and that tab
  // only fetches spans that share the View's traceId. Keep this
  // false unless you specifically need per-request trace isolation.
  isolateTracePerRequest: false,

  // Fine-grained network ignore rules. Strings use substring matching;
  // RegExp uses regex search semantics. Matched URLs are dropped before
  // span creation.
  ignorePatterns: {
    fullUrl: ["https://cdn.example.com", /^https:\/\/.*\.example\.com/i],
    pathname: [".pdf", ".jpg", /^\/internal\/metrics/],
    hostname: ["cdn.example.com", /(^|\.)assets\.example\.com$/i],
  },

  // 'preserve' (default): keep traceparent on ignored requests.
  // 'strip': remove traceparent from ignored requests.
  propagationMode: "preserve",

  // Custom resource attributes added to every span
  resourceAttributes: {
    "app.platform": "react-native",
  },

  // W3C Baggage propagation on outgoing requests
  baggage: {
    enabled: false,
    allowedKeys: ["session.id", "user.id"],
    maxTotalBytes: 8192,
    warnAtPercentage: 80,
  },
});

L9Rum.initialize({
  ignorePatterns: {
    fullUrl: ["https://cdn.example.com", /^https:\/\/.*\.example\.com/i],
    pathname: [".pdf", ".jpg", /^\/internal\/metrics/],
    hostname: ["cdn.example.com", /(^|\.)assets\.example\.com$/i],
  },
  // 'preserve' (default): keep traceparent on ignored requests.
  // 'strip': remove traceparent from ignored requests.
  propagationMode: "strip",
});

import { L9ReactNavigationInstrumentation } from '@last9/rum-react-native';
import { NavigationContainer } from '@react-navigation/native';

function App() {
  return (
    <NavigationContainer
      onStateChange={L9ReactNavigationInstrumentation.onStateChange}
    >
      {/* screens */}
    </NavigationContainer>
  );
}

L9Rum.identify({
  id: "user-123",
  name: "Jane",
  email: "jane@example.com",
  fullName: "Jane Doe",
  roles: ["admin"],
});

L9Rum.clearUser();

try {
  // risky operation
} catch (error) {
  L9Rum.captureError(error, { screen: "checkout" });
}

L9Rum.startView("ProductDetailsScreen");
L9Rum.setViewName("Product #42");

L9Rum.addEvent("purchase_completed", {
  product_id: "12345",
  amount: 29.99,
});

L9Rum.spanAttributes({
  experiment: "checkout_v2",
  feature_flag: "new_cart",
});

// Clear
L9Rum.spanAttributes(null);

const sessionId = await L9Rum.getSessionId();

L9Rum.flush();

import { useRef } from 'react';
import { WebView } from 'react-native-webview';
import { L9Rum } from '@last9/rum-react-native';

const webViewRef = useRef<WebView>(null);

<WebView
  ref={webViewRef}
  source={{ uri: 'https://app.example.com' }}
  onLoad={() => {
    if (webViewRef.current) {
      L9Rum.instrumentWebView(webViewRef);
    }
  }}
/>