Struct OtelAxumLayer

pub struct OtelAxumLayer<P> { /* private fields */ }

OpenTelemetry layer for Axum applications.

This layer provides automatic tracing instrumentation for Axum web applications, creating spans for HTTP requests with appropriate semantic attributes.

The layer is generic over axum::extract::MatchedPath, making it compatible with different versions of axum without being tied to any specific one.

Example

use axum::{Router, routing};
use telemetry_rust::middleware::axum::OtelAxumLayer;

let app: Router = axum::Router::new()
    .nest("/api", Router::new()) // api_routes would be your actual routes
    .layer(OtelAxumLayer::new(axum::extract::MatchedPath::as_str));

Implementations

impl<P> OtelAxumLayer<P>

pub fn new(matched_path_as_str: AsStr<P>) -> Self

Creates a new OpenTelemetry layer for Axum.

Arguments

• matched_path_as_str - axum::extract::MatchedPath::as_str or any function to convert axum::extract::MatchedPath to a &str

pub fn filter(self, filter: Filter) -> Self

Sets a filter function to selectively trace requests.

Arguments

• filter - Function that returns true for paths that should be traced

pub fn inject_context(self, inject_context: bool) -> Self

Configures whether to inject OpenTelemetry context into responses.

Arguments

• inject_context - Whether to inject trace context into response headers

Trait Implementations

impl<P: Clone> Clone for OtelAxumLayer<P>

fn clone(&self) -> OtelAxumLayer<P>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<P: Debug> Debug for OtelAxumLayer<P>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<S, P> Layer<S> for OtelAxumLayer<P>

type Service = OtelAxumService<S, P>

The wrapped service

fn layer(&self, inner: S) -> Self::Service

Wrap the given service with the middleware, returning a new service that has been decorated with the middleware.