参考文档:http://neeke.github.io/SeasLog/
什么是SeasLogSeasLog是一个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()));
例子:
[php]
view plain
copy
<?php
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'));
?>
运行:
[php]
view plain
copy
[php]
view plain
copy
$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 "
";
[php]
view plain
copy
?>
输出:
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] = seaslogdemo@163.com
email[smtp_pwd] = seaslog#demo
email[mail_from] = seaslogdemo@163.com
email[mail_to] = gaochitao@weiboyi.com
email[mail_cc] = ciogao@gmail.com
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] = gaochitao@weiboyi.com
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