Rust 在 CentOS 上的日志管理实践

一 方案总览与选择

• 使用日志门面 log 统一接口，配合具体实现库输出日志。常见实现：
  • env_logger：简单、基于环境变量 RUST_LOG 控制级别，适合开发/小型服务与容器化场景。
  • log4rs：功能完备，支持 YAML 配置、多 Appender、滚动策略、按模块级别，适合生产长期运行。
  • tracing / tracing-subscriber：面向异步与结构化日志，生态与 Tokio 配套，适合 Web/异步服务。
• 在 CentOS 上，应用常以 systemd 服务运行，日志可同时落入 journald（便于集中管理）与 文件（便于落盘与归档）。

二 快速上手 env_logger

• 添加依赖（Cargo.toml）：
  • [dependencies]
    • log = “0.4”
    • env_logger = “0.9”
• 初始化与输出示例（main.rs）：
  • use log::{info, error}; use env_logger::Env; fn main() { env_logger::Builder::from_env(Env::default().default_filter_or(“info”)).init(); info!(“应用启动”); error!(“发生错误”); }
• 运行时通过环境变量控制级别与模块：
  • RUST_LOG=debug cargo run
  • RUST_LOG=mycrate=debug,mycrate::db=info cargo run
• 自定义格式（含时间戳）：
  • 需添加依赖：chrono = “0.4”
  • env_logger::Builder::from_env(Env::default().default_filter_or(“info”)) .format(|buf, record| { writeln!(buf, “{} [{}] {}”, chrono::Local::now().format(“%Y-%m-%d %H:%M:%S”), record.level(), record.args()) }) .init();
• 适用：开发、调试、容器与简单服务；不建议复杂文件滚动与多目标路由。

三 生产级方案 log4rs

• 添加依赖（Cargo.toml）：
  • [dependencies]
    • log = “0.4”
    • log4rs = “0.10”
• 配置文件 log4rs.yaml（示例：控制台 + 滚动文件，支持热加载）：
  • refresh_rate: 30 seconds appenders: stdout: kind: console file: kind: file path: “/var/log/myapp/app.log” encoder: pattern: “{d(%Y-%m-%d %H:%M:%S)} [{l}] {m}{n}” root: level: info appenders: - stdout - file
• 初始化（main.rs）：
  • use log::info; use log4rs::init_file; fn main() { init_file(“log4rs.yaml”, Default::default()).unwrap(); info!(“log4rs 已初始化”); }
• 要点：
  • 通过 refresh_rate 实现配置热更新；使用 pattern 自定义格式；可按模块设置 loggers 与级别，实现差异化输出。
  • 建议将日志目录（如 /var/log/myapp）预先创建并设定权限（如 myapp:myapp 755），便于 systemd 与文件写入。

四 与 systemd 和 journald 集成

• 部署为服务（/etc/systemd/system/myapp.service）：
  • [Unit]
    • Description=My Rust App
    • After=network.target
  • [Service]
    • User=myapp
    • Group=myapp
    • ExecStart=/opt/myapp/target/release/myapp
    • Restart=always
    • RestartSec=3
    • StandardOutput=journal
    • StandardError=journal

    • 如需同时落盘，可在程序内用 log4rs 写文件

  • [Install]
    • WantedBy=multi-user.target
• 常用 journalctl 查询：
  • 查看日志：sudo journalctl -u myapp
  • 实时跟踪：sudo journalctl -u myapp -f
  • 按时间/级别过滤：sudo journalctl -u myapp --since “2025-12-09 10:00:00” -p err
• 说明：
  • 将 StandardOutput/StandardError 设为 journal 时，应用的标准输出会被 journald 捕获；若程序内已写入文件（如 log4rs），则形成“双写”（journald + 文件），便于集中与落盘各取所需。

五 实践建议

• 库 vs 应用：编写库时仅依赖 log 门面；应用选择 env_logger/log4rs/tracing 之一，避免混用导致配置分散。
• 日志级别：生产默认 info，问题排查临时提升到 debug/trace；通过 RUST_LOG 或配置文件按模块细粒度控制。
• 时间与格式：统一包含 时间、级别、模块(target)、消息；在 systemd 场景，journal 已带时间，文件日志建议保留时间以便离线分析。
• 文件与轮转：长期运行服务优先使用 log4rs 的文件与滚动策略，避免单文件过大；目录与权限提前规划（如 /var/log/myapp）。
• 异步与性能：高并发/异步场景优先考虑 tracing 生态（如非阻塞写入、与 Tokio 集成）；写入文件时结合 tracing-appender 的非阻塞 writer 降低对业务线程影响。