首页    技术博客    PHP教程    数据库技术    前端开发   HTML5    Nginx    php论坛
新用户注册 | 会员登录
加入会员，解锁专属内容
取消
热门标签 | HotTags
当前位置:  开发笔记 > 编程语言 > 正文

PHP日志扩展SeasLog学习

作者：血狼2732_150 | 来源：互联网 | 2023-06-22 19:03
文章来源于：开源中国社区http:www.oschina.netpseaslog附1：PECL项目主页http:pecl.php.netpackageS

文章来源于&＃xff1a;开源中国社区http://www.oschina.net/p/seaslog

附1&＃xff1a;PECL项目主页http://pecl.php.net/package/SeasLog

附2&＃xff1a;GitHub项目主页https://github.com/Neeke/SeasLog

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

为什么使用SeasLog

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

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

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

不过log4php在性能方面表现非常差,下图是SeasLog与log4php的ab并发性能测试( 测试环境:Ubuntu12.04单机,CPU I3,内存 16G,硬盘 SATA 7200): 

那么有没有一种log类库满足以下需求呢&＃xff1a;

  • 分模块、分级别

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

  • 日志格式清晰易读

  • 应用简单、性能很棒

   SeasLog 正是应此需求而生。

目前提供了什么

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

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

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

  • 初步的分析预警框架

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

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

  • 自动记录错误信息

  • 自动记录异常信息


目标是怎样的


  • 便捷、规范的log记录

  • 高效的海量log分析

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


安装


编译安装 seaslog


[php] view plaincopy
  1. $ /path/to/phpize  
  2. $ ./configure --with-php-config&＃61;/path/to/php-config  
  3. $ make && make install  


seaslog.ini 的配置


[php] view plaincopy
  1. ; configuration for php SeasLog module  
  2. extension &＃61; seaslog.so  
  3. seaslog.default_basepath &＃61; /log/seaslog-test            ;默认log根目录  
  4. seaslog.default_logger &＃61; default                        ;默认logger目录  
  5. seaslog.disting_type &＃61; 1                                ;是否以type分文件 1是 0否(默认)  
  6. seaslog.disting_by_hour &＃61; 1                             ;是否每小时划分一个文件 1是 0否(默认)  
  7. seaslog.use_buffer &＃61; 1                                  ;是否启用buffer 1是 0否(默认)  
  8. seaslog.buffer_size &＃61; 100                               ;buffer中缓冲数量 默认0(不使用buffer_size)  
  9. seaslog.level &＃61; 0                                       ;记录日志级别 默认0(所有日志)  
  10. seaslog.trace_error &＃61; 1                                 ;自动记录错误 默认1(开启)  
  11. seaslog.trace_exception &＃61; 0                             ;自动记录异常信息 默认0(关闭)  
  12. seaslog.default_datetime_format &＃61; "%Y:%m:%d %H:%M:%S"   ;日期格式配置 默认"%Y:%m:%d %H:%M:%S"  




seaslog.disting_type &＃61; 1 开启以type分文件&＃xff0c;即log文件区分info\warn\erro




seaslog.disting_by_hour &＃61; 1 开启每小时划分一个文件



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


常量与函数

常量列表

[php] view plaincopy
  1. * SEASLOG_DEBUG                       "debug"  
  2. * SEASLOG_INFO                        "info"  
  3. * SEASLOG_NOTICE                      "notice"  
  4. * SEASLOG_WARNING                     "warning"  
  5. * SEASLOG_ERROR                       "error"  
  6. * SEASLOG_CRITICAL                    "critical"  
  7. * SEASLOG_ALERT                       "alert"  
  8. * SEASLOG_EMERGENCY                   "emergency"  
  9.    
  10.    
  11. var_dump(SEASLOG_DEBUG,SEASLOG_INFO,SEASLOG_NOTICE);  
  12. /* 
  13. string(&＃39;debug&＃39;) debug级别 
  14. string(&＃39;info&＃39;)  info级别 
  15. string(&＃39;notice&＃39;) notice级别 
  16. */  




 函数列表




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

[php] view plaincopy
  2. /** 
  3.  * &＃64;author neeke&＃64;php.net 
  4.  * Date: 14-1-27 下午4:47 
  5.  */  
  6.    
  7.    
  8. class SeasLog  
  9. {  
  10.     public function __construct()  
  11.     {  
  12.         #SeasLog init  
  13.     }  
  14.    
  15.    
  16.     public function __destruct()  
  17.     {  
  18.         #SeasLog distroy  
  19.     }  
  20.    
  21.    
  22.     /** 
  23.      * 设置basePath 
  24.      * &＃64;param $basePath 
  25.      * &＃64;return bool 
  26.      */  
  27.     static public function setBasePath($basePath)  
  28.     {  
  29.         return TRUE;  
  30.     }  
  31.    
  32.    
  33.     /** 
  34.      * 获取basePath 
  35.      * &＃64;return string 
  36.      */  
  37.     static public function getBasePath()  
  38.     {  
  39.         return &＃39;the base_path&＃39;;  
  40.     }  
  41.    
  42.    
  43.     /** 
  44.      * 设置模块目录 
  45.      * &＃64;param $module 
  46.      * &＃64;return bool 
  47.      */  
  48.     static public function setLogger($module)  
  49.     {  
  50.         return TRUE;  
  51.     }  
  52.    
  53.    
  54.     /** 
  55.      * 获取最后一次设置的模块目录 
  56.      * &＃64;return string 
  57.      */  
  58.     static public function getLastLogger()  
  59.     {  
  60.         return &＃39;the lastLogger&＃39;;  
  61.     }  
  62.    
  63.    
  64.     /** 
  65.      * 统计所有类型&＃xff08;或单个类型&＃xff09;行数 
  66.      * &＃64;param $level 
  67.      * &＃64;param string $log_path 
  68.      * &＃64;return array | long 
  69.      */  
  70.     static public function analyzerCount($level &＃61; &＃39;all&＃39;,$log_path &＃61; &＃39;*&＃39;)  
  71.     {  
  72.         return array();  
  73.     }  
  74.    
  75.    
  76.     /** 
  77.      * 以数组形式&＃xff0c;快速取出某类型log的各行详情 
  78.      * &＃64;param $level 
  79.      * &＃64;param string $log_path 
  80.      * &＃64;return array 
  81.      */  
  82.     static public function analyzerDetail($level &＃61; SEASLOG_INFO,$log_path &＃61; &＃39;*&＃39;)  
  83.     {  
  84.         return array();  
  85.     }  
  86.    
  87.    
  88.     /** 
  89.      * 获得当前日志buffer中的内容 
  90.      * &＃64;return array 
  91.      */  
  92.     static public function getBuffer()  
  93.     {  
  94.         return array();  
  95.     }  
  96.    
  97.     /** 
  98.      * 将buffer中的日志立刻刷到硬盘 
  99.      * 
  100.      * &＃64;return bool 
  101.      */  
  102.     static public function flushBuffer()  
  103.     {  
  104.         return TRUE;  
  105.     }  
  106.    
  107.    
  108.     /** 
  109.      * 记录debug日志 
  110.      * &＃64;param $message 
  111.      * &＃64;param array $content 
  112.      * &＃64;param string $module 
  113.      */  
  114.     static public function debug($message,array $content &＃61; array(),$module &＃61; &＃39;&＃39;)  
  115.     {  
  116.         #$level &＃61; SEASLOG_DEBUG  
  117.     }  
  118.    
  119.    
  120.     /** 
  121.      * 记录info日志 
  122.      * &＃64;param $message 
  123.      * &＃64;param array $content 
  124.      * &＃64;param string $module 
  125.      */  
  126.     static public function info($message,array $content &＃61; array(),$module &＃61; &＃39;&＃39;)  
  127.     {  
  128.         #$level &＃61; SEASLOG_INFO  
  129.     }  
  130.    
  131.    
  132.     /** 
  133.      * 记录notice日志 
  134.      * &＃64;param $message 
  135.      * &＃64;param array $content 
  136.      * &＃64;param string $module 
  137.      */  
  138.     static public function notice($message,array $content &＃61; array(),$module &＃61; &＃39;&＃39;)  
  139.     {  
  140.         #$level &＃61; SEASLOG_NOTICE  
  141.     }  
  142.    
  143.    
  144.     /** 
  145.      * 记录warning日志 
  146.      * &＃64;param $message 
  147.      * &＃64;param array $content 
  148.      * &＃64;param string $module 
  149.      */  
  150.     static public function warning($message,array $content &＃61; array(),$module &＃61; &＃39;&＃39;)  
  151.     {  
  152.         #$level &＃61; SEASLOG_WARNING  
  153.     }  
  154.    
  155.    
  156.     /** 
  157.      * 记录error日志 
  158.      * &＃64;param $message 
  159.      * &＃64;param array $content 
  160.      * &＃64;param string $module 
  161.      */  
  162.     static public function error($message,array $content &＃61; array(),$module &＃61; &＃39;&＃39;)  
  163.     {  
  164.         #$level &＃61; SEASLOG_ERROR  
  165.     }  
  166.    
  167.    
  168.     /** 
  169.      * 记录critical日志 
  170.      * &＃64;param $message 
  171.      * &＃64;param array $content 
  172.      * &＃64;param string $module 
  173.      */  
  174.     static public function critical($message,array $content &＃61; array(),$module &＃61; &＃39;&＃39;)  
  175.     {  
  176.         #$level &＃61; SEASLOG_CRITICAL  
  177.     }  
  178.    
  179.    
  180.     /** 
  181.      * 记录alert日志 
  182.      * &＃64;param $message 
  183.      * &＃64;param array $content 
  184.      * &＃64;param string $module 
  185.      */  
  186.     static public function alert($message,array $content &＃61; array(),$module &＃61; &＃39;&＃39;)  
  187.     {  
  188.         #$level &＃61; SEASLOG_ALERT  
  189.     }  
  190.    
  191.    
  192.     /** 
  193.      * 记录emergency日志 
  194.      * &＃64;param $message 
  195.      * &＃64;param array $content 
  196.      * &＃64;param string $module 
  197.      */  
  198.     static public function emergency($message,array $content &＃61; array(),$module &＃61; &＃39;&＃39;)  
  199.     {  
  200.         #$level &＃61; SEASLOG_EMERGENCY  
  201.     }  
  202.    
  203.    
  204.     /** 
  205.      * 通用日志方法 
  206.      * &＃64;param $level 
  207.      * &＃64;param $message 
  208.      * &＃64;param array $content 
  209.      * &＃64;param string $module 
  210.      */  
  211.     static public function log($level,$message,array $content &＃61; array(),$module &＃61; &＃39;&＃39;)  
  212.     {  
  213.    
  214.    
  215.     }  
  216. }  



SeasLog Logger的使用&＃xff08;详细文档&＃xff09;

使用SeasLog进行健康预警

预警的配置

[php] view plaincopy
  1. [base]  
  2. wait_analyz_log_path &＃61; /log/base_test  
  3.    
  4.    
  5. [fork]  
  6. ;是否开启多线程 1开启 0关闭  
  7. fork_open &＃61; 1  
  8.    
  9.    
  10. ;线程个数  
  11. fork_count &＃61; 3  
  12.    
  13.    
  14. [warning]  
  15. email[smtp_host] &＃61; smtp.163.com  
  16. email[smtp_port] &＃61; 25  
  17. email[subject_pre] &＃61; 预警邮件 -  
  18. email[smtp_user] &＃61; seaslogdemo&＃64;163.com  
  19. email[smtp_pwd] &＃61; seaslog#demo  
  20. email[mail_from] &＃61; seaslogdemo&＃64;163.com  
  21. email[mail_to] &＃61; gaochitao&＃64;weiboyi.com  
  22. email[mail_cc] &＃61; ciogao&＃64;gmail.com  
  23. email[mail_bcc] &＃61;  
  24.    
  25.    
  26. [analyz]  
  27. ; enum  
  28. ; SEASLOG_DEBUG      "debug"  
  29. ; SEASLOG_INFO       "info"  
  30. ; SEASLOG_NOTICE     "notice"  
  31. ; SEASLOG_WARNING    "warning"  
  32. ; SEASLOG_ERROR      "error"  
  33. ; SEASLOG_CRITICAL   "critical"  
  34. ; SEASLOG_ALERT      "alert"  
  35. ; SEASLOG_EMERGENCY  "emergency"  
  36.    
  37.    
  38. test1[module] &＃61; test/bb  
  39. test1[level] &＃61; SEASLOG_ERROR  
  40. test1[bar] &＃61; 1  
  41. test1[mail_to] &＃61; gaochitao&＃64;weiboyi.com  
  42.    
  43.    
  44. test2[module] &＃61; 222  
  45. test2[level] &＃61; SEASLOG_WARNING  
  46.    
  47.    
  48. test3[module] &＃61; 333  
  49. test3[level] &＃61; SEASLOG_CRITICAL  
  50.    
  51.    
  52. test4[module] &＃61; 444  
  53. test4[level] &＃61; SEASLOG_EMERGENCY  
  54.    
  55.    
  56. test5[module] &＃61; 555  
  57. test5[level] &＃61; SEASLOG_DEBUG  




crontab配置

[php] view plaincopy
  1. ;每天凌晨3点执行  
  2. 0 3 * * * /path/to/php /path/to/SeasLog/Analyzer/SeasLogAnalyzer.php  




Demo: 

[php] view plaincopy
  2. /** 
  3.  * &＃64;author ciogao&＃64;gmail.com 
  4.  * Date: 14-1-27 下午4:41 
  5.  */    
  6.    
  7. SeasLog::log(SEASLOG_ERROR,&＃39;this is a error test by ::log&＃39;);  
  8.    
  9. SeasLog::debug(&＃39;this is a {userName} debug&＃39;,array(&＃39;{userName}&＃39; &＃61;> &＃39;neeke&＃39;));  
  10.    
  11. SeasLog::info(&＃39;this is a info log&＃39;);  
  12.    
  13. SeasLog::notice(&＃39;this is a notice log&＃39;);  
  14.    
  15. SeasLog::warning(&＃39;your {website} was down,please {action} it ASAP!&＃39;,array(&＃39;{website}&＃39; &＃61;> &＃39;github.com&＃39;,&＃39;{action}&＃39; &＃61;> &＃39;rboot&＃39;));  
  16.    
  17. SeasLog::error(&＃39;a error log&＃39;);  
  18.    
  19. SeasLog::critical(&＃39;some thing was critical&＃39;);  
  20.    
  21. SeasLog::alert(&＃39;yes this is a {messageName}&＃39;,array(&＃39;{messageName}&＃39; &＃61;> &＃39;alertMSG&＃39;));  
  22.    
  23. SeasLog::emergency(&＃39;Just now, the house next door was completely burnt out! {note}&＃39;,array(&＃39;{note}&＃39; &＃61;> &＃39;it&＃96;s a joke&＃39;));  
  24. echo "\n";  




推荐阅读
  • 并发

    Android中高级面试必知必会，积累总结

    Android中高级面试必知必会，积累总结
    本文介绍了Android中高级面试的必知必会内容，并总结了相关经验。文章指出，如今的Android市场对开发人员的要求更高，需要更专业的人才。同时，文章还给出了针对Android岗位的职责和要求，并提供了简历突出的建议。 ... [详细]
  • get

    imx6ull开发板驱动MT7601U无线网卡的方法和步骤详解

    imx6ull开发板驱动MT7601U无线网卡的方法和步骤详解
    本文详细介绍了在imx6ull开发板上驱动MT7601U无线网卡的方法和步骤。首先介绍了开发环境和硬件平台，然后说明了MT7601U驱动已经集成在linux内核的linux-4.x.x/drivers/net/wireless/mediatek/mt7601u文件中。接着介绍了移植mt7601u驱动的过程，包括编译内核和配置设备驱动。最后，列举了关键词和相关信息供读者参考。 ... [详细]
  • python

    微软头条实习生分享深度学习自学指南

    微软头条实习生分享深度学习自学指南
    本文介绍了一位微软头条实习生自学深度学习的经验分享，包括学习资源推荐、重要基础知识的学习要点等。作者强调了学好Python和数学基础的重要性，并提供了一些建议。 ... [详细]
  • python

    学习笔记（34):第三阶段4.2.6：SpringCloud Config配置中心的应用与原理第三阶段4.2.6SpringCloud Config配置中心的应用与原理

    学习笔记（34):第三阶段4.2.6：SpringCloud Config配置中心的应用与原理第三阶段4.2.6SpringCloud Config配置中心的应用与原理
    立即学习:https:edu.csdn.netcourseplay29983432482?utm_sourceblogtoedu配置中心得核心逻辑springcloudconfi ... [详细]
  • python

    Centos7.6安装Gitlab教程及注意事项

    Centos7.6安装Gitlab教程及注意事项
    本文介绍了在Centos7.6系统下安装Gitlab的详细教程，并提供了一些注意事项。教程包括查看系统版本、安装必要的软件包、配置防火墙等步骤。同时，还强调了使用阿里云服务器时的特殊配置需求，以及建议至少4GB的可用RAM来运行GitLab。 ... [详细]
  • format

    baresip android编译、运行教程1语音通话

    baresip android编译、运行教程1语音通话
    本文介绍了如何在安卓平台上编译和运行baresip android，包括下载相关的sdk和ndk，修改ndk路径和输出目录，以及创建一个c++的安卓工程并将目录考到cpp下。详细步骤可参考给出的链接和文档。 ... [详细]
  • 数组

    如何用UE4制作2D游戏文档——计算篇

    如何用UE4制作2D游戏文档——计算篇
    篇首语：本文由编程笔记#小编为大家整理，主要介绍了如何用UE4制作2D游戏文档——计算篇相关的知识，希望对你有一定的参考价值。 ... [详细]
  • go

    如何通过全新应用内评价获取更多优质用户反馈？

    Google Play推出全新的应用内评价API，帮助开发者获取更多优质用户反馈。用户每天在Google Play上发表数百万条评论，这有助于开发者了解用户喜好和改进需求。开发者可以选择在适当的时间请求用户撰写评论，以获得全面而有用的反馈。全新应用内评价功能让用户无需返回应用详情页面即可发表评论，提升用户体验。 ... [详细]
  • format

    解决VS写C#项目导入MySQL数据源报错“You have a usable connection already”问题的正确方法

    解决VS写C#项目导入MySQL数据源报错“You have a usable connection already”问题的正确方法
    本文介绍了在VS写C#项目导入MySQL数据源时出现报错“You have a usable connection already”的问题，并给出了正确的解决方法。详细描述了问题的出现情况和报错信息，并提供了解决该问题的步骤和注意事项。 ... [详细]
  • js

    Java验证码——kaptcha的使用配置及样式

    Java验证码——kaptcha的使用配置及样式
    本文介绍了如何使用kaptcha库来实现Java验证码的配置和样式设置，包括pom.xml的依赖配置和web.xml中servlet的配置。 ... [详细]
  • utf-8

    Android 7自学笔记总结、移动架构视频、安卓面试真题、项目实战源码讲义

    本文介绍了Android 7的学习笔记总结，包括最新的移动架构视频、大厂安卓面试真题和项目实战源码讲义。同时还分享了开源的完整内容，并提醒读者在使用FileProvider适配时要注意不同模块的AndroidManfiest.xml中配置的xml文件名必须不同，否则会出现问题。 ... [详细]
  • go

    Golang条件编译的必要性及实现方法

    本文介绍了在多平台下进行条件编译的必要性，以及具体的实现方法。通过示例代码展示了如何使用条件编译来实现不同平台的功能。最后总结了只要接口相同，不同平台下的编译运行结果也会相同。 ... [详细]
  • go

    Go Cobra命令行工具入门教程

    Go Cobra命令行工具入门教程
    本文介绍了Go语言实现的命令行工具Cobra的基本概念、安装方法和入门实践。Cobra被广泛应用于各种项目中，如Kubernetes、Hugo和Github CLI等。通过使用Cobra，我们可以快速创建命令行工具，适用于写测试脚本和各种服务的Admin CLI。文章还通过一个简单的demo演示了Cobra的使用方法。 ... [详细]
  • go

    clone的fork与pthread_create创建线程有何不同

    本文讨论了clone的fork与pthread_create创建线程的不同之处。进程是一个指令执行流及其执行环境，其执行环境是一个系统资源的集合。在调用系统调用fork创建一个进程时，子进程只是完全复制父进程的资源，这样得到的子进程独立于父进程，具有良好的并发性。但是二者之间的通讯需要通过专门的通讯机制，另外通过fork创建子进程系统开销很大。因此，在某些情况下，使用clone或pthread_create创建线程可能更加高效。 ... [详细]
  • js

    解决JavaScript中alert弹出窗口文本换行问题的方法

    本文详细说明了在JavaScript中解决alert弹出窗口文本换行问题的方法。通过给alert弹出的文本添加换行符，可以实现在弹窗中显示多行文本的效果。同时，提供了相关代码示例和注意事项，帮助读者更好地理解和应用这一解决方法。 ... [详细]
author-avatar
血狼2732_150
这个家伙很懒，什么也没留下！
Tags | 热门标签
RankList | 热门文章
PHP1.CN | 中国最专业的PHP中文社区 | DevBox开发工具箱 | json解析格式化 |PHP资讯 | PHP教程 | 数据库技术 | 服务器技术 | 前端开发技术 | PHP框架 | 开发工具 | 在线工具
Copyright © 1998 - 2020 PHP1.CN. All Rights Reserved | 京公网安备 11010802041100号 | 京ICP备19059560号-4 | PHP1.CN 第一PHP社区 版权所有