zlog 纯C日志函数库的简单使用方法

zlog简述:

log是一个高性能、线程安全、灵活、概念清晰的纯C日志函数库。

事实上,在C的世界里面没有特别好的日志函数库(就像JAVA里面的的log4j,或者C++的log4cxx)。C程序员都喜欢用自己的轮子。printf就是个挺好的轮子,但没办法通过配置改变日志的格式或者输出文件。syslog是个系统级别的轮子,不过速度慢,而且功能比较单调。log4c异常坑爹(有内存泄漏、效率低等等),而且已经停止开发 

zlog有这些特性:

 *  syslog分类模型,基于规则路由过滤,比log4j模型要正确高效,详见为什么log4j的概念模型是错误的

 *  日志格式定制,类似于log4j的pattern layout

 *  多种输出,包括动态文件、静态文件、stdout、stderr、syslog、用户自定义输出函数

 *  运行时手动或自动刷新配置(同时保证安全)

 *  高性能,在我的笔记本上达到338'638条日志每秒, 大概是syslog(3)配合rsyslogd的1000倍速度 

 *  高可靠性和速度之间的平衡,用户自定义多少条日志后fsync数据到硬盘

 *  用户自定义等级

 *  多线程和多进程环境下保证安全转档

 *  精确到微秒

 *  简单调用包装dzlog(一个程序默认只用一个分类)

 *  MDC,线程键-值对的表,可以扩展用户自定义的字段

 *  自诊断,可以在运行时输出zlog自己的日志和配置状态

 *  不依赖其他库,只要是个POSIX系统就成(当然还要一个C99兼容的vsnprintf)

 

http://hardysimpson.github.io/zlog/ 下载最新的zlog源码包。

1. tar -zxvf zlog-1.2.12.tar.gz 解压到当前目录。

2. 进入zlog-1.2.12, 执行make,在zlog-1.2.12/src/ 目录下生成libzlog.a 静态库和libzlog.so动态库。

3.编写测试程序test.c 

 1 #include "zlog.h"
 2 #include <stdio.h>
 4 int main()
 5 {
 6     int rc; 
 7         zlog_category_t *zc;
 8         rc = dzlog_init("./test.conf", "my_cat");
 9         if (rc) {
10             printf("init failed\n");
11             zlog_fini();
12             return -1; 
13         }   
14         int a = 10; 
15         char str[112] = "12asfew";
16         dzlog_info("hello, zlog %d, %s", a, str);
17         dzlog_debug("test  aa");
18         zlog_fini();
19         return 0;   
20 }

5. 编写一个最简单配置文件test.conf,通过配置文件来控制debug级别,风格等。

1 [formats]
2 simple  = "%m%n"
3 [rules]
4 my_cat.DEBUG >stdout;simple  //将debug以上级别的信息输出到 stdout中去,格式为simple类型格式

 

 6.编写Makefile, 文件目录如下

├── app
├── Makefile
├── test.c
├── test.conf
├── test.o
├── zlog-1.2.12
└── zlog-1.2.12.tar.gz

1 INCS = -I./zlog-1.2.12/src
2 CFLAGS = $(INCS) ./zlog-1.2.12/src/libzlog.a -lpthread
3 app:test.o
4         gcc -o app test.o $(CFLAGS)
5 test.o:test.c
6         gcc $(INCS) -c -o $@ $<
7 
8 clean:
9         rm test.o app

 

7.执行可执行文件app    ./app 结果如下:

2014-03-22 16:18:47 INFO [15456:test.c:16] hello, zlog 10, 12asfew
2014-03-22 16:18:47 DEBUG [15456:test.c:17] test aa

 

8.常用打印格式  

[formats]
my = "%f:%L|%V: %m%n"
[rules]
my_cat.DEBUG >stdout;my

 

 打印结果:

ser.cpp:39|INFO: hello, zlog 10, 12asfew
ser.cpp:40|DEBUG: test aa

 

[formats]
my = "%d|%f|%L|%V| %m%n"
[rules]
my_cat.DEBUG >stdout;my

 

打印结果:

2014-03-22 18:02:07|ser.cpp|39|INFO| hello, zlog 10, 12asfew
2014-03-22 18:02:07|ser.cpp|40|DEBUG| test aa

posted @ 2014-03-22 16:23  superPerfect  阅读(14075)  评论(1编辑  收藏  举报