Flutter RUM SDK

const L9RumConfig config = L9RumConfig(
  // --- Required ---------------------------------------------------------
  baseUrl: 'https://otlp-ext-aps1.last9.io/v1/otlp/organizations/<org>',
  clientToken: 'your-client-token',
  serviceName: 'my-flutter-app',
  serviceVersion: '1.0.0',
  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: null,

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

  // Print debug logs to native console
  debugLogs: false,

  // Automatically instrument HTTP requests
  networkInstrumentation: true,

  // Automatically capture unhandled Dart 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,

  // Custom resource attributes added to every span
  resourceAttributes: <String, String>{
    'app.platform': 'flutter',
  },

  // Fine-grained network ignore rules. contains() uses substring matching;
  // regex() uses regex search semantics. Matched URLs are dropped before
  // span creation.
  ignorePatterns: L9NetworkIgnorePatterns(
    fullUrl: <L9UrlPattern>[
      L9UrlPattern.contains('https://cdn.example.com'),
      L9UrlPattern.regex(RegExp(r'^https://.*\.example\.com', caseSensitive: false)),
    ],
    pathname: <L9UrlPattern>[
      L9UrlPattern.contains('.pdf'),
      L9UrlPattern.contains('.jpg'),
      L9UrlPattern.regex(RegExp(r'^/internal/metrics')),
    ],
    hostname: <L9UrlPattern>[
      L9UrlPattern.contains('cdn.example.com'),
      L9UrlPattern.regex(RegExp(r'(^|\.)assets\.example\.com$', caseSensitive: false)),
    ],
  ),

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

  // W3C Baggage propagation on outgoing requests
  baggage: L9BaggageConfig(
    enabled: false,
    allowedKeys: <String>['session.id', 'user.id'],
    maxTotalBytes: 8192,
    warnAtPercentage: 80,
  ),
);

MaterialApp(
  navigatorObservers: <NavigatorObserver>[L9NavigationObserver()],
  // ...
);

await L9Rum.initialize(L9RumConfig(
  // ...required config
  ignorePatterns: L9NetworkIgnorePatterns(
    fullUrl: <L9UrlPattern>[
      L9UrlPattern.contains('https://cdn.example.com'),
      L9UrlPattern.regex(RegExp(r'^https://.*\.example\.com', caseSensitive: false)),
    ],
    pathname: <L9UrlPattern>[
      L9UrlPattern.contains('.pdf'),
      L9UrlPattern.contains('.jpg'),
      L9UrlPattern.regex(RegExp(r'^/internal/metrics')),
    ],
    hostname: <L9UrlPattern>[
      L9UrlPattern.contains('cdn.example.com'),
      L9UrlPattern.regex(RegExp(r'(^|\.)assets\.example\.com$', caseSensitive: false)),
    ],
  ),
  // preserve (default): keep traceparent on ignored requests.
  // strip: remove traceparent from ignored requests.
  propagationMode: L9PropagationMode.strip,
));

await L9Rum.identify(const L9UserInfo(
  id: 'user-123',
  name: 'Jane',
  email: 'jane@example.com',
  fullName: 'Jane Doe',
  roles: <String>['admin'],
));

await L9Rum.clearUser();

try {
  // risky operation
} catch (error, stackTrace) {
  await L9Rum.captureError(
    error,
    stackTrace: stackTrace,
    context: <String, dynamic>{'screen': 'checkout'},
  );
}

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await L9Rum.initialize(config);

  // Flutter framework errors
  FlutterError.onError = (FlutterErrorDetails details) {
    FlutterError.presentError(details);
    L9Rum.captureError(details.exception, stackTrace: details.stack);
  };

  // Platform dispatcher errors
  PlatformDispatcher.instance.onError = (Object error, StackTrace stack) {
    L9Rum.captureError(error, stackTrace: stack);
    return true;
  };

  // Async errors via zone
  runZonedGuarded(
    () => runApp(const MyApp()),
    (Object error, StackTrace stack) {
      L9Rum.captureError(error, stackTrace: stack);
    },
  );
}

await L9Rum.startView('ProductDetailsScreen');
await L9Rum.setViewName('Product #42');

await L9Rum.addEvent('purchase_completed', attributes: <String, dynamic>{
  'product_id': '12345',
  'amount': 29.99,
});

await L9Rum.spanAttributes(<String, dynamic>{
  'experiment': 'checkout_v2',
  'feature_flag': 'new_cart',
});

// Clear
await L9Rum.spanAttributes(null);

final String? sessionId = await L9Rum.getSessionId();

await L9Rum.flush();

import 'package:webview_flutter/webview_flutter.dart';
import 'package:last9_rum_flutter/last9_rum_flutter.dart';

final controller = WebViewController()
  ..setJavaScriptMode(JavaScriptMode.unrestricted)
  ..loadRequest(Uri.parse('https://app.example.com'));

L9Rum.instrumentWebView(controller);