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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

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

use crate::resilience::{_clear_resilience_state_for_tests, _reset_resilience_for_tests};
use crate::testing::acquire_test_state_lock;

#[test]
fn health_test_increment_and_latency_roundtrip() {
    let _guard = acquire_test_state_lock();
    _reset_health_for_tests();

    crate::health::increment_dropped(Signal::Logs, 3);
    crate::health::increment_emitted(Signal::Traces, 5);
    crate::health::increment_retries(Signal::Metrics, 7);
    crate::health::record_export_failure(Signal::Logs);
    crate::health::record_export_latency(Signal::Traces, 12.5);

    let snapshot = get_health_snapshot();
    assert_eq!(snapshot.dropped_logs, 3);
    assert_eq!(snapshot.emitted_traces, 5);
    assert_eq!(snapshot.retries_metrics, 7);
    assert_eq!(snapshot.export_failures_logs, 1);
    assert!((snapshot.export_latency_ms_traces - 12.5).abs() < 1e-9);
}

/// Without this counter a sink that quietly refuses every receipt looks exactly
/// like one that delivers them, so the failure has to be visible somewhere the
/// receipt path itself can reach — and it cannot log.
#[test]
fn health_test_receipt_failures_are_counted() {
    let _guard = acquire_test_state_lock();
    _reset_health_for_tests();

    assert_eq!(get_health_snapshot().receipt_failures, 0);
    crate::health::increment_receipt_failures();
    crate::health::increment_receipt_failures();

    assert_eq!(get_health_snapshot().receipt_failures, 2);
}

#[test]
fn health_test_snapshot_reads_all_three_circuit_states() {
    let _guard = acquire_test_state_lock();
    _reset_health_for_tests();
    _reset_resilience_for_tests();

    let snapshot = get_health_snapshot();

    assert_eq!(snapshot.circuit_state_logs, "closed");
    assert_eq!(snapshot.circuit_state_traces, "closed");
    assert_eq!(snapshot.circuit_state_metrics, "closed");
    assert_eq!(snapshot.circuit_open_count_logs, 0);
    assert_eq!(snapshot.circuit_open_count_traces, 0);
    assert_eq!(snapshot.circuit_open_count_metrics, 0);
}

#[test]
fn health_test_snapshot_ignores_missing_circuit_states() {
    let _guard = acquire_test_state_lock();
    _reset_health_for_tests();
    _reset_resilience_for_tests();
    _clear_resilience_state_for_tests();

    let snapshot = get_health_snapshot();

    assert_eq!(snapshot.circuit_state_logs, "");
    assert_eq!(snapshot.circuit_state_traces, "");
    assert_eq!(snapshot.circuit_state_metrics, "");
}

/// Each signal's counter must actually add — a stuck-at-zero counter reports
/// "no executor ever stalled" forever, which is the one lie this counter
/// exists to prevent.
#[test]
fn health_test_async_blocking_risk_increments_per_signal() {
    let _guard = acquire_test_state_lock();
    _reset_health_for_tests();

    crate::health::increment_async_blocking_risk(Signal::Logs);
    crate::health::increment_async_blocking_risk(Signal::Traces);
    crate::health::increment_async_blocking_risk(Signal::Traces);
    crate::health::increment_async_blocking_risk(Signal::Metrics);
    crate::health::increment_async_blocking_risk(Signal::Metrics);
    crate::health::increment_async_blocking_risk(Signal::Metrics);

    let snapshot = get_health_snapshot();
    assert_eq!(snapshot.async_blocking_risk_logs, 1);
    assert_eq!(snapshot.async_blocking_risk_traces, 2);
    assert_eq!(snapshot.async_blocking_risk_metrics, 3);
}
// SPDX-FileCopyrightText: Copyright (C) 2026 provide.io llc
// SPDX-License-Identifier: Apache-2.0
// SPDX-Comment: Part of provide-telemetry.
//