Crate tower_http_tracing 

Tower tracing middleware to annotate every HTTP request with tracing’s span.

Span creation

Use macro to declare function that creates desirable span

Example

Below is illustration of how to initialize request layer for passing into your service

use std::net::IpAddr;

use tower_http_tracing::HttpRequestLayer;

//Logic to extract client ip has to be written by user
//You can use utilities in separate crate to design this logic:
//https://docs.rs/http-ip/latest/http_ip/
fn extract_client_ip(_parts: &http::request::Parts) -> Option<IpAddr> {
    None
}
tower_http_tracing::make_request_spanner!(make_my_request_span("my_request", tracing::Level::INFO));
let layer = HttpRequestLayer::new(make_my_request_span).with_extract_client_ip(extract_client_ip)
                                                       .with_inspect_headers(&[&http::header::FORWARDED]);
//Use above layer in your service

Features

• opentelemetry - Enables integration with opentelemetry to propagate context from requests and into responses

Re-exports

pub use tracing;

Macros

make_request_spanner

Declares fn function compatible with MakeSpan using provided parameters

Structs

HttpRequestLayer

Tower layer

HttpRequestService

Tower service to annotate requests with span

RequestId

Request’s id

RequestInfo

Request’s information

RequestSpan

Request’s span information

ResponseFut

Middleware’s response future

Enums

Protocol

Possible request protocol

Constants

REQUEST_ID

RequestId’s header name

Type Aliases

ExtractClientIp

ALias to function signature to extract client’s ip from request

MakeSpan

Alias to function signature required to create span