Struct tower_http::trace::Trace [−][src]
pub struct Trace<S, M, MakeSpan = DefaultMakeSpan, OnRequest = DefaultOnRequest, OnResponse = DefaultOnResponse, OnBodyChunk = DefaultOnBodyChunk, OnEos = DefaultOnEos, OnFailure = DefaultOnFailure> { /* fields omitted */ }
trace
only.Expand description
Middleware that adds high level tracing to a Service
.
See the module docs for an example.
Implementations
impl<S, M> Trace<S, M>
[src]
impl<S, M> Trace<S, M>
[src]pub fn new(inner: S, make_classifier: M) -> Self where
M: MakeClassifier,
[src]
pub fn new(inner: S, make_classifier: M) -> Self where
M: MakeClassifier,
[src]Create a new Trace
using the given MakeClassifier
.
pub fn layer(make_classifier: M) -> TraceLayer<M> where
M: MakeClassifier,
[src]
pub fn layer(make_classifier: M) -> TraceLayer<M> where
M: MakeClassifier,
[src]Returns a new Layer
that wraps services with a TraceLayer
middleware.
impl<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure> Trace<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure>
[src]
impl<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure> Trace<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure>
[src]pub fn into_inner(self) -> S
[src]
pub fn into_inner(self) -> S
[src]Consumes self
, returning the underlying service.
pub fn on_request<NewOnRequest>(
self,
new_on_request: NewOnRequest
) -> Trace<S, M, MakeSpan, NewOnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure>
[src]
pub fn on_request<NewOnRequest>(
self,
new_on_request: NewOnRequest
) -> Trace<S, M, MakeSpan, NewOnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure>
[src]Customize what to do when a request is received.
NewOnRequest
is expected to implement OnRequest
.
pub fn on_response<NewOnResponse>(
self,
new_on_response: NewOnResponse
) -> Trace<S, M, MakeSpan, OnRequest, NewOnResponse, OnBodyChunk, OnEos, OnFailure>
[src]
pub fn on_response<NewOnResponse>(
self,
new_on_response: NewOnResponse
) -> Trace<S, M, MakeSpan, OnRequest, NewOnResponse, OnBodyChunk, OnEos, OnFailure>
[src]Customize what to do when a response has been produced.
NewOnResponse
is expected to implement OnResponse
.
pub fn on_body_chunk<NewOnBodyChunk>(
self,
new_on_body_chunk: NewOnBodyChunk
) -> Trace<S, M, MakeSpan, OnRequest, OnResponse, NewOnBodyChunk, OnEos, OnFailure>
[src]
pub fn on_body_chunk<NewOnBodyChunk>(
self,
new_on_body_chunk: NewOnBodyChunk
) -> Trace<S, M, MakeSpan, OnRequest, OnResponse, NewOnBodyChunk, OnEos, OnFailure>
[src]Customize what to do when a body chunk has been sent.
NewOnBodyChunk
is expected to implement OnBodyChunk
.
pub fn on_eos<NewOnEos>(
self,
new_on_eos: NewOnEos
) -> Trace<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, NewOnEos, OnFailure>
[src]
pub fn on_eos<NewOnEos>(
self,
new_on_eos: NewOnEos
) -> Trace<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, NewOnEos, OnFailure>
[src]Customize what to do when a streaming response has closed.
NewOnEos
is expected to implement OnEos
.
pub fn on_failure<NewOnFailure>(
self,
new_on_failure: NewOnFailure
) -> Trace<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, NewOnFailure>
[src]
pub fn on_failure<NewOnFailure>(
self,
new_on_failure: NewOnFailure
) -> Trace<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, NewOnFailure>
[src]Customize what to do when a response has been classified as a failure.
NewOnFailure
is expected to implement OnFailure
.
pub fn make_span_with<NewMakeSpan>(
self,
new_make_span: NewMakeSpan
) -> Trace<S, M, NewMakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure>
[src]
pub fn make_span_with<NewMakeSpan>(
self,
new_make_span: NewMakeSpan
) -> Trace<S, M, NewMakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure>
[src]impl<S> Trace<S, SharedClassifier<ServerErrorsAsFailures>, DefaultMakeSpan, DefaultOnRequest, DefaultOnResponse, DefaultOnBodyChunk, DefaultOnEos, DefaultOnFailure>
[src]
impl<S> Trace<S, SharedClassifier<ServerErrorsAsFailures>, DefaultMakeSpan, DefaultOnRequest, DefaultOnResponse, DefaultOnBodyChunk, DefaultOnEos, DefaultOnFailure>
[src]pub fn new_for_http(inner: S) -> Self
[src]
pub fn new_for_http(inner: S) -> Self
[src]Create a new Trace
using ServerErrorsAsFailures
which supports classifying
regular HTTP responses based on the status code.
impl<S> Trace<S, SharedClassifier<GrpcErrorsAsFailures>, DefaultMakeSpan, DefaultOnRequest, DefaultOnResponse, DefaultOnBodyChunk, DefaultOnEos, DefaultOnFailure>
[src]
impl<S> Trace<S, SharedClassifier<GrpcErrorsAsFailures>, DefaultMakeSpan, DefaultOnRequest, DefaultOnResponse, DefaultOnBodyChunk, DefaultOnEos, DefaultOnFailure>
[src]pub fn new_for_grpc(inner: S) -> Self
[src]
pub fn new_for_grpc(inner: S) -> Self
[src]Create a new Trace
using GrpcErrorsAsFailures
which supports classifying
gRPC responses and streams based on the grpc-status
header.
Trait Implementations
impl<S: Clone, M: Clone, MakeSpan: Clone, OnRequest: Clone, OnResponse: Clone, OnBodyChunk: Clone, OnEos: Clone, OnFailure: Clone> Clone for Trace<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure>
[src]
impl<S: Clone, M: Clone, MakeSpan: Clone, OnRequest: Clone, OnResponse: Clone, OnBodyChunk: Clone, OnEos: Clone, OnFailure: Clone> Clone for Trace<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure>
[src]impl<S: Debug, M: Debug, MakeSpan: Debug, OnRequest: Debug, OnResponse: Debug, OnBodyChunk: Debug, OnEos: Debug, OnFailure: Debug> Debug for Trace<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure>
[src]
impl<S: Debug, M: Debug, MakeSpan: Debug, OnRequest: Debug, OnResponse: Debug, OnBodyChunk: Debug, OnEos: Debug, OnFailure: Debug> Debug for Trace<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure>
[src]impl<S, ReqBody, ResBody, M, OnRequestT, OnResponseT, OnFailureT, OnBodyChunkT, OnEosT, MakeSpanT> Service<Request<ReqBody>> for Trace<S, M, MakeSpanT, OnRequestT, OnResponseT, OnBodyChunkT, OnEosT, OnFailureT> where
S: Service<Request<ReqBody>, Response = Response<ResBody>>,
ReqBody: Body,
ResBody: Body,
ResBody::Error: Display + 'static,
S::Error: Display + 'static,
M: MakeClassifier,
M::Classifier: Clone,
MakeSpanT: MakeSpan<ReqBody>,
OnRequestT: OnRequest<ReqBody>,
OnResponseT: OnResponse<ResBody> + Clone,
OnBodyChunkT: OnBodyChunk<ResBody::Data> + Clone,
OnEosT: OnEos + Clone,
OnFailureT: OnFailure<M::FailureClass> + Clone,
[src]
impl<S, ReqBody, ResBody, M, OnRequestT, OnResponseT, OnFailureT, OnBodyChunkT, OnEosT, MakeSpanT> Service<Request<ReqBody>> for Trace<S, M, MakeSpanT, OnRequestT, OnResponseT, OnBodyChunkT, OnEosT, OnFailureT> where
S: Service<Request<ReqBody>, Response = Response<ResBody>>,
ReqBody: Body,
ResBody: Body,
ResBody::Error: Display + 'static,
S::Error: Display + 'static,
M: MakeClassifier,
M::Classifier: Clone,
MakeSpanT: MakeSpan<ReqBody>,
OnRequestT: OnRequest<ReqBody>,
OnResponseT: OnResponse<ResBody> + Clone,
OnBodyChunkT: OnBodyChunk<ResBody::Data> + Clone,
OnEosT: OnEos + Clone,
OnFailureT: OnFailure<M::FailureClass> + Clone,
[src]type Response = Response<ResponseBody<ResBody, M::ClassifyEos, OnBodyChunkT, OnEosT, OnFailureT>>
type Response = Response<ResponseBody<ResBody, M::ClassifyEos, OnBodyChunkT, OnEosT, OnFailureT>>
Responses given by the service.
type Future = ResponseFuture<S::Future, M::Classifier, OnResponseT, OnBodyChunkT, OnEosT, OnFailureT>
type Future = ResponseFuture<S::Future, M::Classifier, OnResponseT, OnBodyChunkT, OnEosT, OnFailureT>
The future response value.
impl<S: Copy, M: Copy, MakeSpan: Copy, OnRequest: Copy, OnResponse: Copy, OnBodyChunk: Copy, OnEos: Copy, OnFailure: Copy> Copy for Trace<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure>
[src]
Auto Trait Implementations
impl<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure> RefUnwindSafe for Trace<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure> where
M: RefUnwindSafe,
MakeSpan: RefUnwindSafe,
OnBodyChunk: RefUnwindSafe,
OnEos: RefUnwindSafe,
OnFailure: RefUnwindSafe,
OnRequest: RefUnwindSafe,
OnResponse: RefUnwindSafe,
S: RefUnwindSafe,
M: RefUnwindSafe,
MakeSpan: RefUnwindSafe,
OnBodyChunk: RefUnwindSafe,
OnEos: RefUnwindSafe,
OnFailure: RefUnwindSafe,
OnRequest: RefUnwindSafe,
OnResponse: RefUnwindSafe,
S: RefUnwindSafe,
impl<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure> Send for Trace<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure> where
M: Send,
MakeSpan: Send,
OnBodyChunk: Send,
OnEos: Send,
OnFailure: Send,
OnRequest: Send,
OnResponse: Send,
S: Send,
M: Send,
MakeSpan: Send,
OnBodyChunk: Send,
OnEos: Send,
OnFailure: Send,
OnRequest: Send,
OnResponse: Send,
S: Send,
impl<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure> Sync for Trace<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure> where
M: Sync,
MakeSpan: Sync,
OnBodyChunk: Sync,
OnEos: Sync,
OnFailure: Sync,
OnRequest: Sync,
OnResponse: Sync,
S: Sync,
M: Sync,
MakeSpan: Sync,
OnBodyChunk: Sync,
OnEos: Sync,
OnFailure: Sync,
OnRequest: Sync,
OnResponse: Sync,
S: Sync,
impl<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure> Unpin for Trace<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure> where
M: Unpin,
MakeSpan: Unpin,
OnBodyChunk: Unpin,
OnEos: Unpin,
OnFailure: Unpin,
OnRequest: Unpin,
OnResponse: Unpin,
S: Unpin,
M: Unpin,
MakeSpan: Unpin,
OnBodyChunk: Unpin,
OnEos: Unpin,
OnFailure: Unpin,
OnRequest: Unpin,
OnResponse: Unpin,
S: Unpin,
impl<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure> UnwindSafe for Trace<S, M, MakeSpan, OnRequest, OnResponse, OnBodyChunk, OnEos, OnFailure> where
M: UnwindSafe,
MakeSpan: UnwindSafe,
OnBodyChunk: UnwindSafe,
OnEos: UnwindSafe,
OnFailure: UnwindSafe,
OnRequest: UnwindSafe,
OnResponse: UnwindSafe,
S: UnwindSafe,
M: UnwindSafe,
MakeSpan: UnwindSafe,
OnBodyChunk: UnwindSafe,
OnEos: UnwindSafe,
OnFailure: UnwindSafe,
OnRequest: UnwindSafe,
OnResponse: UnwindSafe,
S: UnwindSafe,
Blanket Implementations
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]pub fn borrow_mut(&mut self) -> &mut T
[src]
pub fn borrow_mut(&mut self) -> &mut T
[src]Mutably borrows from an owned value. Read more
impl<T> Instrument for T
[src]
impl<T> Instrument for T
[src]fn instrument(self, span: Span) -> Instrumented<Self>
[src]
fn instrument(self, span: Span) -> Instrumented<Self>
[src]Instruments this type with the provided Span
, returning an
Instrumented
wrapper. Read more
fn in_current_span(self) -> Instrumented<Self>
[src]
fn in_current_span(self) -> Instrumented<Self>
[src]impl<T> PolicyExt for T where
T: ?Sized,
[src]
impl<T> PolicyExt for T where
T: ?Sized,
[src]impl<T, Request> ServiceExt<Request> for T where
T: Service<Request> + ?Sized,
[src]
impl<T, Request> ServiceExt<Request> for T where
T: Service<Request> + ?Sized,
[src]fn ready(&mut self) -> Ready<'_, Self, Request>
[src]
fn ready(&mut self) -> Ready<'_, Self, Request>
[src]Yields a mutable reference to the service when it is ready to accept a request.
fn ready_and(&mut self) -> Ready<'_, Self, Request>
[src]
fn ready_and(&mut self) -> Ready<'_, Self, Request>
[src]please use the ServiceExt::ready
method instead
Yields a mutable reference to the service when it is ready to accept a request.
fn ready_oneshot(self) -> ReadyOneshot<Self, Request>
[src]
fn ready_oneshot(self) -> ReadyOneshot<Self, Request>
[src]Yields the service when it is ready to accept a request.
fn oneshot(self, req: Request) -> Oneshot<Self, Request>
[src]
fn oneshot(self, req: Request) -> Oneshot<Self, Request>
[src]Consume this Service
, calling with the providing request once it is ready.
fn call_all<S>(self, reqs: S) -> CallAll<Self, S> where
S: Stream<Item = Request>,
Self::Error: Into<Box<dyn Error + 'static + Sync + Send, Global>>,
[src]
fn call_all<S>(self, reqs: S) -> CallAll<Self, S> where
S: Stream<Item = Request>,
Self::Error: Into<Box<dyn Error + 'static + Sync + Send, Global>>,
[src]fn and_then<F>(self, f: F) -> AndThen<Self, F> where
F: Clone,
[src]
fn and_then<F>(self, f: F) -> AndThen<Self, F> where
F: Clone,
[src]Executes a new future after this service’s future resolves. This does
not alter the behaviour of the poll_ready
method. Read more
fn map_response<F, Response>(self, f: F) -> MapResponse<Self, F> where
F: FnOnce(Self::Response) -> Response + Clone,
[src]
fn map_response<F, Response>(self, f: F) -> MapResponse<Self, F> where
F: FnOnce(Self::Response) -> Response + Clone,
[src]Maps this service’s response value to a different value. This does not
alter the behaviour of the poll_ready
method. Read more
fn map_err<F, Error>(self, f: F) -> MapErr<Self, F> where
F: FnOnce(Self::Error) -> Error + Clone,
[src]
fn map_err<F, Error>(self, f: F) -> MapErr<Self, F> where
F: FnOnce(Self::Error) -> Error + Clone,
[src]Maps this service’s error value to a different value. This does not
alter the behaviour of the poll_ready
method. Read more
fn map_result<F, Response, Error>(self, f: F) -> MapResult<Self, F> where
Error: From<Self::Error>,
F: FnOnce(Result<Self::Response, Self::Error>) -> Result<Response, Error> + Clone,
[src]
fn map_result<F, Response, Error>(self, f: F) -> MapResult<Self, F> where
Error: From<Self::Error>,
F: FnOnce(Result<Self::Response, Self::Error>) -> Result<Response, Error> + Clone,
[src]Maps this service’s result type (Result<Self::Response, Self::Error>
)
to a different value, regardless of whether the future succeeds or
fails. Read more
fn map_request<F, NewRequest>(self, f: F) -> MapRequest<Self, F> where
F: FnMut(NewRequest) -> Request + Clone,
[src]
fn map_request<F, NewRequest>(self, f: F) -> MapRequest<Self, F> where
F: FnMut(NewRequest) -> Request + Clone,
[src]Composes a function in front of the service. Read more
impl<T> ToOwned for T where
T: Clone,
[src]
impl<T> ToOwned for T where
T: Clone,
[src]type Owned = T
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn to_owned(&self) -> T
[src]Creates owned data from borrowed data, usually by cloning. Read more
pub fn clone_into(&self, target: &mut T)
[src]
pub fn clone_into(&self, target: &mut T)
[src]🔬 This is a nightly-only experimental API. (toowned_clone_into
)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more