高性能的PHP日志系统 SeasLog

参考文档：http://neeke.github.io/SeasLog/

什么是SeasLog

SeasLog是一个C语言编写的PHP扩展，提供一组规范标准的功能函数，在PHP项目中方便、规范、高效地写日志，以及快速地读取和查询日志。

一．什么是日志系统

1. 记录系统运行时的信息

2. 系统日志、应用程序日志、安全日志

3. 日志功能不应该影响到用户的正常使用

 

二．为什么需要日志功能

1. 了解系统运行情况

2. 记录用户操作信息

3. 收集数据

 

三．为什么选择SeasLog

1. 高性能（C语言做的 先将日志写入内存达到一定量再写入文件比频繁写入文件好）。

2. 无需配置

3. 功能完善、

4. 使用简单

 

四．安装SeasLog

1.首先要下载SeasLog

http://pecl.php.net/package/SeasLog

$lastLogger_1 = SeasLog::getLastLogger();

SeasLog::setLogger('testModule/app1');
$lastLogger_2 = SeasLog::getLastLogger();

2.在windows系统配置SeasLog

找到适合自己php版本的seaslog.dll,将 php_seaslog.dll放在php安装目录的的ext下面

修改php.ini的配置，并增加应的参数配置

seaslog.disting_type = 1 开启以type分文件，即log文件区分info\warn\erro

seaslog.disting_by_hour = 1 开启每小时划分一个文件

seaslog.use_buffer = 1 开启buffer。默认关闭。当开启此项时，日志预存于内存，当请求结束时(或异常退出时)一次写入文件。

seaslog.buffer_size = 100 设置缓冲数量为100. 默认为0,即无缓冲数量限制.当buffer_size大于0时,缓冲量达到该值则写一次文件.

seaslog.level = 3 记录的日志级别.默认为0,即所有日志均记录。当level为1时,关注debug以上级别(包括debug)，以此类推。level大于8时，所有日志均不记录

保存php.ini并且重新服务器语言，然后运行phpinfo();可以看到

五.SeasLog Logger的使用

 1.获取与设置basePath 

$basePath_1 = SeasLog::getBasePath();

SeasLog::setBasePath('/log/base_test');

$basePath_2 = SeasLog::getBasePath();

直接使用 SeasLog::getBasePath()，将获取php.ini(seaslog.ini)中设置的seaslog.default_basepath 的值。

使用 SeasLog::setBasePath() 函数，将改变 SeasLog::getBasePath() 的取值。

2.设置logger与获取lastLogger

$lastLogger_1 = SeasLog::getLastLogger();

   SeasLog::setLogger('testModule/app1');
   $lastLogger_2 = SeasLog::getLastLogger();

与basePath相类似的，

直接使用 SeasLog::getLastLogger()，将获取php.ini(seaslog.ini)中设置的seaslog.default_logger 的值。

使用 SeasLog::setLogger() 函数，将改变 SeasLog::getLastLogger() 的取值。

3.快速写入log

上面已经设置过了basePath与logger，于是log记录的目录已经产生了，

log记录目录 = basePath / logger / {fileName}.log log文件名，以 年月日 分文件，如今天是2014年02月18日期，那么 {fileName} = 20140218;

还记得 php.ini 中设置的 seaslog.disting_type 吗？

默认的 seaslog.disting_type = 0，如果今天我使用了 SeasLog ，那么将产生最终的log文件：

• LogFile = basePath / logger / 20140218.log
• log格式统一为： {type} | {pid} | {timeStamp} |{dateTime} | {logInfo}
  

           SeasLog::setBasePath('E:www/seaslog/log/base_test');
          SeasLog::info('this is a info');
     ?>

 seaslog.disting_type = 0   产生文件 20160224.log

   seaslog.disting_type = 1 ， seaslog.disting_by_hour = 0     产生文件 info.20160224.log

      seaslog.disting_type = 1 ，  seaslog.disting_by_hour   =  1    产生文件  info.2016022411.log

 打开文件显示：

 log格式统一为：

 {type} | {pid} | {timeStamp}      |{dateTime}            | {logInfo}

  info       | 10144 | 1456283442.408 | 2016:02:24 11:10:42 | this is a info 

  4.常量列表

SeasLog 共将日志分成8个级别

• SEASLOG_DEBUG "debug"
• SEASLOG_INFO "info"
• SEASLOG_NOTICE "notice"
• SEASLOG_WARNING "warning"
• SEASLOG_ERROR "error"
• SEASLOG_CRITICAL "critical"
• SEASLOG_ALERT "alert"
• SEASLOG_EMERGENCY "emergency"

var_dump(SEASLOG_DEBUG,SEASLOG_INFO,SEASLOG_NOTICE);
/*
string('debug') debug级别
string('info')  info级别
string('notice') notice级别
*/

5.SeasLog Analyzer的使用

       快速统计某类型log的count值

SeasLog在扩展中使用管道调用shell命令 grep -wc快速地取得count值，并返回值(array || int)给PHP。

 $countResult_1 = SeasLog::analyzerCount();
     $countResult_2 = SeasLog::analyzerCount(SEASLOG_WARNING);
     $countResult_3 = SeasLog::analyzerCount(SEASLOG_ERROR,date('Ymd',time()));

例子：

"font-size:18px;">
SeasLog::setBasePath('E:www/seaslog/log/base_test');

SeasLog::log(SEASLOG_ERROR,'this is a error test by ::log');
SeasLog::debug('this is a {userName} debug',array('{userName}' => 'neeke'));
SeasLog::info('this is a info log');
SeasLog::notice('this is a notice log');
SeasLog::warning('your {website} was down,please {action} it ASAP!',array('{website}' => 'github.com','{action}' => 'rboot'));
SeasLog::error('a error log');
SeasLog::critical('some thing was critical');
SeasLog::alert('yes this is a {messageName}',array('{messageName}' => 'alertMSG'));
SeasLog::emergency('Just now, the house next door was completely burnt out! {note}',array('{note}' => 'it`s a joke'));
?>

运行：

"font-size:18px;">

"font-size:18px;">$data = SeasLog::analyzerCount();
print_r($data);
echo "";
$data1 = SeasLog::analyzerCount(SEASLOG_WARNING);
print_r($data1);
echo "";
$data2 = SeasLog::analyzerCount(SEASLOG_ERROR,date('Ymd',time()));
print_r($data2);
echo "";

"font-size:18px;">?>

输出：

Array ( [debug] => 2 [info] => 2 [notice] => 2 [warning] => 2 [error] => 4 [critical] => 2 [alert] => 2 [emergency] => 2 ) 
2
4

获取某类型log列表

SeasLog在扩展中使用管道调用shell命令 grep -w快速地取得列表，并返回array给PHP

运行：

$detailErrorArray_inAll   = SeasLog::analyzerDetail(SEASLOG_ERROR);
$detailErrorArray_today   = SeasLog::analyzerDetail(SEASLOG_ERROR,date('Ymd',time()));


echo "

";
 print_r($detailErrorArray_inAll);
 echo "

";


echo "

";
 print_r($detailErrorArray_today);
 echo "

";

输出：

SeasLog::analyzerDetail(SEASLOG_ERROR,date('Ymd',time()));
只取得当前模块下，当前一天内,level为SEASLOG_ERROR 的信息列表:

同理，取当月
$detailErrorArray_mouth = SeasLog::analyzerDetail(SEASLOG_ERROR,date('Ym',time()));

使用SeasLog进行健康预警

预警的配置

[base]
wait_analyz_log_path = /log/base_test

[fork]
;是否开启多线程 1开启 0关闭
fork_open = 1

;线程个数
fork_count = 3

[warning]
email[smtp_host] = smtp.163.com
email[smtp_port] = 25
email[subject_pre] = 预警邮件 -
email[smtp_user] = [email protected]
email[smtp_pwd] = seaslog#demo
email[mail_from] = [email protected]
email[mail_to] = [email protected]
email[mail_cc] = [email protected]
email[mail_bcc] =

[analyz]
; enum
; SEASLOG_DEBUG      "debug"
; SEASLOG_INFO       "info"
; SEASLOG_NOTICE     "notice"
; SEASLOG_WARNING    "warning"
; SEASLOG_ERROR      "error"
; SEASLOG_CRITICAL   "critical"
; SEASLOG_ALERT      "alert"
; SEASLOG_EMERGENCY  "emergency"

test1[module] = test/bb
test1[level] = SEASLOG_ERROR
test1[bar] = 1
test1[mail_to] = [email protected]

test2[module] = 222
test2[level] = SEASLOG_WARNING

test3[module] = 333
test3[level] = SEASLOG_CRITICAL

test4[module] = 444
test4[level] = SEASLOG_EMERGENCY

test5[module] = 555
test5[level] = SEASLOG_DEBUG

crontab配置

;每天凌晨3点执行
0 3 * * * /path/to/php /path/to/SeasLog/Analyzer/SeasLogAnalyzer.php