应用日志

配置

在bean.php 里面配置应用日志的参数：

  1. return [
  2.     'lineFormatter'      => [
  3.         'format'     => '%datetime% [%level_name%] [%channel%] [%event%] [tid:%tid%] [cid:%cid%] [traceid:%traceid%] [spanid:%spanid%] [parentid:%parentid%] %messages%',
  4.         'dateFormat' => 'Y-m-d H:i:s',
  5.     ],
  6.     'noticeHandler'      => [
  7.         'class'     => FileHandler::class,
  8.         'logFile'   => '@runtime/logs/notice.log',
  9.         'formatter' => \bean('lineFormatter'),
  10.         'levels'    => [
  11.             Logger::NOTICE,
  12.             Logger::INFO,
  13.             Logger::DEBUG,
  14.             Logger::TRACE,
  15.         ],
  16.     ],
  17.     'applicationHandler' => [
  18.         'class'     => FileHandler::class,
  19.         'logFile'   => '@runtime/logs/error.log',
  20.         'formatter' => \bean('lineFormatter'),
  21.         'levels'    => [
  22.             Logger::ERROR,
  23.             Logger::WARNING,
  24.         ],
  25.     ],
  26.     'logger'             => [
  27.         'flushRequest' => false,
  28.         'enable'       => false,
  29.         'handlers'     => [
  30.             'application' => \bean('applicationHandler'),
  31.             'notice'      => \bean('noticeHandler'),
  32.         ],
  33.     ]
  34. ];

此配置也是框架默认的配置文件，把应用日志按日志级别分别写到两个不同的文件里面。

日志格式

lineFormatter 配置日志格式：

  • format 日志输到文件格式
  • dateFormat 日志输出时间格式

日志处理器

noticeHandler 和 applicationHandler 处理器，应用日志可以配置多个处理器，处理器可以把日志输出到文件、邮箱、第三方系统。

配置详细参数：

  • class 配置采用哪种类型的，框架默认提供文件，用户可以自己扩展其它类型
  • logFile 输出日志文件路径，支持别名
  • formatter 日志输出使用日志格式，就是之前配置的日志格式
  • levels 支持日志输出的日志级别

日志配置

logger 日志配置：

  • name 名称
  • flushInterval 日志输出频率默认 1
  • flushRequest 是否每个请求结束输出日志开，默认 false
  • enable 是否开启日志，默认 false
  • json 是否 JSON 格式输出，默认 false
  • items 日志其它数据，配置是一个数组集合

使用

开发者直接通过 Log 类静态方法，打印日志。应用日志根据不同的需求分为如下不同的日志记录：

  • emergency
  • debug
  • alert
  • info
  • warning
  • error
  2. // Tag start
  3. Log::profileStart('tagName');
  5. Log::debug('this %s log', 'debug');
  6. Log::info('this %s log', 'info');
  7. Log::warning('this %s log', 'warning');
  8. Log::error('this %s log', 'error');
  9. Log::alert('this %s log', 'alert');
  10. Log::emergency('this %s log', 'emergency');
  12. // Pushlog
  13. Log::pushLog('key', 'value');
  14. Log::pushLog('key', ['value']);
  15. Log::pushLog('key', 'value');
  17. // Tag end
  18. Log::profileEnd('tagName');
  20. // Counting
  21. Log::counting('mget', 1, 10);
  22. Log::counting('mget', 2, 10);
  24. // 2019-05-11 06:57:27 [info] [swoft] [request] [tid:4] [cid:4] [traceid:] [spanid:] [parentid:] trace[LogController.php:29,App\Http\Controller\LogController->test] info message
  25. // 2019-05-11 06:57:27 [debug] [swoft] [request] [tid:4] [cid:4] [traceid:] [spanid:] [parentid:] trace[LogController.php:35,App\Http\Controller\LogController->test] this debug log
  26. // 2019-05-11 06:57:27 [info] [swoft] [request] [tid:4] [cid:4] [traceid:] [spanid:] [parentid:] trace[LogController.php:36,App\Http\Controller\LogController->test] this info log
  27. // 2019-05-11 06:57:27 [warning] [swoft] [request] [tid:4] [cid:4] [traceid:] [spanid:] [parentid:] trace[LogController.php:37,App\Http\Controller\LogController->test] this warning log
  28. // 2019-05-11 06:57:27 [error] [swoft] [request] [tid:4] [cid:4] [traceid:] [spanid:] [parentid:] trace[LogController.php:38,App\Http\Controller\LogController->test] this error log
  29. // 2019-05-11 06:57:27 [notice] [swoft] [request] [tid:4] [cid:5] [traceid:] [spanid:] [parentid:] [8.52(ms)] [27(MB)] [/log/test] [key=value key=["value"] key=value] profile[tagName=5.02(ms)/2] counting[mget=3/20]

日志级别可以根据自己的业务定义不同的含义，debug 日志级别只有开启 APP_DEBUG 默认才会输出. notice 日志级别，每个请求结束框架自动追加上的一条日志，该条日志会记录这次请求，框架和业务运行的详细信息，比如数据库操作记录、缓存操作记录以及请求信息。日志方法可以像 sprintf() 函数一样传递参数，底层自动封装。

除常用的日志级别，框架还提供 pushLog profile

  • pushLog 用于记录请求执行过程中的参数，notice 日志里面可以查看
  • profile 使用的时，需要定义一个标记，标记开始和结束为止，该方法可以记录标记之间运行时间，notice 日志里面可以查看。