QLog 是一个异步的日志记录引擎,由于不是同步记录日志内容,在程序被强行中止(含由于程序自身原因或被外部管理工具)时,会丢失部分日志内容。
QLog 的日志记录支持 syslogd 协议,因此,任何基于 syslogd 协议的日志服务器都可以接收并存贮由 QLog 发送的日志信息。
QLog 之所以采用异步的方式记录日志,是因为采用异步的方式的记录日志可以最大限度的降低由于日志记录需要的 IO 操作时间较长影响业务逻辑执行效率的问题。
QLog 记录日志的方式比较简单直接:
第一步,要引用 QLog 单元:
【Delphi】
uses qlog;
【C++ Builder】
#include "qlog.hpp"
早期版本自动创建了全局的实例,新版移除了该部分代码,改为由人工控制:
- 如果想创建文件日志,在程序的初始化部分调用 SetDefaultLogFile 来创建文件日志(实际上在第一次调用 PostLog 之前就可以),或者自己添加 TQLogWriter 子类的实例用于输出日志。
- 如果没有添加 TQLogWriter 的子类来输出日志,则 PostLog 不会实际输出日志。
第二步:如果创建了默认的 Logs 实例并绑定了 TQLogWriter 的实例,那么在 Delphi 中就可以直接调用 PostLog ,而在 C++ Builder 中,则提供了一个额外的名为 AddLog 的函数以方便使用参数化日志记录。
以上就是 QLog 的常规用法了。
【提示】
1、不使用 SetDefaultLogFile 来设置文件日志
【Delphi】
Logs.Castor.AddWriter(TQLogFileWriter.Create(你自己的包含完整路径的日志文件名));
【C++ Builder】
Logs->Castor->AddWriter(new TQLogFileWrite(你的包含完整路径的日志文件名));
这样子,日志文件就会在指定的目录下创建并记录日志。
2、使用 TQLogSocketWriter 作为日志记录器
TQLogSocketWriter 用于将日志写入到远程的日志服务器,服务器只要兼容 syslogd 协议即可接收到相关的日志内容。参考代码如下:
【Delphi]
var AWriter:TQLogSocketWriter; begin AWriter:=TQLogSocketWriter.Create; AWriter.ServerHost:='192.168.0.2'; AWriter.ServerPort:=514; AWriter.UseTCP:=False; Logs.Castor.AddWriter(AWriter); end;
【C++ Builder】
TQLogSocketWriter * AWriter=new TQLogSocketWriter; AWriter->ServerHost="192.168.0.2"; AWriter->ServerPort=514; AWriter->UseTCP=false; Logs->Castor->AddWriter(AWriter);
由于一般的 syslogd 服务器使用的都是 UDP 协议,所以 TQLogSocketWriter 默认情况下,UseTCP 属性都是 false,如果你要使用 TCP 协议传输,则请设置 UseTCP 为 True 即可。
3、如何控制启动日志文件压缩?
QLog 通过 MaxLogFileSize 全局变量来控制启动后台压缩的日志文件大小,只有日志文件内容大小达到这个上限值时,才会在后台启动压缩线程,对日志内容进行压缩打包,以避免日志文件占用过多的空间。这个值如果小于 0 ,则认为始终不压缩日志。默认值为-1,你只需要修改为自己认为合适的一个值即可,作者推荐是 2097152 (2MB),当日志每达到 2MB 时,就将历史日志打包压缩并创建新日志文件来记录后续日志内容。
4、为什么不支持日志的同步写入?
目前版本的 QLog 暂不会支持(虽然已经定义了有关的一些项目),主要是因为同步记录日志的需要的情况很少,而且强制同步日志记录会由于 IO 操作而拖慢程序的效率。
5、我能否同时支持将日志写入文件和远程日志服务器?
当然,你甚至可以同时添加多个服务器和文件,只需要创建对应的 TQLogWriter 子类实例,并将其加入到 Logs 的 Castor 列表中即可。