cosmian_logger 0.8.0

Shared tracing and OTLP initialization for Rust services
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

/// Errors that can occur while initialising or configuring the logging stack.
#[derive(Debug, thiserror::Error)]
pub enum LoggingError {
    #[error("failed to build OTLP span exporter: {0}")]
    SpanExporter(#[source] opentelemetry_otlp::ExporterBuildError),

    #[error("failed to build OTLP log exporter: {0}")]
    LogExporter(#[source] opentelemetry_otlp::ExporterBuildError),

    #[error("failed to build OTLP metric exporter: {0}")]
    MetricExporter(#[source] opentelemetry_otlp::ExporterBuildError),

    #[error("failed to initialise tracing subscriber: {0}")]
    SubscriberInit(#[source] tracing_subscriber::util::TryInitError),

    #[error("{context}: {source}")]
    WithContext {
        context: &'static str,
        #[source]
        source: Box<LoggingError>,
    },
}

/// Result type for the logging stack initialisation.
pub type LoggingResult<T> = Result<T, LoggingError>;

/// Extension trait that adds `.context(msg)` to [`LoggingResult`], mirroring
/// the ergonomics of `anyhow::Context`.
pub trait ResultExt<T> {
    fn context(self, ctx: &'static str) -> LoggingResult<T>;
}

impl<T> ResultExt<T> for LoggingResult<T> {
    fn context(self, ctx: &'static str) -> LoggingResult<T> {
        self.map_err(|source| LoggingError::WithContext {
            context: ctx,
            source: Box::new(source),
        })
    }
}