Struct AnalyticsClient 

pub struct AnalyticsClient {
    pub backend_canister_id: Principal,
}

Client for recording metrics to an IC Metrics analytics canister.

Create once per canister and store in a thread_local!. All calls are fire-and-forget — they enqueue a one-way inter-canister call and return immediately without blocking execution.

Example

use ic_analytics_sdk::AnalyticsClient;
use candid::Principal;

thread_local! {
    static ANALYTICS: AnalyticsClient = AnalyticsClient::new(
        Principal::from_text("YOUR-ANALYTICS-CANISTER-ID").unwrap()
    );
}

Fields

backend_canister_id: Principal

Implementations

impl AnalyticsClient

pub fn new(backend_canister_id: Principal) -> Self

Creates a new client pointing at the given analytics canister.

pub fn record_metric(&self, metric: Metric) -> Result<(), String>

Enqueues a one-way call to record a metric. Non-blocking.

MetricValue::TimeSeries is automatically converted to Histogram { x: now_ms, y } using the current IC time before the call is sent.

Trait Implementations

impl Clone for AnalyticsClient

fn clone(&self) -> AnalyticsClient

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AnalyticsClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.