Struct tracing_appender::non_blocking::NonBlocking
source · pub struct NonBlocking { /* private fields */ }
Expand description
A non-blocking writer.
While the line between “blocking” and “non-blocking” IO is fuzzy, writing to a file is typically
considered to be a blocking operation. For an application whose Subscriber
writes spans and events
as they are emitted, an application might find the latency profile to be unacceptable.
NonBlocking
moves the writing out of an application’s data path by sending spans and events
to a dedicated logging thread.
This struct implements MakeWriter
from the tracing-subscriber
crate. Therefore, it can be used with the tracing_subscriber::fmt
module
or with any other subscriber/layer implementation that uses the MakeWriter
trait.
Implementations§
source§impl NonBlocking
impl NonBlocking
sourcepub fn new<T: Write + Send + 'static>(writer: T) -> (NonBlocking, WorkerGuard)
pub fn new<T: Write + Send + 'static>(writer: T) -> (NonBlocking, WorkerGuard)
Returns a new NonBlocking
writer wrapping the provided writer
.
The returned NonBlocking
writer will have the default configuration values.
Other configurations can be specified using the builder interface.
sourcepub fn error_counter(&self) -> ErrorCounter
pub fn error_counter(&self) -> ErrorCounter
Returns a counter for the number of times logs where dropped. This will always return zero if
NonBlocking
is not lossy.
Trait Implementations§
source§impl Clone for NonBlocking
impl Clone for NonBlocking
source§impl Debug for NonBlocking
impl Debug for NonBlocking
source§impl<'a> MakeWriter<'a> for NonBlocking
impl<'a> MakeWriter<'a> for NonBlocking
§type Writer = NonBlocking
type Writer = NonBlocking
io::Write
implementation returned by make_writer
.source§impl Write for NonBlocking
impl Write for NonBlocking
source§fn write(&mut self, buf: &[u8]) -> Result<usize>
fn write(&mut self, buf: &[u8]) -> Result<usize>
source§fn flush(&mut self) -> Result<()>
fn flush(&mut self) -> Result<()>
source§fn write_all(&mut self, buf: &[u8]) -> Result<()>
fn write_all(&mut self, buf: &[u8]) -> Result<()>
source§fn is_write_vectored(&self) -> bool
fn is_write_vectored(&self) -> bool
can_vector
#69941)source§fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<(), Error>
fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<(), Error>
write_all_vectored
#70436)Auto Trait Implementations§
impl RefUnwindSafe for NonBlocking
impl Send for NonBlocking
impl Sync for NonBlocking
impl Unpin for NonBlocking
impl UnwindSafe for NonBlocking
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<'a, M> MakeWriterExt<'a> for Mwhere
M: MakeWriter<'a>,
impl<'a, M> MakeWriterExt<'a> for Mwhere M: MakeWriter<'a>,
source§fn with_max_level(self, level: Level) -> WithMaxLevel<Self>where
Self: Sized,
fn with_max_level(self, level: Level) -> WithMaxLevel<Self>where Self: Sized,
self
and returns a MakeWriter
that will only write output
for events at or below the provided verbosity Level
. For instance,
Level::TRACE
is considered to be _more verbosethan
Level::INFO`. Read moresource§fn with_min_level(self, level: Level) -> WithMinLevel<Self>where
Self: Sized,
fn with_min_level(self, level: Level) -> WithMinLevel<Self>where Self: Sized,
self
and returns a MakeWriter
that will only write output
for events at or above the provided verbosity Level
. Read moresource§fn with_filter<F>(self, filter: F) -> WithFilter<Self, F>where
Self: Sized,
F: Fn(&Metadata<'_>) -> bool,
fn with_filter<F>(self, filter: F) -> WithFilter<Self, F>where Self: Sized, F: Fn(&Metadata<'_>) -> bool,
self
with a predicate that takes a span or event’s Metadata
and returns a bool
. The returned MakeWriter
’s
MakeWriter::make_writer_for
method will check the predicate to
determine if a writer should be produced for a given span or event. Read moresource§fn and<B>(self, other: B) -> Tee<Self, B>where
Self: Sized,
B: MakeWriter<'a>,
fn and<B>(self, other: B) -> Tee<Self, B>where Self: Sized, B: MakeWriter<'a>,
self
with another type implementing MakeWriter
, returning
a new MakeWriter
that produces writers that write to both
outputs. Read moresource§fn or_else<W, B>(self, other: B) -> OrElse<Self, B>where
Self: MakeWriter<'a, Writer = EitherWriter<W, Sink>> + Sized,
B: MakeWriter<'a>,
W: Write,
fn or_else<W, B>(self, other: B) -> OrElse<Self, B>where Self: MakeWriter<'a, Writer = EitherWriter<W, Sink>> + Sized, B: MakeWriter<'a>, W: Write,
self
with another type implementing MakeWriter
, returning
a new MakeWriter
that calls other
’s make_writer
if self
’s
make_writer
returns OptionalWriter::none
. Read more