Struct tracing_actix_web::TracingLogger [−][src]
pub struct TracingLogger<RootSpan: RootSpanBuilder> { /* fields omitted */ }
TracingLogger
is a middleware to capture structured diagnostic when processing an HTTP request.
Check the crate-level documentation for an in-depth introduction.
TracingLogger
is designed as a drop-in replacement of actix-web
’s Logger
.
Usage
Register TracingLogger
as a middleware for your application using .wrap
on App
.
In this example we add a tracing::Subscriber
to output structured logs to the console.
use actix_web::middleware::Logger; use actix_web::App; use tracing::{Subscriber, subscriber::set_global_default}; use tracing_actix_web::TracingLogger; use tracing_log::LogTracer; use tracing_bunyan_formatter::{BunyanFormattingLayer, JsonStorageLayer}; use tracing_subscriber::{layer::SubscriberExt, EnvFilter, Registry}; /// Compose multiple layers into a `tracing`'s subscriber. pub fn get_subscriber( name: String, env_filter: String ) -> impl Subscriber + Send + Sync { let env_filter = EnvFilter::try_from_default_env() .unwrap_or(EnvFilter::new(env_filter)); let formatting_layer = BunyanFormattingLayer::new( name.into(), std::io::stdout ); Registry::default() .with(env_filter) .with(JsonStorageLayer) .with(formatting_layer) } /// Register a subscriber as global default to process span data. /// /// It should only be called once! pub fn init_subscriber(subscriber: impl Subscriber + Send + Sync) { LogTracer::init().expect("Failed to set logger"); set_global_default(subscriber).expect("Failed to set subscriber"); } fn main() { let subscriber = get_subscriber("app".into(), "info".into()); init_subscriber(subscriber); let app = App::new().wrap(TracingLogger::default()); }
Implementations
impl<RootSpan: RootSpanBuilder> TracingLogger<RootSpan>
[src]
impl<RootSpan: RootSpanBuilder> TracingLogger<RootSpan>
[src]pub fn new() -> TracingLogger<RootSpan>
[src]
Trait Implementations
impl<RootSpan: RootSpanBuilder> Clone for TracingLogger<RootSpan>
[src]
impl<RootSpan: RootSpanBuilder> Clone for TracingLogger<RootSpan>
[src]fn clone(&self) -> Self
[src]
pub fn clone_from(&mut self, source: &Self)
1.0.0[src]
impl Default for TracingLogger<DefaultRootSpanBuilder>
[src]
impl Default for TracingLogger<DefaultRootSpanBuilder>
[src]impl<S, B, RootSpan> Transform<S, ServiceRequest> for TracingLogger<RootSpan> where
S: Service<ServiceRequest, Response = ServiceResponse<B>, Error = Error>,
S::Future: 'static,
B: 'static,
RootSpan: RootSpanBuilder,
[src]
impl<S, B, RootSpan> Transform<S, ServiceRequest> for TracingLogger<RootSpan> where
S: Service<ServiceRequest, Response = ServiceResponse<B>, Error = Error>,
S::Future: 'static,
B: 'static,
RootSpan: RootSpanBuilder,
[src]type Response = ServiceResponse<B>
Responses produced by the service.
type Error = Error
Errors produced by the service.
type Transform = TracingLoggerMiddleware<S, RootSpan>
The TransformService
value created by this factory
type InitError = ()
Errors produced while building a transform service.
type Future = Ready<Result<Self::Transform, Self::InitError>>
The future response value.
fn new_transform(&self, service: S) -> Self::Future
[src]
Auto Trait Implementations
impl<RootSpan> RefUnwindSafe for TracingLogger<RootSpan> where
RootSpan: RefUnwindSafe,
impl<RootSpan> RefUnwindSafe for TracingLogger<RootSpan> where
RootSpan: RefUnwindSafe,
impl<RootSpan> Send for TracingLogger<RootSpan> where
RootSpan: Send,
impl<RootSpan> Send for TracingLogger<RootSpan> where
RootSpan: Send,
impl<RootSpan> Sync for TracingLogger<RootSpan> where
RootSpan: Sync,
impl<RootSpan> Sync for TracingLogger<RootSpan> where
RootSpan: Sync,
impl<RootSpan> Unpin for TracingLogger<RootSpan> where
RootSpan: Unpin,
impl<RootSpan> Unpin for TracingLogger<RootSpan> where
RootSpan: Unpin,
impl<RootSpan> UnwindSafe for TracingLogger<RootSpan> where
RootSpan: UnwindSafe,
impl<RootSpan> UnwindSafe for TracingLogger<RootSpan> where
RootSpan: UnwindSafe,
Blanket Implementations
impl<T> FutureExt for T
[src]
impl<T> FutureExt for T
[src]pub fn with_context(self, otel_cx: Context) -> WithContext<Self>
[src]
pub fn with_current_context(self) -> WithContext<Self>
[src]
impl<T> Instrument for T
[src]
impl<T> Instrument for T
[src]pub fn instrument(self, span: Span) -> Instrumented<Self>
[src]
pub fn in_current_span(self) -> Instrumented<Self>
[src]
impl<T> Instrument for T
[src]
impl<T> Instrument for T
[src]pub fn instrument(self, span: Span) -> Instrumented<Self>
[src]
pub fn in_current_span(self) -> Instrumented<Self>
[src]
impl<T> Same<T> for T
impl<T> Same<T> for T
type Output = T
Should always be Self
impl<V, T> VZip<V> for T where
V: MultiLane<T>,
impl<V, T> VZip<V> for T where
V: MultiLane<T>,
pub fn vzip(self) -> V
impl<T> WithSubscriber for T
[src]
impl<T> WithSubscriber for T
[src]pub fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,
[src]
S: Into<Dispatch>,