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

#include "zlog.h"
#include <stdio.h>
int main()
{
int rc;
zlog_category_t *zc;
rc = dzlog_init("./test.conf", "my_cat");
if (rc) {
printf("init failed\n");
zlog_fini();
return -1;
}
int a = 10;
char str[112] = "12asfew";
dzlog_info("hello, zlog %d, %s", a, str);
dzlog_debug("test  aa");
zlog_fini();
return 0;
}

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

[formats]
simple  = "%m%n"
[rules]
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

INCS = -I./zlog-1.2.12/src
CFLAGS = $(INCS) ./zlog-1.2.12/src/libzlog.a -lpthread
app:test.o
gcc -o app test.o $(CFLAGS)
test.o:test.c
gcc $(INCS) -c -o $@ $<

clean:
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