log4cplus快速入门指南

一、基础配置四步法

1.1 初始化流程

graph TD
    A[包含头文件] --> B[初始化日志系统]
    B --> C[创建Logger对象]
    C --> D[配置Appender]
    style B fill:#6f9,stroke:#333

1.2 最小化示例

#include <log4cplus/logger.h>
#include <log4cplus/configurator.h>

int main() {
    // 初始化配置（默认加载基础配置）
    log4cplus::initialize();
    log4cplus::PropertyConfigurator::doConfigure("log4cplus.properties");
    
    // 获取Logger实例
    log4cplus::Logger logger = log4cplus::Logger::getInstance("MainLogger");
    
    // 输出日志
    LOG4CPLUS_INFO(logger, "系统启动完成");
    return 0;
}

二、配置文件详解

2.1 核心配置项

# log4cplus.properties 示例
log4cplus.rootLogger=INFO, CONSOLE, FILE

# 控制台输出
log4cplus.appender.CONSOLE=log4cplus::ConsoleAppender
log4cplus.appender.CONSOLE.layout=log4cplus::PatternLayout
log4cplus.appender.CONSOLE.layout.ConversionPattern=[%D{%Y-%m-%d %H:%M:%S}] %-5p %c - %m%n

# 文件输出
log4cplus.appender.FILE=log4cplus::RollingFileAppender
log4cplus.appender.FILE.File=app.log
log4cplus.appender.FILE.MaxFileSize=10MB
log4cplus.appender.FILE.MaxBackupIndex=5
log4cplus.appender.FILE.layout=log4cplus::PatternLayout
log4cplus.appender.FILE.layout.ConversionPattern=[%D] %-5p %l - %m%n

2.2 日志级别对照表

级别宏	数值	说明
FATAL_LOG	0	致命错误（最高级）
ERROR_LOG	1	错误信息
WARN_LOG	2	警告信息
INFO_LOG	3	常规信息（默认级别）
DEBUG_LOG	4	调试信息
TRACE_LOG	5	跟踪信息（最详细）

三、高级功能实战

3.1 动态修改日志级别

// 运行时调整日志级别
logger.setLogLevel(log4cplus::DEBUG_LOG_LEVEL);
LOG4CPLUS_DEBUG(logger, "此消息现在可见");

// 恢复默认级别
logger.setLogLevel(log4cplus::NOT_SET_LOG_LEVEL);

3.2 自定义格式输出

// 创建自定义Layout
log4cplus::tstring pattern = "%D{%Y-%m-%d %H:%M:%S.%q} [%t] %-5p %c - %m%n";
std::auto_ptr<log4cplus::Layout> layout(new log4cplus::PatternLayout(pattern));

// 应用到Appender
log4cplus::SharedAppenderPtr appender(new log4cplus::ConsoleAppender());
appender->setLayout(layout);
logger.addAppender(appender);

四、性能优化技巧

4.1 异步日志配置

# 启用异步日志
log4cplus.appender.ASYNC=log4cplus::AsyncAppender
log4cplus.appender.ASYNC.Appender=FILE
log4cplus.appender.ASYNC.QueueLimit=1000

4.2 条件日志输出

// 避免不必要的字符串构造
if (logger.isEnabledFor(log4cplus::DEBUG_LOG_LEVEL)) {
    std::string expensiveData = generateComplexDebugInfo();
    LOG4CPLUS_DEBUG(logger, expensiveData);
}

五、多场景应用示例

5.1 多Logger分级控制

// 创建不同功能的Logger
log4cplus::Logger netLogger = 
    log4cplus::Logger::getInstance("Network");
log4cplus::Logger dbLogger = 
    log4cplus::Logger::getInstance("Database");

// 分别设置级别
netLogger.setLogLevel(log4cplus::INFO_LOG_LEVEL);
dbLogger.setLogLevel(log4cplus::DEBUG_LOG_LEVEL);

5.2 异常日志记录

try {
    riskyOperation();
} catch (const std::exception& e) {
    LOG4CPLUS_ERROR(
        logger, 
        "操作失败: " << e.what() << " (错误码:" << errno << ")"
    );
    throw;
}

六、最佳实践建议

1. ​配置分离​：生产环境与开发环境使用不同配置文件
2. ​日志轮转​：设置合理的MaxFileSize和MaxBackupIndex
3. ​敏感信息​：避免在日志中记录密码等敏感数据
4. ​性能监控​：定期检查日志系统性能影响

完整示例项目结构

project/
├── include/
├── src/
│   └── main.cpp
├── config/
│   ├── log4cplus_dev.properties
│   └── log4cplus_prod.properties
└── logs/
    ├── app.log
    └── app.log.1

通过本指南，您已掌握log4cplus的核心用法。关键要点：

• 使用PropertyConfigurator实现灵活配置
• 合理设置日志级别平衡信息量与性能
• 异步日志适合高并发场景
• 多Logger分类管理便于问题排查

建议进一步探索：

• 自定义Appender实现日志报警
• 集成到系统服务监控
• 结合ELK搭建日志分析平台