log4cplus 日志
介绍
log4cplus 是一个 C++ 版本的日志库,它是 Apache 组织的 log4j 日志库的一个开源实现。log4cplus 提供了一个灵活的、高性能的日志系统,支持多线程、本地化和分层结构。
log4cplus 的主要特点如下:
- 灵活性:log4cplus 提供了灵活的配置机制,可以在运行时动态地修改日志级别、追踪器、Appender 等配置信息。同时,log4cplus 通过继承结构、过滤器、日志记录器等机制,提供了更加高度自定义化的配置。
- 高性能:log4cplus 使用多线程技术,可以高效地处理大量的日志记录请求,同时支持异步日志记录,减小了日志记录对应用程序性能的影响。
- 多平台支持:log4cplus 可以跨平台运行,可以在 Windows、Linux、Unix 等平台上使用。
- 多语言支持:log4cplus 支持本地化,它可以输出不同语言的日志信息。
使用 log4cplus,我们可以使用不同级别的日志记录来控制日志信息的输出,从而帮助我们快速定位和修复问题。此外,log4cplus 还支持多个日志记录器,可以让我们对不同模块的日志信息进行不同的控制和输出。
直接使用
您可以从 log4cplus 的官方网站上下载 log4cplus,网站地址为:http://log4cplus.sourceforge.net。
在网站上,您可以找到最新版本的 log4cplus 以及相关的文档和示例代码。下载 log4cplus 的方法如下:
- 打开 log4cplus 的官方网站:http://log4cplus.sourceforge.net。
- 在“Downloads”页面,选择适合您系统的版本下载。您可以下载源代码或者预编译的二进制文件。
- 解压下载的文件,按照文档说明进行安装和配置。
- 如果您需要使用 log4cplus 的扩展功能,您还需要下载相应的扩展库。
安装好 log4cplus 后,您就可以开始使用了。在代码中引用相关的头文件,并使用 log4cplus 提供的 API 进行日志记录
编译
-
准备工作
国内的镜像:https://gitcode.net/mirrors/log4cplus/log4cplus
github地址:https://github.com/log4cplus/log4cplus
注意,需要更新子模块,catch,threadpool -
window下cmake
ps 需要注意的点,1.宏 WITH_UNIT_TESTS 取消打勾 2.填写自己的安装路径
这边我用的是vs2019,x64 -
sln 项目
找到log4cplus.sln,建议给目前全部权限(碰到过由于权限不够,无法创建文件夹)。
对了,之前也有人说项目要Unicode字符集,cmake生成的项目都是符合要求的。
直接编译 – lib目录在src/Release或者Debug,动态库在bin目录下
项目添加log4cplus
- 右键 vs项目INSTALL,就会生成在之前cmake上的配置的路径下
自己可以在这个基础上细分debug和release - 添加lib以及include
在VC目录下的库目录中加入logModule\lib以及包含目录加入.\logModule\include
//加载库
#ifdef _WIN64
#ifdef _DEBUG
#pragma comment(lib,"logModule/lib/log4cplusUD.lib")
#else
#pragma comment(lib,"logModule/lib/log4cplusU.lib")
项目:**ISO C++20 标准 (/std:c++20)**,c++语言标准:**ISO C++20 标准 (/std:c++20)**
- 具体用法
其实网上有很多可以参考的,可以用配置文件或者直接在代码里面配置。
log4cplus 的基本使用步骤如下:
- 引入头文件:包含 log4cplus/logger.h 和 log4cplus/configurator.h 头文件。
- 初始化配置:在程序初始化时调用 log4cplus 的配置器进行配置。如下所示:
#include <log4cplus/logger.h>
#include <log4cplus/configurator.h>
log4cplus::initialize();
log4cplus::BasicConfigurator::doConfigure();
这里使用了 BasicConfigurator 进行基本配置,您也可以使用 XMLConfigurator 或者PropertyConfigurator 进行更加灵活的配置。
- 创建日志记录器:使用 getLogger() 方法创建一个日志记录器。如下所示:
#include <log4cplus/logger.h>
log4cplus::Logger logger = log4cplus::Logger::getInstance(LOG4CPLUS_TEXT("main"));
- 记录日志:调用日志记录器的方法,如 DEBUG、INFO、WARN、ERROR 和 FATAL 等级别的记录方法。如下所示:
LOG4CPLUS_DEBUG(logger, "This is a debug message.");
LOG4CPLUS_INFO(logger, "This is an info message.");
LOG4CPLUS_WARN(logger, "This is a warning message.");
LOG4CPLUS_ERROR(logger, "This is an error message.");
LOG4CPLUS_FATAL(logger, "This is a fatal message.");
- 也可以在记录日志的时候,使用 printf-style 的格式化方式加入参数,例如:
LOG4CPLUS_DEBUG_FMT(logger, "This is a debug message with number:%d.", 123);
- 关闭日志系统:在程序结束时调用 log4cplus 的 shutdown() 方法关闭日志系统。
log4cplus::Logger::shutdown();
- 自定义配置:如果您需要自定义配置,例如输出到文件或者使用其他 Appender,则可以使用 PropertyConfigurator 或者 XMLConfigurator 进行配置。例如:
log4cplus::PropertyConfigurator config("log4cplus.properties");
config.configure();
log4cplus.properties
# ALL TRACE DEBUG INFO WARN ERROR FATAL OFF
log4cplus.rootLogger = TRACE,SA
log4cplus.logger.logConsole = TRACE,LC
#For database stuff, I don't need to logging everything, it's enough printing only errors!
#log4cplus.logger.DatabaseOperations=ERROR
#log4cplus.additivity.file=false
log4cplus.appender.LC=log4cplus::ConsoleAppender
log4cplus.appender.LC.EnCoding=utf-8
log4cplus.appender.LC.layout=log4cplus::PatternLayout
log4cplus.appender.LC.layout.ConversionPattern=[%D{%Y-%m-%d %H:%M:%S}] %m [%l]%n
#设置日志追加到文件尾
log4cplus.appender.SA=log4cplus::TimeBasedRollingFileAppender
//log4cplus.appender.SA.File = Mylogger.log
# 必须要先手动创建好log目录;否则无法创建文件
log4cplus.appender.SA.FilenamePattern= ./log/%d{yyyy-MM-dd_HH-mm}.log
log4cplus.appender.SA.Schedule = MINUTELY
log4cplus.appender.SA.CreateDirs = true
log4cplus.appender.SA.MaxHistory = 9999
log4cplus.appender.SA.RollOnClose = false
#设置日志文件大小
log4cplus.appender.SA.MaxFileSize = 100MB
#设置生成日志最大个数
log4cplus.appender.SA.MaxBackupIndex = 100
log4cplus.appender.SA.Append = true
log4cplus.appender.SA.layout=log4cplus::PatternLayout
log4cplus.appender.SA.layout.ConversionPattern=[%-5p][%D{%m/%d/%y %H:%M:%S:%Q}] [%t] %c - %m [%l]%n
#设置日志级别范围
log4cplus.appender.SA.filters.1=log4cplus::spi::LogLevelRangeFilter
log4cplus.appender.SA.filters.1.LogLevelMin=DEBUG
log4cplus.appender.SA.filters.1.LogLevelMax=FATAL
log4cplus.appender.SA.filters.1.AcceptOnMatch=true
log4cplus.appender.SA.filters.2=log4cplus::spi::DenyAllFilter