PHP函数参考14-日志扩展seaslog面面观

  • seaslog
  • 安装扩展
  • 配置php.ini
  • 确认扩展安装成功
  • SeasLog 日志8个级别
  • seaslog类
  • seaslog简单使用
    • 获取与设置根目录
    • 获取与设置 Logger
    • 快速写入日志
    • 快速获取某级别下日志的数量
    • 获取某级别下日志的详情


原文:
PHP函数参考14-日志扩展seaslog面面观 - 9ong
PHP函数参考15-URLs相关处理函数 - 9ong

seaslog

Log 日志,通常是系统或软件、应用的运行记录。通过 Log 的分析,可以方便用户了解系统或软件、应用的运行情况;如果你的应用 Log 足够丰富,也可以分析以往用户的操作行为、类型喜好、地域分布或其他更多信息;如果一个应用的 Log 同时也分了多个级别,那么可以很轻易地分析得到该应用的健康状况,及时发现问题并快速定位、解决问题,补救损失。

PHP 内置 error_log、syslog 函数功能强大且性能极好,但由于各种缺陷(error_log 无错误级别、无固定格式,syslog 不分模块、与系统日志混合),灵活度降低了很多,不能满足应用需求。

好消息是,有不少第三方的log类库弥补了上述缺陷,如 log4php、plog、monolog 等(当然也有很多应用在项目中自己开发的 Log 类)。

那么有没有一种 Log 类库满足以下需求呢:

  • 分模块、分级别
  • 配置简单(最好是勿须配置)
  • 日志格式清晰易读
  • 应用简单、性能很棒
    SeasLog 正是应此需求而生。

目前提供了什么:

  • 在 PHP 项目中便捷、规范地记录 Log
  • 可配置的默认 Log 目录与模块
  • 指定 Log 目录与获取当前配置
  • 初步的分析预警框架
  • 高效的日志缓冲、便捷的缓冲 debug
  • 遵循 PSR-3 日志接口规范
  • 自动记录错误信息
  • 自动记录异常信息
  • 连接 TCP 端口,以 RFC5424 格式发送日志
  • 连接 UDP 端口,以 RFC5424 格式发送日志
  • 支持 RequestId 区分请求
  • 支持日志模板自定义

安装扩展

下载

下载页面:https://pecl.php.net/package/seaslog

chenqingji@ubuntu:~/pecl$ wget https://pecl.php.net/get/SeasLog-2.2.0.tgz

解压

tar zxvf SeasLog-2.2.0.tgz
cd SeasLog-2.2.0/

执行PHP安装目录下的phpize

chenqingji@ubuntu:~/pecl/SeasLog-2.2.0$ /usr/bin/phpize
Configuring for:
PHP Api Version:         20160303
Zend Module Api No:      20160303
Zend Extension Api No:   320160303

找到当前系统的php-config文件,同理前面phpize也可以通过whereis搜索到具体路径:

chenqingji@ubuntu:~/pecl/SeasLog-2.2.0$ whereis php-config
php-config: /usr/bin/php-config /usr/bin/php-config7.1 /usr/share/man/man1/php-config.1.gz

配置:

注意:在cd SeasLog-2.2.0/目录中

./configure --with-php-config=/usr/bin/php-config

编译并安装

sudo make 
sudo make install

注意:可能有些系统需要足够权限才能编译安装成功,根据具体系统实际情况。

安装成功

Installing shared extensions:     /usr/lib/php/20160303/

配置php.ini

;amqp rabbitMQ扩展
extension=/usr/lib/php/20160303/amqp.so
;seaslog 扩展
extension=seaslog.so

在ini尾部补充:

[seaslog]
seaslog.default_basepath = '/var/www/log' ;默认log根目录
seaslog.default_logger = default ;默认日志目录 位于default_basepath目录下的小目录
seaslog.disting_type = 1 ;是否以type分文件 1是 0否(默认) 若是 则每种级别都会单独生成日志文件
seaslog.disting_by_hour = 0 ;是否每小时划分一个文件 1是 0否(默认) 若是 则每个小时都会生成新文件
seaslog.use_buffer = 1 ;是否启用buffer 1是 0否(默认) 默认关闭,当开启此项时,日志预存于内存,当请求结束时(或异常退出时)一次写入文件。
seaslog.buffer_size = 100 ;buffer中缓冲数量 默认0(不使用)
seaslog.level = 0 ;记录日志级别 默认0(所有日志)

seaslog.default_logger的设置,在项目的入口文件中再指定Seaslog::setLogger('app1') 这样也就可以每个项目一个日志目录

注意:如果是cli与fpm的php.ini分开配置,则需要两个php
.ini配置文件都要配置。这里我们只配置了fpm模式下ini。

确认扩展安装成功

重启apache或重启php-fpm

比如:

sudo service php7.1-fpm restart

SeasLog 日志8个级别

debug -> info -> notice -> warning -> error -> critical -> alert -> emergency

seaslog类

  • SeasLog::alert — 记录 alert 日志
  • SeasLog::analyzerCount — Get log count by level, log_path and key_word
  • SeasLog::analyzerDetail — Get log detail by level, log_path, key_word, start, limit, order
  • SeasLog::closeLoggerStream — Manually release stream flow from logger
  • SeasLog::__construct — Description
  • SeasLog::critical — 记录 critical 日志
  • SeasLog::debug — 记录 debug 日志
  • SeasLog::__destruct — Description
  • SeasLog::emergency — 记录 emergency 日志
  • SeasLog::error — 记录 error 日志
  • SeasLog::flushBuffer — 将日志缓存刷新到介质中,文件介质,或者发送到远端的 TCP/UDP 服务地址。
  • SeasLog::getBasePath — 获得 SeasLog 根目录
  • SeasLog::getBuffer — 获取内存中的日志缓存数组
  • SeasLog::getBufferEnabled — Determin if buffer enabled
  • SeasLog::getDatetimeFormat — 获取 SeasLog 日期格式
  • SeasLog::getLastLogger — 获得 SeasLog 最近的一次 Logger 名称
  • SeasLog::getRequestID — 获得当前 SeasLog 中用于区分请求的 request_id
  • SeasLog::getRequestVariable — Get SeasLog request variable
  • SeasLog::info — Record info log information
  • SeasLog::log — 公共的日志记录函数
  • SeasLog::notice — 记录 notice 日志
  • SeasLog::setBasePath — 设置 SeasLog 根目录
  • SeasLog::setDatetimeFormat — 设置 SeasLog 日期格式
  • SeasLog::setLogger — 设置 SeasLog 的 Logger 名
  • SeasLog::setRequestID — 设置可以由 SeasLog 用于区分请求的 request_id
  • SeasLog::setRequestVariable — Manually set SeasLog request variable
  • SeasLog::warning — Record warning log information

seaslog简单使用

获取与设置根目录


$basePath1 = SeasLog::getBasePath();

SeasLog::setBasePath('/log/base_test');
$basePath2 = SeasLog::getBasePath();

var_dump($basePath1,$basePath2);

以上输出类似于:

string(12) "/var/log/www"
string(14) "/log/base_test"
  

获取与设置 Logger


$lastLogger1 = SeasLog::getLastLogger();

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

var_dump($lastLogger1,$lastLogger2);

以上输出类似于:

string(7) "default"
string(15) "testModule/app1"

快速写入日志

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'));

日志的默认模板是 seaslog.default_template = "%T | %L | %P | %Q | %t | %M". 这意味着,在默认情况下,日志的记录格式是: {dateTime} | {level} | {pid} | {uniqid} | {timeStamp} | {logInfo}.

如果设置:seaslog.appender = 1

以上输出类似于:

2020-07-27 08:53:52 | ERROR | 23625 | 599159975a9ff | 1406422432.786 | this is a error test by log
2020-07-27 08:53:52 | DEBUG | 23625 | 599159975a9ff | 1406422432.786 | this is a neeke debug
2020-07-27 08:53:52 | INFO | 23625 | 599159975a9ff | 1406422432.787 | this is a info log
2020-07-27 08:53:52 | NOTICE | 23625 | 599159975a9ff | 1406422432.787 | this is a notice log
2020-07-27 08:53:52 | WARNING | 23625 | 599159975a9ff | 1406422432.787 | your github.com was down,please rboot it ASAP!
2020-07-27 08:53:52 | ERROR | 23625 | 599159975a9ff | 1406422432.787 | a error log
2020-07-27 08:53:52 | CRITICAL | 23625 | 599159975a9ff | 1406422432.787 | some thing was critical
2020-07-27 08:53:52 | EMERGENCY | 23625 | 599159975a9ff | 1406422432.787 | Just now, the house next door was completely burnt out! it is a joke

快速获取某级别下日志的数量

SeasLog 通过系统命令管道调用 grep -wc 获取数量,并返回给 PHP (返回数组或单个数值).

$countResult1 = SeasLog::analyzerCount();
$countResult2 = SeasLog::analyzerCount(SEASLOG_WARNING);
$countResult3 = SeasLog::analyzerCount(SEASLOG_ERROR,date('Ymd',time()));

var_dump($countResult1,$countResult2,$countResult3);

以上输出类似于:

array(8) {
  ["DEBUG"]=>
  int(3)
  ["INFO"]=>
  int(3)
  ["NOTICE"]=>
  int(3)
  ["WARNING"]=>
  int(3)
  ["ERROR"]=>
  int(6)
  ["CRITICAL"]=>
  int(3)
  ["ALERT"]=>
  int(3)
  ["EMERGENCY"]=>
  int(3)
}
int(7)
int(1)

获取某级别下日志的详情

SeasLog 通过系统命令管道调用 grep -w 获取日志详情,并返回数组给 PHP.

$detailErrorArray = SeasLog::analyzerDetail(SEASLOG_ERROR);
var_dump($detailErrorArray);

var_dump(SeasLog::analyzerDetail(SEASLOG_ERROR,date('Ymd',time())));

以上输出类似于:

array(6) {
  [0] =>
  string(83) "2020-02-24 00:14:02 | ERROR | 8568 | 599157af4e937 | 1393172042.717 | test error 3 "
  [1] =>
  string(83) "2020-02-24 00:14:04 | ERROR | 8594 | 5991576584446 | 1393172044.104 | test error 3 "
  [2] =>
  string(83) "2020-02-24 00:14:04 | ERROR | 8620 | 1502697015147 | 1393172044.862 | test error 3 "
  [3] =>
  string(83) "2020-02-24 00:14:05 | ERROR | 8646 | 599159975a9ff | 1393172045.989 | test error 3 "
  [4] =>
  string(83) "2020-02-24 00:14:07 | ERROR | 8672 | 599159986ec28 | 1393172047.882 | test error 3 "
  [5] =>
  string(83) "2020-02-24 00:14:08 | ERROR | 8698 | 5991599981cec | 1393172048.736 | test error 3 "
}

array(2) {
  [0] =>
  string(83) "2020-02-24 00:14:02 | ERROR | 8568 | 599157af4e937 | 1393172042.717 | test error 3 "
  [1] =>
  string(83) "2020-02-24 00:14:04 | ERROR | 8594 | 5991576584446 | 1393172044.104 | test error 3 "
}

原文:
PHP函数参考14-日志扩展seaslog面面观 - 9ong
PHP函数参考15-URLs相关处理函数 - 9ong

你可能感兴趣的:(PHP函数参考14-日志扩展seaslog面面观)