Struct slog_async::Async [−][src]
pub struct Async { /* fields omitted */ }
Expand description
Async drain
Async
will send all the logging records to a wrapped drain running in
another thread.
Async
never returns AsyncError::Full
.
Record
s are passed to the worker thread through a channel with a bounded
size (see AsyncBuilder::chan_size
). On channel overflow Async
will
start dropping Record
s and log a message informing about it after
sending more Record
s is possible again. The exact details of handling
overflow is implementation defined, might change and should not be relied
on, other than message won’t be dropped as long as channel does not
overflow.
Any messages reported by Async
will contain slog-async
logging Record
tag to allow easy custom handling.
Note: On drop Async
waits for it’s worker-thread to finish (after handling
all previous Record
s sent to it). If you can’t tolerate the delay, make
sure you drop it eg. in another thread.
Implementations
New AsyncCore
with default parameters
Build Async
drain with custom parameters
The wrapped drain must handle all results (Drain<Ok=(),Error=Never>
)
since there’s no way to return it back. See slog::DrainExt::fuse()
and
slog::DrainExt::ignore_res()
for typical error handling strategies.
Trait Implementations
type Err = AsyncError
type Err = AsyncError
Type of potential errors that can be returned by this Drain
Handle one logging statement (Record
) Read more
Avoid: Check if messages at the specified log level are maybe enabled for this logger. Read more
Avoid: See is_enabled
Avoid: See is_enabled
Avoid: See is_enabled
Avoid: See is_enabled
Avoid: See is_enabled
Avoid: See is_enabled
Pass Drain
through a closure, eg. to wrap
into another Drain
. Read more
Filter logging records passed to Drain
Read more
Filter logging records passed to Drain
(by level) Read more
Map logging errors returned by this drain Read more
Ignore results returned by this drain Read more
Auto Trait Implementations
impl RefUnwindSafe for Async
impl UnwindSafe for Async
Blanket Implementations
Mutably borrows from an owned value. Read more