log4rs

A highly configurable logging framework for Rust

Github stars Tracking Chart

log4rs

docs
crates.io
License: MIT OR Apache-2.0
CI
Minimum rustc version

log4rs is a highly configurable logging framework modeled after Java's Logback
and log4j libraries.

Documentation

log4rs.yaml:

refresh_rate: 30 seconds
appenders:
  stdout:
    kind: console
  requests:
    kind: file
    path: "log/requests.log"
    encoder:
      pattern: "{d} - {m}{n}"
root:
  level: warn
  appenders:
    - stdout
loggers:
  app::backend::db:
    level: info
  app::requests:
    level: info
    appenders:
      - requests
    additive: false

lib.rs:

use log::{error, info, warn};
use log4rs;

fn main() {
    log4rs::init_file("config/log4rs.yaml", Default::default()).unwrap();

    info!("booting up");

    // ...
}

Rust Version Requirements

Since version 0.10.0 the minimum version for rust is 1.38.0 and is verified via CI.
1.38.0 is required for windows due to the backtrace crate.
1.34.0 may work for unix environments although it is not officially supported.

Building for Dev

  • Run the tests: cargo test --all-features
  • Run the tests for windows with cross: cross test --target x86_64-pc-windows-gn
  • Run the tests for all individual features: ./test.sh
  • Run the tests for all individual features for windows with cross: ./test.sh win

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you shall be dual licensed as above, without any
additional terms or conditions.

Main metrics

Overview
Name With Ownerestk/log4rs
Primary LanguageRust
Program languageRust (Language Count: 2)
Platform
License:Apache License 2.0
所有者活动
Created At2015-01-27 17:09:19
Pushed At2025-06-27 17:04:56
Last Commit At
Release Count42
Last Release Namev1.4.0-rc2 (Posted on )
First Release Namev0.1.0 (Posted on )
用户参与
Stargazers Count1.1k
Watchers Count12
Fork Count161
Commits Count547
Has Issues Enabled
Issues Count240
Issue Open Count34
Pull Requests Count120
Pull Requests Open Count14
Pull Requests Close Count52
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private