Log4c学习笔记

最新推荐文章于 2025-01-10 18:32:00 发布

烫手De冰

最新推荐文章于 2025-01-10 18:32:00 发布

阅读量5k

点赞数

CC 4.0 BY-SA版权

分类专栏： C++ Linux/Solaris 文章标签： c file layout null struct logging

本文链接：https://blog.youkuaiyun.com/kingsong0816/article/details/6029863

本文介绍了Log4c，一个C语言的日志库，对比了它与其他C++日志库的区别，并详细讲解了Log4c中的关键概念：Category、Appender和Layout。Category用于分类日志，Appender定义输出目的地，如stdout或文件，而Layout则规定日志的显示格式。此外，还提及了文件输出的rollingpolicy配置策略。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1.Log工具简单比较

Log4cpp & Log4CPlus：C++的日志库，可移植移性相对差些
Log4c：C的日志库，基本上都是一些纯c的东西，移植性较好

2.Log4c的基本概念
Log4c中有三个重要的概念, Category, Appender, Layout。
　　Category用于区分不同的日志，在一个程序中我们可以通过Category来指定很多的日志。
　　Appdender用于描述输出流，通过为Category来指定一个Appdender，可以决定将log信息来输出到什么地方去，比如stdout, stderr, rollingfile等等。
　　Layout用于指定日志信息的格式，通过为Appender来指定一个Layout,可以决定log信息以何种格式来输出，比如是否有带有时间戳，是否包含文件位置信息等，以及他们在一条log信息中的输出格式的等。
Category, Appender, Layout三者之间的关系，一个Category需要为其指定一个appender，一个appender亦要为其指定一个layout。
另外，对于文件类型输出还有一个rollingpolicy。rollingpolicy用于描述文件输出的配置策略。

3.关于配置
配置文件示例如下：

<!DOCTYPE log4c SYSTEM "">
<log4c version="1.2.0">
　　<config>
　　　　<bufsize>0</bufsize>
　　　　<debug level="0"/>
　　　　<nocleanup>0</nocleanup>
　　</config>
　　
　　<layout name="dated" type="dated_l"/>
　　
　　
　　　　<appender name="LoadBusinessLog" type="rollingfile" logdir="../etc/log"
　　　　　　　prefix="LoadBusiness-" layout="dated_l"　rollingpolicy="Policy1" />
　
　　　 <appender name="CataRollingFileAppender" type="rollingfile" logdir="../etc/log/"
　　　　　　 prefix="testLog"　layout="dated"　rollingpolicy="RollingPolicy" />

　　　　
　　　　<category name="root" priority="notice"/>
　　　　<category name="framework" priority="info" appender="FrameLog" />
　　　　<category name="test.log" priority="trace" appender="CataRollingFileAppender" />

　　　　
　　　　<rollingpolicy name="Policy1" type="timewin" timetype="1" maxnum="10" />
　　　　<rollingpolicy name="RollingPolicy" type="sizewin" maxsize="102400" maxnum="10" />
</log4c>

3.1 category
name：日志的名称
priority：日志的优先级，共有fatal、alert、crit、error、warn、notice、info、debug、trace、notset和unknown11个级别，其级别逐步递增，记录在日志中的数据为小于等于指定级别的数据。
appender：输出流类型名称，为appender节点的name属性的值。

3.2 appender
name：输出流名称
type：输出流类型，共有stream、syslog、rollingfile三大类
layout：输出日志的格式的名称，为layout节点的name属性的值。
rollingpolicy：输出日志文件配置策略名称，为rollingpolicy节点的name属性的值。
rollingpolicy的timewin类型的日志输出为自定义类型

3.3 layout
name：输出日志的格式名称
type：输出日志格式的类型，共有base 、dated、dated_l等格式类型，对于自定义类型也有配置在这里，否则不能够加载。
base：%P %c - %m/n
　　　　 "%P" 日志信息的优先级
　　　　 "%c" 日志的名称
　　　　 "%m" 日志信息内容
dated：%d %P %c - %m/n
　　　　　"%d" 日志信息产生的时间，UTC格式yyyymmdd hh:mm:ss.mis
　　　　 "%P" 日志信息的优先级
　　　　 "%c" 日志的名称
　　　　 "%m" 日志信息内容
dated_l：%d %P %c - %m/n　（源代码里面没有，自己增加的）
　　　　 "%d" 日志信息产生的时间，本地时间格式yyyymmdd hh:mm:ss
　　　　 "%P" 日志信息的优先级
　　　　 "%c" 日志的名称
　　　　 "%m"日志信息内容

3.4 rollingpolicy
name：日志文件输出的配置策略名称。
type：日志文件输出的配置策略的类型，有sizewin一种类型。
maxsize：输出日志文件的最大值。默认值为20KB
maxnum：保存的历史日志文件总数。默认值为5

3.5 配置文件的路径：
${ LOG4C_RCPATH }/log4crc　　//环境变量中设置的配置文件夹下log4crc
${HOME}/.log4crc　　　　　　 //HOME文件夹下log4crc
./log4crc　　　　　　　　　　//当前可执行文件夹下log4crc

4、Log4c的基本使用

头文件（直接引用log4c.h程序编译出错，因此只引用需要的头文件）
extern "C" {
#include <log4c/init.h>
#include <log4c/category.h>
}

cpp文件
//初始化
log4c_init();
//获取一个已有的category
log4c_category_t* mycat = log4c_category_get("cata.log ");
//用该category进行日志输出，优先级为DEBUG，输出信息为 "Hello World!"
log4c_category_log(mycat, LOG4C_PRIORITY_DEBUG, "Hello World!");
//析构
log4c_fini();

//在日志输出过程中可以进行格式化输出：
log4c_category_log(mycat, LOG4C_PRIORITY_ERROR, "Error code = %d", 12345);
//对于格式化输出也可以有如下写法：
void CLog::Trace(const char * format, ... )
{
　　 if (log4c_category_is_priority_enabled(mycat, LOG4C_PRIORITY_TRACE))
　　 {
　　　　a_list argptr;
　　　　va_start(argptr, format);

　　　　log4c_category_vlog(mycat, LOG4C_PRIORITY_TRACE, format, argptr);

　　　　va_end(argptr);
　　 }
}

5.自定义Logout

5.1 添加在Log4c源代码中的流程

在log4c-1.2.0/src/文件夹添加相应的头文件和实现文件，如examplelayout.h和examplelayout.c文件
编辑log4c-1.2.0/src/log4c/Makefile.in
在am__liblog4c_la_SOURCES_DIST中添加examplelayout.c
在am_liblog4c_la_OBJECTS中添加examplelayout. lo
在liblog4c_la_SOURCES 中添加examplelayout.c
在pkginclude_HEADERS中添加 examplelayout.h
添加@AMDEP_TRUE@@am__include@ @am__quote@./$(DEPDIR)/ examplelayout.Plo@am__quote@
编辑log4c-1.2.0/src/log4c/Makefile.am
在liblog4c_la_SOURCES中添加examplelayout.c
在pkginclude_HEADERS中添加examplelayout.h
编辑log4c-1.2.0/src/init.c
添加#include <examplelayout.h>
在static const log4c_layout_type_t * const layout_types[]数组中添加新添加的layout_type函数指针
5.2在工程中添加自定义日志格式
实现自定义格式的主要函数：

static c