owiwi

Opinionated tracing subscriber with OpenTelemetry export.

Install

[dependencies]
owiwi = { version = "1.1.0", features = ["console"] }
tracing = "0.1"

Usage

use owiwi::Owiwi;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut owiwi = Owiwi::new();
    owiwi.service_name = "my-service".to_owned();
    let guard = owiwi.try_init_console()?;

    tracing::info!("credential issues");

    guard.shutdown()?;
    Ok(())
}

Hold the returned OwiwiGuard until shutdown. Dropping it stops export.

OTLP export

use std::time::Duration;
use owiwi::{Owiwi, OtlpConfig};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let config = OtlpConfig::builder()
        .endpoint("http://localhost:4317".parse()?)
        .timeout(Duration::from_secs(10))
        .build();
    let guard = Owiwi::new().try_init(config)?;

    tracing::info!("credential issues");

    guard.shutdown()?;
    Ok(())
}

CLI integration

Flatten Owiwi into your CLI struct. Requires the clap feature.

[dependencies]
clap = { version = "4", features = ["derive"] }
owiwi = { version = "1.1.0", features = ["clap", "honeycomb"] }
tracing = "0.1"

use clap::Parser;
use owiwi::{Owiwi, HoneycombConfig};

#[derive(Debug, Clone, Parser)]
struct Cli {
    #[command(flatten)]
    owiwi: Owiwi,
}

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let cli = Cli::parse();
    let config = HoneycombConfig::builder()
        .endpoint("https://api.honeycomb.io".parse()?)
        .api_key("your-api-key".into())
        .timeout(std::time::Duration::from_secs(5))
        .build();
    let guard = cli.owiwi.try_init(config)?;
    guard.shutdown()?;
    Ok(())
}

Backends

Environment variables

Per the OpenTelemetry spec. With clap, each has a CLI flag.

Features

MSRV

1.94.0

Acknowledgments

Inspired by Instrumenting Axum.

License

MPL-2.0