点击右上方,关注开源中国OSC头条号,获取最新技术资讯
2019年开工大吉!
经过SCG(SeasX Core Group)团队谨慎仔细的构思、开发和测试,终于迎来了SeasLog的大版本更新。
自SeasLog 2.0.2版本开始,SeasLog将支持 自动记录用户态PHP函数的某些层级内的TopN 。
SeasLog地址:
PECL:
Github :
国内镜像:
SeasLogger( composer 包项目)地址:
Github:
国内镜像:
composer包地址:
Q:什么是“用户态PHP函数”
A:相对PHP内置函数、PHP扩展函数等“内核态”函数而言,由PHP开发者编写的函数。这将使性能日志更加聚焦在用户所编写的函数上。
Q:什么是“某些层级内的TopN”
A:对于一个PHP应用来说,将有或深或浅的代码栈树形执行层级。程序执行的入口函数为第一层级,父节点的叶子节点为一个新的层级。父节点函数的执行时间大于等于子叶点的执行时间合。SeasLog通过配置项关注从某个层级开始的节点,并通过排序算法计算出每个层级按执时间降序排列的TopN,并记录为性能日志。这将使性能日志更加聚焦在可能存在的性能瓶颈上。
Q:SeasLog如何自动记录性能日志
A:打开seaslog.trace_performance配置项为1,SeasLog将在请求开始时收集用户态函数的执行时间和占用内存,在请求结束时计算得到性能日志,并记录。如果appender为1(File),则记录在以performance为logger的日志下;如果appender为2(TCP)或3(UDP),则向接收Server端发送以perofrmance为logger并遵守RFC5424协议格式的日志流。
Q:使用SeasLog时怎样进行日志的统一收集和管理
A:目前可参考收集建议。SCG(SeasX Core Group)也正在开发更加轻量化的收集分析组件、可视化平台。
Q:性能日志有没有采样比
A:有采样比。通过seaslog.trace_performance_sample_rate来设置采样的千分比。该值默认为10,即10/1000(1/100)。
Q:性能日志相关的配置一共有哪些
A: ;是否开启性能追踪 1开启 0关闭(默认) seaslog.trace_performance = 0 ;性能追踪时的千分比采样率 ;默认10,即百分之一 seaslog.trace_performance_sample_rate = 10 ;性能追踪时的开始层级 默认从第1层开始 seaslog.trace_performance_start_depth = 1 ;性能追踪时深度层级 默认5层 seaslog.trace_performance_max_depth = 5 ;性能追踪时每层的函数最大数 按wall_time降序排列top 默认top5 seaslog.trace_performance_max_functions_per_depth = 5 ;性能追踪时当前请求执行时间的记录阈值 只有当请求执行时间大于该值时,才记录性能日志 默认1000ms seaslog.trace_performance_min_wall_time = 1000 ;性能追踪时每个方法执行时间的记录阈值 只有当方法执行时间大于该值时,才参与计算 默认10ms seaslog.trace_performance_min_function_wall_time = 10
查看完整SeasLog可用配置
Q:SeasLog的性能究竟怎么样
A:
当SeasLog不开启buffer时,SeasLog是:syslog()函数的8.6倍、file_put_contents()函数的240倍、fwrite()单例情况下的36倍、fwrite()非单例情况下的211倍、monolog不开启buffer时的41倍;当SeasLog开启buffer且buffer_size为100时,SeasLog是:syslog()函数的250倍、file_put_contents()函数的6962倍、fwrite()单例情况下的1052倍、fwrite()非单例情况下的6127倍、monolog开启buffer且buffer size为100时的118倍。
Chang Log
2.0.2
- Fixed issue #175 支持自动记录PHP慢方法的TopN.
- Fixed 修复模板中的预设变量 %C ,支持 Class::Action.
1.9.1
- Fixed issue #249 添加单元测试例,修复setLogger的bug.
- Fixed 修复 mac osx的编译错误.
1.9.0
- New Feature #240 增加方法 SeasLog::setRequestVariable(key,value),可以支持用户使用swoole等框架时改变SeasLog预设变量
- New Feature #243 Log方法第一个参数支持数组传递,如 SeasLog:: debug (array).
- Fixed issue #110 支持构造函数,可以使用 New SeasLog().
- Fixed issue #234 #236 修复SeasLog::analyzerDetail 函数Bug.
- Fixed issue #245 为 analyzerCount 和 analyzerDetail添加单元测试例.
日志模板预设变量表
SeasLog提供了下列预设变量,可以直接使用在日志模板中,将在日志最终生成时替换成对应值。
- %L – Level 日志级别。
- %M – Message 日志信息。
- %T – DateTime 如2017-08-16 19:15:02,受seaslog.default_datetime_format影响。
- %t – Timestamp 如1502882102.862,精确到毫秒数。
- %Q – RequestId 区分单次请求,如没有调用SeasLog::setRequestId($string)方法,则在初始化请求时,采用内置的static char *get_uniqid()方法生成的惟一值。
- %H – HostName 主机名。
- %P – ProcessId 进程ID。
- %D – Domain:Port 域名:端口号,如:8080; Cli模式下为cli。
- %R – Request URI 请求URI,如/app/user/signin; Cli模式下为入口文件,如CliIndex.php。
- %m – Request Method 请求类型,如GET; Cli模式下为执行命令,如/bin/bash。
- %I – Client IP 来源客户端IP; Cli模式下为local。取值优先级为:HTTP_X_REAL_IP > HTTP_X_FORWARDED_FOR > REMOTE_ADDR
- %F – FileName:LineNo 文件名:行号,如UserService.php:118。
- %U – MemoryUsage 当前内容使用量,单位 byte 。调用zend_memory_usage。
- %u – PeakMemoryUsage 当前内容使用峰值量,单位byte。调用zend_memory_peak_usage。
- %C – Class::Action 类名::方法名,如UserService::getUserInfo。
为什么使用SeasLog
log日志,通常是系统或软件、应用的运行记录。通过log的分析,可以方便用户了解系统或软件、应用的运行情况;如果你的应用log足够丰富,也可以分析以往用户的操作行为、类型喜好、地域分布或其他更多信息;如果一个应用的log同时也分了多个级别,那么可以很轻易地分析得到该应用的健康状况,及时发现问题并快速定位、解决问题,补救损失。
php内置error_log、syslog函数功能强大且性能极好,但由于各种缺陷(error_log无错误级别、无固定格式,syslog不分模块、与系统日志混合),灵活度降低了很多,不能满足应用需求。
好消息是,有不少第三方的log类库弥补了上述缺陷,如log4php、plog、Analog等(当然也有很多应用在项目中自己开发的log类)。其中以log4php最为著名,设计精良、格式完美、文档完善、功能强大。推荐。
不过log4php在性能方面表现非常差,下图是SeasLog与log4php的ab并发性能测试( 测试环境:Ubuntu12.04单机,CPU I3,内存 16G,硬盘 SATA 7200):
那么有没有一种log类库满足以下需求呢:
- 分模块、分级别
- 配置简单(最好是勿须配置)
- 日志格式清晰易读
- 应用简单、性能很棒
SeasLog 正是应此需求而生。
目前提供了什么
- 在PHP项目中便捷、规范地记录log
- 可配置的默认log目录与模块
- 指定log目录与获取当前配置
- 初步的分析预警框架
- 高效的日志缓冲、便捷的缓冲debug
- 遵循 PSR-3 日志接口规范
- 连接TCP端口,以RFC5424格式发送日志
- 连接UDP端口,以RFC5424格式发送日志
- 支持RequestId区分请求
- 支持日志模板自定义
- 自动记录错误、异常、性能日志(慢方法TopN)
目标是怎样的
- 便捷、规范的log记录
- 高效的海量log分析
- 可配置、多途径的log预警
点击下方“ 了解更多 ”,获取软件下载地址。
↓↓↓