前言
Log4cplus是一个C++的日志库,它提供了灵活的日志记录功能,类似于Java的Log4j。它支持多种日志记录方式,包括控制台、文件、网络等。Log4cplus允许开发者通过配置文件来定义日志级别、日志格式、输出目的地等,非常适合需要进行日志管理的C++应用程序。
源码地址:
https://github.com/log4cplus/log4cplus
编译及安装
tar xvf log4cplus-2.0.6.tar.xz cd log4cplus-2.0.6 mkdir build cd build cmake .. make sudo make install
主要能力:
- 多线程支持:Log4cplus设计时考虑了多线程环境,能够安全地在多线程应用程序中使用。
- 灵活的配置:可以通过XML、YAML或直接通过代码来配置日志系统,包括日志级别、输出格式、输出目的地等。
- 灵活的配置:可以通过XML、YAML或直接通过代码来配置日志系统,包括日志级别、输出格式、输出目的地等。
- 多种输出目的地:支持将日志输出到控制台、文件、网络(如Syslog)、SMTP(发送邮件)等多种目的地。
- 日志级别:提供了DEBUG、INFO、WARN、ERROR、FATAL等日志级别,可以根据需要设置记录的日志级别。
- 自定义日志格式:用户可以自定义日志的输出格式,包括时间戳、日志级别、消息等。
- 过滤器:可以添加过滤器来控制日志消息的输出,例如,只记录特定级别的日志。
- 性能:Log4cplus在设计时考虑了性能,尽量减少日志记录对应用程序性能的影响。
- 滚动日志文件:支持日志文件滚动,即当日志文件达到一定大小或一定时间后,自动创建新的日志文件。
- 异步日志记录:可选的异步日志记录功能,可以提高应用程序的性能,减少日志记录对主线程的影响。
- Hierarchical Logging:支持分层日志记录,允许用户为不同的类或模块设置不同的日志级别。
- Appenders:Log4cplus使用Appender的概念来定义日志的输出方式,可以自定义Appender来扩展日志功能。
使用 log4cplus 的基本步骤和示例代码
- 实例化 Appender 对象:创建一个 Appender 来指定日志消息的输出位置,例如控制台、文件或网络。一个 Logger 可添加多个 Appender,从而向多个地方输出日志。
- 实例化 Layout 对象:创建一个 Layout 来定义日志消息的输出格式。
- 将 Layout 绑定到 Appender:将 Layout 对象绑定到 Appender 对象上,以确定日志的输出格式。
- 实例化 Logger 对象:使用 log4cplus::Logger::getInstance(“logger_name”) 获取 Logger 实例,并设置其日志输出等级阈值。
- 将 Appender 绑定到 Logger:将 Appender 对象添加到 Logger 实例上。
- 设置 Logger 的优先级:可选步骤,用于控制日志输出的详细程度。
使用示例:
标准使用示例:
#include <log4cplus/logger.h> #include <log4cplus/consoleappender.h> #include <log4cplus/layout.h> using namespace log4cplus; int main() { SharedObjectPtr<Appender> _append(new ConsoleAppender()); _append->setName("append for test"); std::string pattern = "%d{%m/%d/%y %H:%M:%S} - %m [%l]%n"; std::auto_ptr<Layout> _layout(new PatternLayout(pattern)); _append->setLayout(_layout); Logger _logger = Logger::getInstance("test"); _logger.addAppender(_append); _logger.setLogLevel(ALL_LOG_LEVEL); LOG4CPLUS_DEBUG(_logger, "This is the FIRST log message..."); }
简洁使用示例:
#include <log4cplus/logger.h> #include <log4cplus/consoleappender.h> using namespace log4cplus; int main() { SharedAppenderPtr _append(new ConsoleAppender()); _append->setName("append test"); Logger _logger = Logger::getInstance("test"); _logger.addAppender(_append); LOG4CPLUS_DEBUG(_logger, "This is the FIRST log message..."); }
异步模式使用:
- 在多线程环境中,为了避免日志输出时的冲突,可以使用异步模式。
- 发送日志到日志服务器:
#include <log4cplus/log4cplus.h> int main() { log4cplus::Initializer initializer; log4cplus::SharedAppenderPtr appender(new log4cplus::SocketAppender( LOG4CPLUS_TEXT("localhost"), 32015, LOG4CPLUS_TEXT("test"))); appender->setName(LOG4CPLUS_TEXT("logserver")); log4cplus::Logger logger = log4cplus::Logger::getInstance(LOG4CPLUS_TEXT("test")); logger.setLogLevel(log4cplus::INFO_LOG_LEVEL); logger.addAppender(appender); LOG4CPLUS_INFO(logger, LOG4CPLUS_TEXT("Hello world")); }
这些示例展示了如何配置和使用 log4cplus 进行基本的日志记录。大家可以根据项目的需求调整 Appender、Layout 和 Logger 的配置。