provide-telemetry 0.7.0

Cross-language telemetry helpers with privacy, resilience, and OTLP support.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

// SPDX-FileCopyrightText: Copyright (C) 2026 provide.io llc
// SPDX-License-Identifier: Apache-2.0
// SPDX-Comment: Part of provide-telemetry.
//

use provide_telemetry::{
    counter, event, gauge, histogram, setup_telemetry, should_sample, shutdown_telemetry, Signal,
    TelemetryError,
};
use std::{f64::consts::PI, time::Instant};

#[derive(Debug, Clone, PartialEq)]
pub struct DemoSummary {
    pub counter_ns: f64,
    pub event_ns: f64,
    pub should_sample_ns: f64,
}

fn bench(mut op: impl FnMut(), iterations: usize) -> f64 {
    let start = Instant::now();
    for _ in 0..iterations {
        op();
    }
    start.elapsed().as_nanos() as f64 / iterations as f64
}

pub fn run_demo() -> Result<DemoSummary, TelemetryError> {
    let _ = shutdown_telemetry(None);
    setup_telemetry(None)?;
    let c = counter("perf.example.requests", Some("bench counter"), None);
    let g = gauge("perf.example.active", Some("bench gauge"), None);
    let h = histogram("perf.example.latency", Some("bench histogram"), Some("ms"));

    let counter_ns = bench(
        || {
            c.add(1.0, None);
            g.set(42.0, None);
            h.record(PI, None);
        },
        500,
    );
    let event_ns = bench(
        || {
            let _ = event(&["perf", "bench", "ok"]);
        },
        500,
    );
    let should_sample_ns = bench(
        || {
            let _ = should_sample(Signal::Logs, Some("perf.test"));
        },
        500,
    );
    shutdown_telemetry(None)?;
    Ok(DemoSummary {
        counter_ns,
        event_ns,
        should_sample_ns,
    })
}