Android / Kotlin

L9RumConfig(
    // --- 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-android-app",

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

    // Environment name
    deploymentEnvironment = "production",

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

    // Required for client_monitoring tokens. Use android://com.your.package.name —
    // must match the origin allowlist configured on your Last9 client token.
    origin = "android://com.example.myapp",

    // 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 logcat
    debugLogs = false,

    // Automatically trace HTTP requests via OkHttp interceptor
    networkInstrumentation = true,

    // Automatically capture unhandled exceptions
    errorInstrumentation = true,

    // Max spans per export batch
    maxExportBatchSize = 100,

    // Export timeout in milliseconds
    exportTimeoutMs = 30_000L,

    // Enable ANR (Application Not Responding) detection
    anrDetectionEnabled = true,

    // ANR threshold in milliseconds
    anrThresholdMs = 5_000L,

    // Periodically sample memory and CPU
    resourceMonitoringEnabled = true,

    // Interval between resource samples (ms)
    resourceSamplingIntervalMs = 30_000L,

    // 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 = mapOf(
        "app.platform" to "android",
    ),

    // W3C Baggage propagation on outgoing requests
    baggage = L9BaggageConfig(
        enabled = false,
        allowedKeys = listOf("session.id", "user.id"),
        maxTotalBytes = 8192,
        trackedUrlPatterns = emptyList(),
        warnAtPercentage = 80,
    ),

    // Substring patterns — matching URLs are skipped before span creation.
    // Prefer ignorePatterns below for regex support and hostname/pathname targeting.
    excludedUrlPatterns = listOf(".jpg", ".png", ".pdf", "cdn.example.com"),

    // Fine-grained network ignore rules. Matched URLs are dropped before span
    // creation. Strings use substring matching; L9UrlPattern.Regex uses regex
    // search semantics. Takes precedence over excludedUrlPatterns.
    ignorePatterns = L9NetworkIgnorePatterns(
        fullUrl = listOf(
            L9UrlPattern.Contains("https://cdn.example.com"),
            L9UrlPattern.Regex("^https://.*\\.example\\.com", flags = "i"),
        ),
        pathname = listOf(
            L9UrlPattern.Contains(".pdf"),
            L9UrlPattern.Contains(".jpg"),
            L9UrlPattern.Regex("^/internal/metrics"),
        ),
        hostname = listOf(
            L9UrlPattern.Contains("cdn.example.com"),
            L9UrlPattern.Regex("(^|\\.)assets\\.example\\.com$", flags = "i"),
        ),
    ),

    // Trace header propagation for ignored URLs.
    // PRESERVE (default): keep traceparent on ignored requests so downstream
    // services retain trace context.
    // STRIP: remove traceparent from ignored requests (e.g. third-party CDNs).
    propagationMode = L9PropagationMode.PRESERVE,
)

L9Rum.identify("user-123", mapOf(
    "email" to "user@example.com",
    "plan" to "premium",
))

L9Rum.clearUser()

try {
    // risky operation
} catch (e: Exception) {
    L9Rum.captureError(e, mapOf("screen" to "checkout"))
}

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

L9Rum.addEvent("purchase_completed", mapOf(
    "product_id" to "12345",
    "amount" to 29.99,
))

// Inject attributes into every span
L9Rum.spanAttributes(mapOf(
    "experiment" to "checkout_v2",
    "feature_flag" to "new_cart",
))

// Clear
L9Rum.spanAttributes(null)

val client = OkHttpClient.Builder()
    .let { L9Rum.instrumentOkHttp(it, context) }
    .build()

val client = OkHttpClient.Builder()
    .certificatePinner(existingPinner)   // SSL pinning unchanged
    .let { L9Rum.instrumentOkHttp(it, context) }
    .build()

val sessionId: String? = L9Rum.getSessionId()

L9Rum.flush()

import io.last9.rum.L9NetworkIgnorePatterns
import io.last9.rum.L9UrlPattern

L9Rum.initialize(
    this,
    L9RumConfig(
        // ...required config
        ignorePatterns = L9NetworkIgnorePatterns(
            fullUrl = listOf(
                L9UrlPattern.Contains("https://cdn.example.com"),
                L9UrlPattern.Regex("^https://.*\\.example\\.com", flags = "i"),
            ),
            pathname = listOf(
                L9UrlPattern.Contains(".pdf"),
                L9UrlPattern.Contains(".jpg"),
                L9UrlPattern.Regex("^/internal/metrics"),
            ),
            hostname = listOf(
                L9UrlPattern.Contains("cdn.example.com"),
                L9UrlPattern.Regex("(^|\\.)assets\\.example\\.com$", flags = "i"),
            ),
        ),
        // PRESERVE (default): keep traceparent on ignored requests.
        // STRIP: remove traceparent from ignored requests.
        propagationMode = L9PropagationMode.PRESERVE,
    ),
)

// After inflating the WebView — call once per WebView instance.
L9Rum.instrument(webView)