Struct TraceLayer

pub struct TraceLayer { /* private fields */ }

A Tower Layer which decorates TraceService.

Example with Axum

use stackable_telemetry::AxumTraceLayer;
use axum::{routing::get, Router};

let trace_layer = AxumTraceLayer::new();
let router = Router::new()
    .route("/", get(|| async { "Hello, World!" }))
    .layer(trace_layer);

Example with Webhook

The usage is even simpler when combined with the stackable_webhook crate. The webhook server has built-in support to automatically emit HTTP spans on every incoming request.

use stackable_webhook::{WebhookServer, Options};
use axum::Router;

let router = Router::new();
let server = WebhookServer::new(router, Options::default());

This layer is implemented based on this official Tower guide.

Implementations

impl TraceLayer

pub fn new() -> Self

Creates a new default trace layer.

pub fn with_opt_in(self) -> Self

Enables various fields marked as opt-in by the specification.

This will require more computing power and will increase the latency. See https://opentelemetry.io/docs/specs/semconv/http/http-spans/

Trait Implementations

impl Clone for TraceLayer

fn clone(&self) -> TraceLayer

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TraceLayer

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

Formats the value using the given formatter.

impl Default for TraceLayer

fn default() -> TraceLayer

Returns the “default value” for a type.

impl<S> Layer<S> for TraceLayer

type Service = TraceService<S>

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.