Rust 应用中的日志记录：最佳配置实践

轻松学习Python，无需理论负担。在浏览器中直接解决带自动检查的实践任务，无需安装任何东西。

引言：为什么日志记录对Rust应用程序至关重要

日志记录不仅仅是将事件写入文件。在生产环境中，高质量的日志可以让你快速诊断错误、追踪性能并分析系统行为。Rust作为一门系统编程语言，为此提供了灵活且高性能的工具。在本文中，我们将介绍Rust日志记录的最佳实践：从选择crate到配置结构化日志和日志轮转。

1. 基础：`log`和`env_logger` crate

Rust生态系统提供了一种模块化方法。log crate提供了一个抽象层（门面），而env_logger或pretty_env_logger等独立crate则提供具体实现（后端）。

安装与设置

在Cargo.toml中添加依赖：

[dependencies]log = "0.4"env_logger = "0.10"

基础示例

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

fn main() {    env_logger::init();

    info!("Application started");    let user_id = 42;    warn!("User {} not found in cache", user_id);    error!("Database connection error: {:?}", "timeout");}

重要提示： 默认情况下，未设置RUST_LOG环境变量前不会显示日志。请按如下方式运行程序：

RUST_LOG=info cargo run

日志级别

log crate支持五个标准级别（按优先级从高到低排列）：

error — 需要立即处理的严重错误。
warn — 关于潜在问题的警告。
info — 关于执行进度的常规信息。
debug — 供开发者使用的调试信息。
trace — 极其详细的事件（常用于循环中）。

按模块过滤：RUST_LOG=my_crate=debug,other_crate=info。

2. 进阶日志：`tracing` crate

对于复杂应用程序（Web服务器、微服务），建议使用tracing crate。它提供了跨度（时间间隔）的概念以及带上下文的结构化日志记录。

安装`tracing`

[dependencies]tracing = "0.1"tracing-subscriber = "0.3"

跨度的使用示例

use tracing::{info, instrument, span, Level};use tracing_subscriber;

fn main() {    tracing_subscriber::fmt::init();

    let parent_span = span!(Level::INFO, "request_processing", request_id = 123);    let _guard = parent_span.enter();    process_data();}

#[instrument]fn process_data() {    info!("Data processing started");    std::thread::sleep(std::time::Duration::from_millis(50));    info!("Data processing finished");}

#[instrument]属性会自动为函数创建跨度并记录执行时间。输出中将包含嵌套的时间戳，这对性能分析来说非常宝贵。

3. 结构化日志（JSON）与日志轮转

在生产环境中，日志通常会集中收集（ELK、Loki、Grafana）。为此，以JSON格式输出日志非常方便。

使用`tracing-subscriber`输出JSON

use tracing_subscriber::fmt::format::Json;use tracing_subscriber::prelude::*;

fn main() {    let format = Json::new()        .with_timer(tracing_subscriber::fmt::time::UtcTime::rfc3339())        .with_target(true)        .with_level(true);

    tracing_subscriber::fmt()        .event_format(format)        .init();

    tracing::info!("Server started on port 8080");}

现在日志将如下所示：