kindlysdk/no.kindly.chatsdk.chat.core.metrics/MetricsService

MetricsService

Service for sending OpenTelemetry metrics to OTLP endpoint Completely failsafe - all operations are non-blocking and errors are silently handled Singleton object like SentryHelper for direct access

Functions

initialize

fun initialize(context: Context)

Initialize the metrics service. Should be called once during SDK initialization.

sendDeviceInfo

fun sendDeviceInfo()

Send device information metrics on SDK initialization

sendEvent

fun sendEvent(metric: MetricKeys, value: Long = 1, labels: Map<String, String> = emptyMap())

Send a metric event with optional labels COMPLETELY FAILSAFE - will never crash or block

sendGaugeMetric

fun sendGaugeMetric(metric: MetricKeys, value: Long, labels: Map<String, String> = emptyMap())

Send a gauge metric (for values that can go up or down) Used for things like duration, memory usage, active connections

setBotKey

fun setBotKey(key: String)

Update bot_key when SDK initializes

setBotName

fun setBotName(name: String)

Update bot_name when settings load

setChatId

fun setChatId(chatId: String)

Update chat_id when chat session starts

setEnabled

fun setEnabled(enabled: Boolean)

Enable or disable metrics sending (INTERNAL USE ONLY) Set synchronously to avoid race condition where sendEvent() checks isEnabled before the async coroutine has set it. This ensures metrics sent immediately after setEnabled(true) are not silently dropped.

setTrackAppLifecycle

fun setTrackAppLifecycle(enabled: Boolean)

Enable or disable app lifecycle event tracking (foreground/background) Call this when SDK starts (true) or disconnects (false)

shouldTrackAppLifecycle

fun shouldTrackAppLifecycle(): Boolean

Check if app lifecycle tracking is enabled

trackAPIRequest

fun trackAPIRequest(endpoint: String, method: String, statusCode: Int)

trackButtonClick

fun trackButtonClick(buttonId: String, screen: String)

trackChatMessage

fun trackChatMessage(direction: String, messageType: String, sender: String? = null)

trackCurrentScreenTap

fun trackCurrentScreenTap(x: Float, y: Float, screenWidth: Int, screenHeight: Int)

trackCustomEvent

fun trackCustomEvent(eventType: String, category: String? = null, action: String? = null, detail: String? = null)

trackError

fun trackError(errorType: String, errorCode: String? = null, screen: String? = null)

trackScreenTap

fun trackScreenTap(screenName: String, x: Float, y: Float, screenWidth: Int, screenHeight: Int)

trackScreenView

fun trackScreenView(screenName: String, previousScreen: String? = null, duration: Int? = null)

trackScroll

fun trackScroll(screenName: String, direction: String)

trackSessionEnd

fun trackSessionEnd(reason: String, duration: Int)

trackSessionStart

fun trackSessionStart()

trackSocketStatus

fun trackSocketStatus(status: String, reconnectAttempt: Int = 0)