Crate flexi_logger[−][src]

A flexible and easy-to-use logger that writes logs to stderr and/or to files.

There are configuration options to e.g.

decide whether you want to write your logs to stderr or to a file,
configure the path and the filenames of the log files,
use file rotation,
specify the line format for the log lines,
define additional log streams, e.g for alert or security messages,
support changing the log specification on the fly, while the program is running,

flexi_logger uses a similar syntax as env_logger for specifying which logs should really be written.

See Logger for a full description of all configuration options, and the writers module for the usage of additional log writers.

See the homepage for how to get started.

Modules

writers

This module contains a trait for additional log writers, and a configurable concrete implementation for a log writer that writes to a file or a series of files.

Structs

LogSpecBuilder	Builder for `LogSpecification`.
LogSpecification	Immutable struct that defines which loglines are to be written, based on the module, the log level, and the text.
Logger	The entry-point for using `flexi_logger`.
ReconfigurationHandle	Allows reconfiguring the logger while it is in use (see `Logger::start_reconfigurable()` ).
Record	The "payload" of a log message.

Enums

Duplicate	Used to control which messages are to be duplicated to stderr, when log_to_file() is used.
FlexiLoggerError	Describes errors in the initialization of `flexi_logger`.
Level	An enum representing the available verbosity levels of the logger.
LevelFilter	An enum representing the available verbosity level filters of the logger.

Functions

default_format	A logline-formatter that produces log lines like `INFO [my_prog::some_submodule] Task successfully read from conf.json`
detailed_format	A logline-formatter that produces log lines like `[2016-01-13 15:25:01.640870 +01:00] INFO [foo::bar] src/foo/bar.rs:26: Task successfully read from conf.json` i.e. with timestamp, module path and file location.
opt_format	A logline-formatter that produces log lines like `[2016-01-13 15:25:01.640870 +01:00] INFO [src/foo/bar:26] Task successfully read from conf.json` i.e. with timestamp and file location.
with_thread	A logline-formatter that produces log lines like `[2016-01-13 15:25:01.640870 +01:00] T[taskreader] INFO [src/foo/bar:26] Task successfully read from conf.json` i.e. with timestamp, thread name and file location.

Type Definitions

FormatFunction

Function type for Format functions.