您的位置:澳门402永利com > 澳门402永利com网络 > PHP日志扩展,使用SeasLog打造PHP项目中的高性能日

PHP日志扩展,使用SeasLog打造PHP项目中的高性能日

发布时间:2019-09-24 15:54编辑:澳门402永利com网络浏览(126)

    程序员必上的开发者服务平台 —— DevStore

    使用SeasLog打造PHP项目中的高性能日志组件(1)

    什么是SeasLog

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

    为什么使用SeasLog

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

    我们知道,php内置了很多log函数,如error_log、syslog、file_put_content,这些函数功能强大且性能极好,但由于各种缺陷(error_log、file_put_content无错误级别、无固定格式像是信马由缰随处乱画;syslog不区分模块、而且与系统日志混合,读syslog记录会让人抓狂的。),灵活度降低了很多,很不能满足应用需求。基本上所有的开发者,都会自行设计封装log库,当然也会有很多开发者选择已有的开源日志库。

    也有很多开源log类库弥补了上述缺陷,如log4php、plog、Analog等(当然也有很多应用在项目中自己开发的log类)。其中以log4php最为著名,它的设计精良、格式完美、文档完善、功能强大。但是经过测试,log4php的性能非常差。

    图片 1

    这是log4php与SeasLog的性能对比图:

    设计思路

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

    ●分模块、分级别

    ●配置简单(最好是勿须配置)

    ●日志格式清晰易读

    ●应用简单、性能很棒

    我们知道,PSR-3标准是一个国际化的日志标准,它要求了“模块、级别、清晰、易用”等日志工作应具备的特点。因此,只要我们遵循了PSR-3标准,则我们可以完成“分模块、分级别”以及“日志格式清晰易读”的要求。

    “配置简单”这个需求也很好完成。如果严格按照既定规则,其实只需要设置默认目录就可以了。

    OK,现在我们只剩下“性能”这一个要求。

    既然是日志,免不了会写文件,或者通过pipe通过网络传送到某个存储中心(我们暂不考虑存储中心的设计)。可以想见,假设一个请求中需要写出1000处log,那么势必会有1000次IO,这对性能将是一个很大的拖延点。一般对于处理这种多次相同的请求场景,我们要解决的其实也很简单,使用cache或buffer,把多次请求作归并,从而降低对磁盘或网络的IO,这是一个基本的思想。

    SeasLog也是这么做的。设定一个buffer_size(默认100条log),使用PHP请求内存,每写一次log,塞入内存,同时buffer_size加;当buffer_size等于设置值时,则进行一次IO,同时清除buffer; 当然,如果请求结束了、或执行了die、exit或其他异常退出时,不管buffer_size有没有攒够设置值,立刻进行一次IO,同时清除buffer。

    到目前为止,SeasLog的正式版本为1.1.6,采用Apache 2.0开源协议,同时可以在php.net官方,和Github库上获得它的完整代码。

    Php.net

    Github

    目前提供了什么

    ●在PHP项目中便捷、规范地记录log

    ●可配置的默认log目录与模块

    ●指定log目录与获取当前配置

    ●初步的分析预警框架

    ●高效的日志缓冲、便捷的缓冲debug

    ●遵循 PSR-3 日志接口规范

    怎么安装

    获得源码后,可自行编译。

    $ /path/to/phpize

    $ ./configure --with-php-config=/path/to/php-config 

    $ make && make install

    当然,使用PECL管理工具会更方便: 

    $ pecl install seaslog

    seaslog.ini的配置

    ; configuration for php SeasLog module extension = seaslog.so seaslog.default_basepath = /log/seaslog-test    ;默认log根目录 seaslog.default_logger = default                ;默认logger目录 seaslog.disting_type = 1                            ;是否以type分文件 1是 0否(默认) seaslog.disting_by_hour = 1                      ;是否每小时划分一个文件 1是 0否(默认) seaslog.use_buffer = 1                              ;是否启用buffer 1是 0否(默认) seaslog.buffer_size = 100                         ;buffer中缓冲数量 默认0(不使用buffer_size) seaslog.level = 0                                       ;记录日志级别 默认0(所有日志) 
    

    seaslog.disting_type = 1 开启以type分文件,即log文件区分infowarnerro

    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时,所有日志均不记录。


    图片 2


    ) 什么是SeasLog SeasLog是一个C语言编写的PHP扩展,提供一组规范标准的功能函数,在PHP项目中方便...

    SeasLog
    Yet a log extension for PHP.A effective,fast,stable log extension for PHP
    @author Chitao.Gao [neeke@php.net]

    为什么使用SeasLog

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

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

    好消息是,有不少第三方的log类库弥补了上述缺陷,如log4php、plog、Analog等(当然也有很多应用在项目中自己开发的log类)。其中以log4php最为著名,设计精良、格式完美、文档完善、功能强大。推荐。(log4php的性能有待测试)

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

    • 分模块、分级别

    • 配置简单(最好是勿须配置)

    • 日志格式清晰易读

    • 应用简单、性能很棒

    SeasLog 正是应此需求而生。

    目前提供了什么

    • 在PHP项目中便捷、规范地记录log

    • 可配置的默认log目录与模块

    • 指定log目录与获取当前配置

    • 初步的分析预警框架

    • 高效的日志缓冲、便捷的缓冲debug

    • 遵循 PSR-3 日志接口规范

    目标是怎样的

    • 便捷、规范的log记录

    • 高效的海量log分析

    • 可配置、多途径的log预警

    安装

    编译安装 seaslog

    $ /path/to/phpize
    $ ./configure --with-php-config=/path/to/php-config
    $ make && make install
    

    seaslog.ini的配置

     ; configuration for php SeasLog module
    extension = seaslog.so
    seaslog.default_basepath = /log/seaslog-test    ;默认log根目录
    seaslog.default_logger = default                ;默认logger目录
    seaslog.disting_type = 1                        ;是否以type分文件 1是 0否(默认)
    seaslog.disting_by_hour = 1                     ;是否每小时划分一个文件 1是 0否(默认)
    seaslog.use_buffer = 1                          ;是否启用buffer 1是 0否(默认)
    

    seaslog.disting_type = 1 开启以type分文件,即log文件区分infowarnerro

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

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

    常量与函数

    常量列表

    * 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级别
    */
    

    函数列表

    SeasLog 提供了这样一组函数,可以方便地获取与设置根目录、模块目录、快速写入与统计log。 相信从下述伪代码的注释中,您可以快速获取函数信息,具体使用将紧接其后:

    <?php
    /**
     * @author ciogao@gmail.com
     * Date: 14-1-27 下午4:47
     */
    
    
    class SeasLog
    {
        public function __construct()
        {
            #SeasLog init
        }
    
    
        public function __destruct()
        {
            #SeasLog distroy
        }
    
    
        /**
         * 设置basePath
         * @param $basePath
         * @return bool
         */
        static public function setBasePath($basePath)
        {
            return TRUE;
        }
    
    
        /**
         * 获取basePath
         * @return string
         */
        static public function getBasePath()
        {
            return 'the base_path';
        }
    
    
        /**
         * 设置模块目录
         * @param $module
         * @return bool
         */
        static public function setLogger($module)
        {
            return TRUE;
        }
    
    
        /**
         * 获取最后一次设置的模块目录
         * @return string
         */
        static public function getLastLogger()
        {
            return 'the lastLogger';
        }
    
    
        /**
         * 统计所有类型(或单个类型)行数
         * @param $level
         * @param string $log_path
         * @return array | long
         */
        static public function analyzerCount($level = 'all',$log_path = '*')
        {
            return array();
        }
    
    
        /**
         * 以数组形式,快速取出某类型log的各行详情
         * @param $level
         * @param string $log_path
         * @return array
         */
        static public function analyzerDetail($level = SEASLOG_INFO,$log_path = '*')
        {
            return array();
        }
    
    
        /**
         * 获得当前日志buffer中的内容
         * @return array
         */
        static public function getBuffer()
        {
            return array();
        }
    
    
        /**
         * 记录debug日志
         * @param $message
         * @param array $content
         * @param string $module
         */
        static public function debug($message,array $content = array(),$module = '')
        {
            #$level = SEASLOG_DEBUG
        }
    
    
        /**
         * 记录info日志
         * @param $message
         * @param array $content
         * @param string $module
         */
        static public function info($message,array $content = array(),$module = '')
        {
            #$level = SEASLOG_INFO
        }
    
    
        /**
         * 记录notice日志
         * @param $message
         * @param array $content
         * @param string $module
         */
        static public function notice($message,array $content = array(),$module = '')
        {
            #$level = SEASLOG_NOTICE
        }
    
    
        /**
         * 记录warning日志
         * @param $message
         * @param array $content
         * @param string $module
         */
        static public function warning($message,array $content = array(),$module = '')
        {
            #$level = SEASLOG_WARNING
        }
    
    
        /**
         * 记录error日志
         * @param $message
         * @param array $content
         * @param string $module
         */
        static public function error($message,array $content = array(),$module = '')
        {
            #$level = SEASLOG_ERROR
        }
    
    
        /**
         * 记录critical日志
         * @param $message
         * @param array $content
         * @param string $module
         */
        static public function critical($message,array $content = array(),$module = '')
        {
            #$level = SEASLOG_CRITICAL
        }
    
    
        /**
         * 记录alert日志
         * @param $message
         * @param array $content
         * @param string $module
         */
        static public function alert($message,array $content = array(),$module = '')
        {
            #$level = SEASLOG_ALERT
        }
    
    
        /**
         * 记录emergency日志
         * @param $message
         * @param array $content
         * @param string $module
         */
        static public function emergency($message,array $content = array(),$module = '')
        {
            #$level = SEASLOG_EMERGENCY
        }
    
    
        /**
         * 通用日志方法
         * @param $level
         * @param $message
         * @param array $content
         * @param string $module
         */
        static public function log($level,$message,array $content = array(),$module = '')
        {
    
    
        }
    }
    

    SeasLog Logger的使用(详细文档)

    使用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
    

    Demo:

    <?php
    /**
     * @author ciogao@gmail.com
     * Date: 14-1-27 下午4:41
     */
    
    echo '<pre>';
    var_dump(SEASLOG_TYPE_INFO,SEASLOG_TYPE_INFO_STR);
    var_dump(SEASLOG_TYPE_WARN,SEASLOG_TYPE_WARN_STR);
    var_dump(SEASLOG_TYPE_ERRO,SEASLOG_TYPE_ERRO_STR);
    
    
    var_dump(seaslog_get_basepath());
    var_dump(seaslog_get_lastlogger());
    var_dump(seaslog_get_basepath());
    var_dump(seaslog('test info'));
    var_dump(seaslog('test warning', SEASLOG_TYPE_WARN));
    var_dump(seaslog('test error', SEASLOG_TYPE_ERRO));
    
    
    var_dump(seaslog_set_basepath('/log/base_test'));
    var_dump(seaslog_set_logger('testModule/app1'));
    var_dump(seaslog('test info 2'));
    var_dump(seaslog('test warning 2', SEASLOG_TYPE_WARN));
    var_dump(seaslog('test error 2', SEASLOG_TYPE_ERRO));
    var_dump(seaslog_get_basepath());
    var_dump(seaslog_get_lastlogger());
    var_dump(seaslog_get_basepath());
    
    var_dump(seaslog('test error 3', SEASLOG_TYPE_ERRO, 'test/bb'));
    
    var_dump(seaslog_analyzer_count()); // == seaslog_analyzer_count(ALL_TYPE);
    var_dump(seaslog_analyzer_count(SEASLOG_TYPE_ERRO)); // == seaslog_analyzer_count(SEASLOG_TYPE_ERRO,'*')
    var_dump(seaslog_analyzer_count(SEASLOG_TYPE_ERRO,'20140211.log'));
    
    
    var_dump(seaslog_analyzer_detail(SEASLOG_TYPE_ERRO)); // == seaslog_analyzer_detail(SEASLOG_TYPE_ERRO,'*')
    var_dump(seaslog_analyzer_detail(SEASLOG_TYPE_ERRO,'20140211.log'));
    
    
    echo "n";
    

    本文由澳门402永利com发布于澳门402永利com网络,转载请注明出处:PHP日志扩展,使用SeasLog打造PHP项目中的高性能日

    关键词:

上一篇:没有了

下一篇:C语言二进制转十进制代码