zlog使用文档

zlog 使用文档 zlog 是一个高可靠性、高性能、线程安全、灵活、概念清晰的纯 C 日志函数库。它提供了许多有用的特性，例如 syslog 分类模型、日志格式定制、多种输出、运行时手动、自动刷新配置文件、高性能、用户自定义等级、多线程和多进程环境下保证安全转档、精确到微秒、简单调用包装 dzlog、MDC、线程键-值对的表、自诊断等。 zlog 的设计目标是成为一个简而精的日志函数库，不会直接支持网络输出或者写入数据库，也不会直接支持日志内容的过滤和解析。这些操作应该在别的进程或者别的机器上做，如果需要这些特性，可以使用 rsyslog、zLogFabric、Logstash 等日志搜集、过滤、存储软件。 zlog 的使用非常广泛，在 C 的世界里面没有特别好的日志函数库，zlog 的出现弥补了这个缺憾。它支持 POSIX 系统，且可以在多种平台上运行，包括 AIX、Linux、FreeBSD、NetBSD、OpenBSD、OpenSolaris、Mac OS X 等。 zlog 的性能非常高，在笔记本上达到 25 万条日志每秒，大概是 syslog(3)配合 rsyslogd 的 1000 倍速度。它也提供了用户自定义等级的日志输出，可以根据需要选择不同的日志等级。 zlog 的配置非常灵活，支持多种输出，包括动态文件、静态文件、stdout、stderr、syslog、用户自定义输出函数等。它也提供了运行时手动、自动刷新配置文件的功能，保证了日志输出的安全性。 zlog 的线程安全性也非常好，在多线程和多进程环境下都能保证安全转档。它也提供了 MDC、线程键-值对的表，可以扩展用户自定义的字段。 zlog 的自诊断功能也非常强大，可以在运行时输出 zlog 自己的日志和配置状态，帮助用户快速诊断问题。 在使用 zlog 时，需要注意的是，它基于 POSIX 系统，需要使用 C99 兼容的 vsnprintf 函数库。如果在你的系统上 vsnprintf 不是这么运作的，zlog 就不知道怎么扩大缓存。如果在目标缓存不够的时候 vsnprintf 返回-1，zlog 就会认为这次写入失败。 zlog 是一个非常优秀的日志函数库，提供了许多有用的特性和功能，非常适合在 C 项目中使用。