auths-telemetry 0.1.3

Telemetry and metrics for Auths components.
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

//! Auths Telemetry
//!
//! Centralized security event API for SIEM ingestion. Provides a unified,
//! deterministic telemetry standard consumed by auths-auth-server,
//! auths-registry-server, and auths-chat-server.

pub mod config;
pub mod emitter;
pub mod event;
pub mod logging;
pub mod metrics;
pub mod ports;
pub mod sinks;

pub use emitter::{
    DROPPED_AUDIT_EVENTS, TelemetryShutdown, emit_telemetry, init_telemetry_with_sink,
};
pub use event::{AuditEvent, build_audit_event};
pub use logging::{init_json_tracing, init_tracing};
pub use metrics::{PrometheusHandle, init_prometheus};
pub use ports::EventSink;

#[cfg(any(test, feature = "test-utils"))]
#[allow(clippy::unwrap_used, clippy::expect_used)]
pub mod testing;

/// Initialises JSON tracing and the Prometheus metrics recorder.
///
/// Call once at process startup before any metrics or tracing macros are invoked.
/// Returns the Prometheus render handle used by the `/metrics` HTTP handler.
///
/// Args:
/// * `log_level`: Fallback log level (e.g. `"info"`). Overridden by `RUST_LOG`.
///
/// Usage:
/// ```ignore
/// let handle = std::sync::Arc::new(auths_telemetry::init_observability("info"));
/// ```
pub fn init_observability(log_level: &str) -> PrometheusHandle {
    init_json_tracing(log_level);
    init_prometheus()
}