log4rs
介绍
log4rs是一个高效的日志库框架，借鉴了 java 的 Logback 和 log4j。
log4rs能做什么？提供了输出到文件和控制台两种方式。
大部分用户会使用控制台输出，在 linux 中输出到控制台信息可以重定向到文件，灵活度高。
输出到文件时，你可能需要限制文件大小，文件拆分，文件回滚功能，这些log4rs都提供了。
使用
log4rs支持两种配置方式，基于编程方式配置和基于YAML文件配置。 如果需要频繁修改配置的，建议使用YAML文件配置，这有效减少重新编译次数。
基于编程方式配置
#[macro_use]
extern crate log;
extern crate log4rs;
use log::LevelFilter;
use log4rs::append::console::ConsoleAppender;
use log4rs::append::file::FileAppender;
use log4rs::encode::pattern::PatternEncoder;
use log4rs::config::{Appender, Config, Logger, Root};
fn init_log() {
let stdout = ConsoleAppender::builder()
.encoder(Box::new(PatternEncoder::new("[Console] {d} - {l} -{t} - {m}{n}")))
.build();
let file = FileAppender::builder()
.encoder(Box::new(PatternEncoder::new("[File] {d} - {l} - {t} - {m}{n}")))
.build("log/test.log")
.unwrap();
let config = Config::builder()
.appender(Appender::builder().build("stdout", Box::new(stdout)))
.appender(Appender::builder().build("file", Box::new(file)))
.logger(Logger::builder()
.appender("file")
.additive(false)
.build("app", LevelFilter::Info))
.build(Root::builder().appender("stdout").build(LevelFilter::Info))
.unwrap();
let _ = log4rs::init_config(config).unwrap();
}
fn main() {
init_log();
trace!("A trace");
debug!("A debug");
info!("A info");
info!(target:"app", "File info");
warn!("A warn");
error!("A error");
}
上面代码根据输出目标不同，分别输出到控制台和文件。
-
appender控制输出到什么地方去，例子添加了输出到文件和控制台。 -
encoder按什么格式输出，在appender中配置。 -
logger日志实例，例子构建了一个输出到文件，目标为app的日志实例。
并构建了一个全局日志实例，它输出到控制台。所以上面代码运行后控制台输出是
[Console] 2019-04-16T20:55:34.434982200+08:00 - INFO -u_log4rs - A info
[Console] 2019-04-16T20:55:34.436987600+08:00 - WARN -u_log4rs - A warn
[Console] 2019-04-16T20:55:34.438002100+08:00 - ERROR -u_log4rs - A error
文件：
[File] 2019-04-16T20:55:34.436987600+08:00 - INFO - app - File info
因为 info!(target:"app", "File info"); 这代码执行时，与文件输出方式匹配。
基于YAML文件配置
把前面的例子翻译成YAML文件，就是如下：
appenders:
# An appender named "stdout" that writes to stdout
stdout:
kind: console
encoder:
pattern: "[Console] {d} - {l} -{t} - {m}{n}"
# An appender named "file" that writes to a file with a custom pattern encoder
file:
kind: file
path: "log/test.log"
encoder:
pattern: "[File] {d} - {l} - {t} - {m}{n}"
# Set the default logging level to "warn" and attach the "stdout" appender to the root
root:
level: info
appenders:
- stdout
loggers:
# Route log events sent to the "app" logger to the "file" appender,
# and *not* the normal appenders installed at the root
app:
level: info
appenders:
- file
additive: false
读取配置文件，并记录：
#[macro_use]
extern crate log;
extern crate log4rs;
fn main() {
log4rs::init_file("log4rs.yml", Default::default()).unwrap();
trace!("A trace");
debug!("A debug");
info!("A info");
info!(target:"app", "File info");
warn!("A warn");
error!("A error");
}
输出和前例子一致，而代码简洁多了。
