Struct Builder

pub struct Builder { /* private fields */ }

Implementations

impl Builder

pub fn new() -> Builder

Create a ftlog builder with default settings:

• global log level: INFO
• root log level: INFO
• default formatter: FtLogFormatter
• output to stderr
• bounded channel between worker thread and log thread, with a size limit of 100_000
• discard excessive log messages
• log with timestamp of local timezone

pub fn format<F: FtLogFormat + 'static>(self, format: F) -> Builder

Set custom formatter

pub fn unbounded(self) -> Builder

set channel size to unbound

ATTENTION: too much log message will lead to huge memory consumption, as log messages are queued to be handled by log thread. When log message exceed the current channel size, it will double the size by default, Since channel expansion asks for memory allocation, log calls can be slow down.

pub fn max_log_level(self, level: LevelFilter) -> Builder

Set max log level

Logs with level more verbose than this will not be sent to log thread.

pub fn root_log_level(self, level: LevelFilter) -> Builder

Set max log level

Logs with level more verbose than this will not be sent to log thread.

pub fn build(self) -> Result<Logger, IoError>

Finish building ftlog logger

The call spawns a log thread to formatting log message into string, and write to output target.

pub fn try_init(self) -> Result<LoggerGuard, Box<dyn Error>>

try building and setting as global logger

Trait Implementations

impl Default for Builder

fn default() -> Self

Returns the “default value” for a type.