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
  clientToken: "your-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.
  origin: "https://app.last9.io",

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

  // Unique per-install ID (NOT a hardware ID). Persists across launches.
  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);
    }
  }}
/>