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

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 
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级别，风格等。

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

 

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 结果如下：

2020-06-22 16:18:47 INFO [15456:test.c:16] hello, zlog 10, 12asfew
2020-06-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

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