Middlewares and tools to integrate axum + tracing + opentelemetry.
For examples, you can look at:
```rust //... use axumtracingopentelemetry::opentelemetrytracinglayer;
async fn main() -> Result<(), axum::BoxError> { // very opinionated init of tracing, look as is source to make your own inittracingopentelemetry::tracingsubscriberext::init_subscribers()?;
let app = app();
// run it
let addr = &"0.0.0.0:3000".parse::<SocketAddr>()?;
tracing::warn!("listening on {}", addr);
axum::Server::bind(&addr)
.serve(app.into_make_service())
.with_graceful_shutdown(shutdown_signal())
.await?;
Ok(())
}
fn app() -> Router {
// build our application with a route
Router::new()
.route("/", get(health)) // request processed inside span
// opentelemetrytracinglayer setup TraceLayer, that is provided by tower-http so you have to add that as a dependency.
.layer(opentelemetrytracinglayer())
.route("/health", get(health)) // request processed without span / trace
}
async fn shutdownsignal() { //... opentelemetry::global::shutdowntracer_provider(); } ```
To also inject the trace id into the response (could be useful for debugging) uses the layer response_with_trace_layer
rust
// build our application with a route
Router::new()
...
// include trace context as header into the response
.layer(response_with_trace_layer())
For more info about how to setup, you can look at crate init-tracing-opentelemetry or tracing-opentelemetry.
| axum | axum-tracing-opentelemetry | |------|----------------------------| | 0.6 | latest - 0.6 | | 0.5 | 0.1 - 0.5 |
always_on, but read environment variables OTEL_TRACES_SAMPLER, OTEL_TRACES_SAMPLER_ARGtracing_subscriber_extotel::setup detected configuration by otel setup toolsDetectResource builder to help detection for Resource Semantic Conventions | OpenTelemetryinit_propagator to configure the global propagator based on content of the env variable OTEL_PROPAGATORSresponse_with_trace_layer to have traceparent injected into responseOTEL_EXPORTER_OTLP_TRACES_ENDPOINT, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_TRACES_PROTOCOL, OTEL_EXPORTER_OTLP_PROTOCOL/dev/null) to allow to have trace_id
and the opentelemetry span & metadata on log and http response (without collector)