rtb-telemetry 0.7.1

Opt-in anonymous usage telemetry with pluggable sinks. Part of the phpboyscout Rust toolkit.
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

//! Typed errors for the telemetry subsystem.

use miette::Diagnostic;
use thiserror::Error;

/// Failures surfaced by telemetry sinks.
#[derive(Debug, Error, Diagnostic)]
#[non_exhaustive]
pub enum TelemetryError {
    /// Sink I/O failure (disk write, HTTP round-trip, etc.).
    #[error("sink I/O error: {0}")]
    #[diagnostic(code(rtb::telemetry::io))]
    Io(#[from] std::io::Error),

    /// JSON (or other) serialisation failure.
    #[error("serialisation error: {0}")]
    #[diagnostic(code(rtb::telemetry::serde))]
    Serde(String),

    /// HTTP sink failure — bad endpoint, transport error, non-2xx
    /// response. Details are already redacted by the sink.
    #[error("HTTP telemetry sink error: {0}")]
    #[diagnostic(code(rtb::telemetry::http))]
    Http(String),

    /// OTLP sink failure — pipeline build, export, or shutdown error.
    #[error("OTLP telemetry sink error: {0}")]
    #[diagnostic(code(rtb::telemetry::otlp))]
    Otlp(String),
}