simple_logger

A logger that prints all messages with a readable output format.

The output format is based on the format used by Supervisord, with timestamps in RFC 3339 format.

The format and timezone used for timestamps can be customised, simple colours based on log level can be enabled, thread metadata can be included, and output can be toggled between STDOUT and STDERR.

Notices

Project status

I wrote the initial version of this library in 2015, and haven't written Rust professionally since then. I consider this as close as I'll ever get to a "finished" project and don't plan on adding any more features to it.

It is still maintained and I try and merge pull requests for fixes, improvements, and features; though I generally turn down pull requests for large or complex features that go outside the library's aim to be a simple logger. If you need more, the log module has a list of available logging implementations, or you could consider forking simple_logger and building on top of it.

Breaking changes

Version 2.0.0 changes the default from displaying timestamps in the local timezone to displaying timestamps in UTC. See issue #52 for more information.

Usage

use simple_logger::SimpleLogger;

fn main() {
    SimpleLogger::new().init().unwrap();

    log::warn!("This is an example message.");
}

This outputs:

2022-01-19T17:27:07.013874956Z WARN [logging_example] This is an example message.

You can run the above example with:

cargo run --example init

Optional features

The colors and timestamps features are enabled by default. You can remove these features and their respective dependencies by disabling all features in your Cargo.toml.

[dependencies.simple_logger]
default-features = false

To include the timestamps feature, but not the colors feature:

[dependencies.simple_logger]
default-features = false
features = ["timestamps"]

To include the colors feature, but not the timestamps feature:

[dependencies.simple_logger]
default-features = false
features = ["colors"]

To include thread metadata use the threads and nightly features:

[dependencies.simple_logger]
features = ["threads", "nightly"]

To direct logging output to stderr use the stderr feature:

[dependencies.simple_logger]
features = ["stderr"]

Multiple features can be combined.

[dependencies.simple_logger]
features = ["colors", "threads", "timestamps", "nightly", "stderr"]

Wrapping with another logger

You might want to wrap this logger to do your own processing before handing events to a SimpleLogger instance. Instead of calling init() which calls log::set_max_level and log::set_boxed_logger, you can call those functions directly giving you the chance to wrap or adjust the logger. See wrap.rs for a more detailed example.

The call to set_up_color_terminal() is currently only needed on Windows when the colored feature is enabled. If you're not on Windows and not using the colored feature, it will do nothing.

use simple_logger::{SimpleLogger, set_up_color_terminal};

fn main() {
    set_up_color_terminal();

    let logger = SimpleLogger::new();
    let max_level = logger.max_level();

    log::set_max_level(max_level);
    log::set_boxed_logger(Box::new(logger)).unwrap();
}

Licence

simple_logger is licenced under the MIT Licence.

Authors

Written by Sam Clements.

simple_logger 4.3.3