opentelemetry-tide

Notes

• It only implements very basic request tracing on the middleware layer. If you need spans for your executed code, you need to add them yourself.
• The majority of the implementation is based on https://github.com/OutThereLabs/actix-web-opentelemetry.
• It does not provide metrics, so it cannot be used for Prometheus metrics. Yet. Maybe I'll add it in the future. Or you want to contribute the extension. ;-)
• You probably do not want to use it in production. 🤷

How to use

```sh

Run jaeger in background

docker run -d \ -p6831:6831/udp -p6832:6832/udp -p16686:16686 -p14268:14268 \ jaegertracing/all-in-one:latest

Run server example with tracing middleware

cargo run --example server

Make a request or two ...

curl http://localhost:3000/

Open browser and view the traces

firefox http://localhost:16686/ ```

Code example

Cargo.toml

toml [dependencies] async-std = {version = "1.9", features = ["attributes"]} opentelemetry = { version = "0.12", features = ["async-std"] } opentelemetry-jaeger = { version = "0.11", features = ["async-std"] } opentelemetry-tide = "0.6" tide = "0.15"

server.rs

```rust use opentelemetry::global as otelglobal; use opentelemetry::sdk::propagation::TraceContextPropagator; use opentelemetrysemanticconventions::resource; use opentelemetrytide::OpenTelemetryTracingMiddleware;

const VERSION: &str = env!("CARGOPKGVERSION");

[async_std::main]

async fn main() -> Result<(), Box> { tide::log::start(); otelglobal::settextmappropagator(TraceContextPropagator::new());

let tags = [resource::SERVICE_VERSION.string(VERSION)];

let (tracer, _uninstall) = opentelemetry_jaeger::new_pipeline()
    .with_service_name("example-server")
    .with_tags(tags.iter().map(ToOwned::to_owned))
    .install()
    .expect("pipeline install failure");

let mut app = tide::new();
app.with(OpenTelemetryTracingMiddleware::new(tracer));
app.at("/").get(|_| async move { Ok("Hello, OpenTelemetry!") });
app.listen("127.0.0.1:3000").await?;

Ok(())

} ```

Cargo Features:

Safety

This crate uses #![forbid(unsafe_code)] to ensure everything is implemented in 100% Safe Rust.

License

<sup>Licensed under either of Apache License, Version 2.0 or MIT license at your option.</sup>

<sub>Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.</sub>