log4cplus：C++日志系统详解与安装指南

log4cplus
使用说明
4星 · 超过85%的资源 需积分: 31 14 下载量 96 浏览量 更新于2024-09-16 收藏 159KB PDF 举报
“log4cplus使用说明” log4cplus是一个用C++编写的开源日志系统，源自Java的log4j。它提供线程安全、灵活性和多粒度控制的功能，使得开发者能够针对程序的不同阶段，如调试、运行、测试和维护，进行有针对性的日志记录。log4cplus支持将日志信息输出到多种目的地，包括控制台、文件、NT Event Log，甚至远程服务器。此外，它还具备日志文件的定期备份策略。 要获取log4cplus的最新版本，你可以访问"http://log4cplus.sourceforge.net"并下载对应版本的log4cplus-x.x.x。 在Linux环境下安装log4cplus，你需要按照以下步骤操作： 1. 解压缩下载的log4cplus-x.x.x.tar.gz文件到当前目录。 2. 进入解压后的log4cplus-x.x.x目录。 3. 在该目录下运行`./configure`脚本。 4. 执行`make`命令进行编译。 5. 使用`make install`命令进行安装。建议以root用户身份执行这些步骤。 在Windows系统下，log4cplus无需正式安装。你可以找到包含源码和示例项目的msvc6文件夹，其中包含适用于VC6的项目文件。你需要编译"log4cplus_dllclass"工程来生成DLL，或者编译"log4cplus_staticclass"工程来生成静态库LIB。 在使用log4cplus前，你需要进行相应的配置： 1. 对于Linux，确保Makefile中指定了静态库`/usr/local/lib/liblog4cplus.a`或链接器选项`-llog4cplus`（对于动态库）。头文件位于`/usr/local/include/log4cplus`目录。如果使用动态库，还需将库路径（如`/usr/local/lib`）添加到`LD_LIBRARY_PATH`环境变量，并运行`/sbin/ldconfig`以应用更改。 2. 在Windows系统中，你可以将"log4cplus_dllclass"或"log4cplus_staticclass"的DSP文件添加到你的项目中，或者直接将库文件及头文件所在的目录添加到工程的搜索路径。如果选择使用静态库，确保你的工程配置正确引用了相应的库文件。 log4cplus的配置通常涉及创建配置文件，该文件定义了日志记录的行为，如日志级别、输出目的地、格式等。通过这些配置，你可以精确控制哪些信息被记录以及如何处理这些信息。例如，你可以设置日志级别为ERROR，只记录错误信息，或者设置为DEBUG，记录所有调试信息。此外，你还可以定制日志格式，包括时间戳、线程ID、日志级别和日志消息本身。 log4cplus是一个强大的日志记录框架，它允许开发者在各种环境中方便地管理和控制日志输出，从而提高软件的可维护性和调试效率。通过合理的配置和使用，log4cplus能够帮助开发者更好地理解程序的运行状态，快速定位和解决问题。

log4cplus开发手册

1233 浏览量
log4cplus文档chm版本，我已经用doxygen编译完毕，这个使用手册对开发非常有帮助。

log4cplus 源码(C++编写的开源的日志系统)

1038 浏览量
log4cplus是C++编写的开源的日志系统，功能非常全面，用到自己开发的工程中会比较专业的，：），本文介绍了log4cplus基本概念，以及如何安装，配置。 ### 简介 ### log4cplus是C++编写的开源的日志系统，前身是java编写的log4j系统.受Apache Software License保护。作者是Tad E. Smith。log4cplus具有线程安全、灵活、以及多粒度控制的特点，通过将信息划分优先级使其可以面向程序调试、运行、测试、和维护等全生命周 期； 你可以选择将信息输出到屏幕、文件、 NT event log、甚至是远程服务器；通过指定策略对日志进行定期备份等等。 ### 下载 ### 最新的log4cplus可以从以下网址下载 http://log4cplus.sourceforge.net本文使用的版本为：1.0.2 ### 安装 ### 1. linux下安装 tar xvzf log4cplus-x.x.x.tar.gz cd log4cplus-x.x.x ./configure --prefix=/where/to/install make make install 这里我采用缺省安装路径：/usr/local，下文如无特别说明，均以此路径为准。 2. windows下安装 不需要安装，有一个msvc6存放包括源代码和用例在内的开发工程（for VC6 only），使用之前请先编译 "log4cplus_dll class"工程生成dll，或者编译"log4cplus_static class"工程生成lib. ### 使用前的配置 ### 1. linux下的配置 确保你的Makefile中包含 /usr/local/lib/liblog4cplus.a（静态库）或 -llog4cplus（动态库）即可， 头文件在/usr/local/include/log4cplus目录下。对于动态库，要想正常使用，还得将库安装路径加入到 LD_LIBRARY_PATH 中，我一般是这样做的：以管理员身份登录，在/etc/ld.so.conf中加入安装路径，这里 是/usr/local/lib，然后执行ldconfig使设置生效即可。 2. windows下的配置 将"log4cplus_dll class"工程或"log4cplus_static class"工程的dsp 文件插入到你的工程中，或者直接 把两个工程编译生成的库以及头文件所在目录放到你的工程的搜索路径中，如果你使用静态库，请在你的工程中 "project/setting/C++"的preprocessor definitions中加入LOG4CPLUS_STATIC。 ### 构成要素介绍 ### 虽然功能强大，应该说log4cplus用起来还是比较复杂的，为了更好地使用它，先介绍一下它的基本要素。 Layouts ：布局器，控制输出消息的格式. Appenders ：挂接器，与布局器紧密配合，将特定格式的消息输出到所挂接的设备终端 （如屏幕，文件等等)。 Logger ：记录器，保存并跟踪对象日志信息变更的实体，当你需要对一个对象进行 记录时，就需要生成一个logger。 Categories ：分类器，层次化（hierarchy）的结构，用于对被记录信息的分类，层次中 每一个节点维护一个logger的所有信息。 Priorities ：优先权，包括TRACE, DEBUG, INFO, WARNING, ERROR, FATAL。 本文介绍了log4cplus基本概念，以及如何安装，配置，下一篇将通过例子介绍如何使用log4cplus。 （二） 本文介绍了使用log4cplus有六个步骤，并提供了一些例子引导你了解log4cplus的基本使用。 ### 基本使用 ### 使用log4cplus有六个基本步骤： 1. 实例化一个appender对象 2. 实例化一个layout对象 3. 将layout对象绑定(attach)到appender对象 4. 实例化一个logger对象,调用静态函数：log4cplus::Logger::getInstance("logger_name") 5. 将appender对象绑定(attach)到logger对象，如省略此步骤，标准输出（屏幕）appender对象会绑定到logger 6. 设置logger的优先级，如省略此步骤，各种有限级的消息都将被记录 下面通过一些例子来了解log4cplus的基本使用。 〖例1〗 cpp 代码 /* 严格实现步骤1-6，appender输出到屏幕, 其中的布局格式和LogLevel后面会详细解释。*/ #include #include #include using namespace log4cplus; using namespace log4cplus::helpers; int main(){ /* step 1: Instantiate an appender object */ SharedObjectPtr _append (new ConsoleAppender()); _append->setName("append for test"); /* step 2: Instantiate a layout object */ std::string pattern = "%d{%m/%d/%y %H:%M:%S} - %m [%l]%n"; std::auto_ptr _layout(new PatternLayout(pattern)); /* step 3: Attach the layout object to the appender */ _append->setLayout( _layout ); /* step 4: Instantiate a logger object */ Logger _logger = Logger::getInstance("test"); /* step 5: Attach the appender object to the logger */ _logger.addAppender(_append); /* step 6: Set a priority for the logger */ _logger.setLogLevel(ALL_LOG_LEVEL); /* log activity */ LOG4CPLUS_DEBUG(_logger, "This is the FIRST log message...") sleep(1); LOG4CPLUS_WARN(_logger, "This is the SECOND log message...") return 0; } 输出结果： 10/14/04 09:06:24 - This is the FIRST log message... [main.cpp:31] 10/14/04 09:06:25 - This is the SECOND log message... [main.cpp:33] 〖例2〗 /* 简洁使用模式，appender输出到屏幕。 */ #include #include using namespace log4cplus; using namespace log4cplus::helpers; int main() { /* step 1: Instantiate an appender object */ SharedAppenderPtr _append(new ConsoleAppender()); _append->setName("append test"); /* step 4: Instantiate a logger object */ Logger _logger = Logger::getInstance("test"); /* step 5: Attach the appender object to the logger */ _logger.addAppender(_append); /* log activity */ LOG4CPLUS_DEBUG(_logger, "This is the FIRST log message...") sleep(1); LOG4CPLUS_WARN(_logger, "This is the SECOND log message...") return 0; } 输出结果： DEBUG - This is the FIRST log message... WARN - This is the SECOND log message... 〖例3〗 /* iostream模式，appender输出到屏幕。 */ #include #include #include /* 其实这个东东还是放到log4cplus头文件中比较合适些，个人意见：） */using namespace log4cplus; int main() { /* step 1: Instantiate an appender object */ SharedAppenderPtr _append(new ConsoleAppender()); _append->setName("append test"); /* step 4: Instantiate a logger object */ Logger _logger = Logger::getInstance("test"); /* step 5: Attach the appender object to the logger */ _logger.addAppender(_append); /* log activity */ LOG4CPLUS_TRACE(_logger, "This is" << " just a t" << "est." << std::endl) LOG4CPLUS_DEBUG(_logger, "This is a bool: " << true) LOG4CPLUS_INFO(_logger, "This is a char: " << 'x') LOG4CPLUS_WARN(_logger, "This is a int: " << 1000) LOG4CPLUS_ERROR(_logger, "This is a long(hex): " << std::hex << 100000000) LOG4CPLUS_FATAL(_logger, "This is a double: " << std::setprecision(15) << 1.2345234234) return 0; } 输出结果： DEBUG - This is a bool: 1 INFO - This is a char: x WARN - This is a int: 1000 ERROR - This is a long(hex): 5f5e100 FATAL - This is a double: 1.2345234234 〖例4〗 /* 调试模式，通过loglog来控制输出调试、警告或错误信息，appender输出到屏幕。 */ #include #include using namespace log4cplus::helpers; void printMsgs(void) { std::cout << "Entering printMsgs()..." << std::endl; LogLog::getLogLog()->debug("This is a Debug statement..."); LogLog::getLogLog()->warn("This is a Warning..."); LogLog::getLogLog()->error("This is a Error..."); std::cout << "Exiting printMsgs()..." << std::endl << std::endl; } int main() { /* LogLog类实现了debug, warn, error 函数用于输出调试、警告或错误信息， 同时提供了两个方法来进一步控制所输出的信息，其中： setInternalDebugging方法用来控制是否屏蔽输出信息中的调试信息，当输入 参数为false则屏蔽，缺省设置为false。 setQuietMode方法用来控制是否屏蔽所有输出信息，当输入参数为true则屏蔽， 缺省设置为false。 LogLog::getLogLog()->setInternalDebugging(false); */ printMsgs(); std::cout << "Turning on debug..." << std::endl; LogLog::getLogLog()->setInternalDebugging(true); printMsgs(); std::cout << "Turning on quiet mode..." << std::endl; LogLog::getLogLog()->setQuietMode(true); printMsgs(); return 0; } 输出结果： Entering printMsgs()... log4cplus:WARN This is a Warning... log4cplus:ERROR This is a Error... Exiting printMsgs()... Turning on debug... Entering printMsgs()... log4cplus: This is a Debug statement... log4cplus:WARN This is a Warning... log4cplus:ERROR This is a Error... Exiting printMsgs()... Turning on quiet mode... Entering printMsgs()... Exiting printMsgs()... 需要指出的是，输出信息中总是包含"log4cplus:"前缀，有时候会感觉不爽，这是因为LogLog在实现时候死定了要这么写： LogLog::LogLog() : mutex(LOG4CPLUS_MUTEX_CREATE), debugEnabled(false), quietMode(false), PREFIX( LOG4CPLUS_TEXT("log4cplus: ") ), WARN_PREFIX( LOG4CPLUS_TEXT("log4cplus:WARN ") ), ERR_PREFIX( LOG4CPLUS_TEXT("log4cplus:ERROR ") ) { } 你可以把这些前缀换成自己看着爽的提示符号，然后重新编译，hihi。除非万不得已或者实在郁闷的不行，否则还是不要这样干。

log4cplus 一个开源的c++日志库

712 浏览量
一个非常好用的开源c++的日志库。写的非常好。是和log4jxxx是一个系列。我用它主要是可以和linux下的syslog的对接。有兴趣的可以去 源码库http://sourceforge.net/projects/log4cplus/files/log4cplus-stable/下载。

log4cplus cmake

141 浏览量
要为log4cplus使用CMake构建系统，你需要创建一个CMakeLists.txt文件来描述项目的构建过程。以下是一个示例CMakeLists.txt文件可以帮助你开始： ```cmake cmake_minimum_required(VERSION 3.0) project(log4cplus_...

项目中如何使用log4cplus

2023-05-30 上传
首先，需要在项目中引入log4cplus库。具体方法可以在log4cplus的官网上找到相应的下载链接和使用说明。...以上是一个简单的log4cplus使用示例，具体使用方法可以参考log4cplus的官方文档和示例代码。

link_libraries(log4cplus::log4cplus)

125 浏览量
使用link_libraries(log4cplus::log4cplus)命令后，你的项目将能够使用log4cplus库提供的功能。这个命令会告诉CMake在构建过程中链接log4cplus库，并将其包含在生成的可执行文件或库中。 需要注意的是，使用link_...

Linux log4cplus

132 浏览量
要使用log4cplus，首先需要在Linux系统上安装log4cplus库。可以通过以下步骤进行安装： 1. 下载log4cplus库的源代码包。可以从GitHub（https://github.com/log4cplus/log4cplus）或SourceForge...

log4cplus linux

244 浏览量
总结一下，要在Linux下使用log4cplus，你需要下载并安装log4cplus的源代码，配置你的项目来链接log4cplus库，并使用log4cplus的API来记录日志。你还可以根据需要创建一个配置文件来设置日志输出方式和级别。 希望...

MFC中如何使用log4cplus/log4cplus.h

2024-11-18 上传
在MFC（Microsoft Foundation Classes）环境中集成log4cplus库需要一些额外的步骤，因为log4cplus是一个C++的日志框架，而MFC主要是用于Windows应用程序的。以下是基本的步骤： 1. **下载和包含库**： - 首先，从...

log4cplus配置

314 浏览量
log4cplus 是一个开源的日志库，用于 C++ 程序的日志记录。要配置 log4cplus，你可以按照以下...以上是一个简单的 log4cplus 配置和使用示例。你可以根据你的需求进一步调整和扩展配置文件，以满足你的日志记录需求。
forlove89
  • 粉丝: 2
  • 资源: 29
上传资源 快速赚钱

最新资源