daruk-logger

安装

yarn add daruk-logger

使用logger

const Logger = require('daruk-logger').logger
const prod = process.env.NODE_ENV === 'prod'

const logger = new Logger({ 
  // log等级，超过该级别的日志不会输出
  level: prod ? 'info' : 'silly',
  // 自定义log等级，
  // 定义后，可以使用logger.customAccess('log')输出日志
  customLevels: {
    customAccess: 2
  },
  prettyLog: !prod,
  fileInfo: !prod
})

logger.info('msg')
logger.access('msg')
logger.warn('msg')
logger.error('msg')
// 也支持传递多个日志 msg 参数，输出的日志使用一个空格分隔多个 msg
logger.info('msg1', 'msg2', 'msg3')
logger.warn('msg1', 'msg2')

自定义日志 fileinfo

error 等级的日志的 fileinfo 字段为输出日志的文件路径，出于性能考虑，非 error 等级日志的 fileinfo 字段默认为空，但有时候希望更好地追踪其他等级的日志。
因此提供了customFileInfo方法，该方法返回一个新的logger对象，通过该对象输出的日志，fileinfo 字段都是设置的文件信息

// logger.js
const logger = new Logger({})

module.exports = logger

// my-controller.js
const logger = require('./logger.js').customFileInfo('[my-controller]')

logger.info('msg')
// 输出日志的fileinfo：[my-controller]
logger.warn('msg')
// 输出日志的fileinfo：[my-controller]

封装深度

有时候，可能需要对 logger 做一次封装，也就是先调用自定义 logger 函数，再在自定义 logger 函数中调用 daruk-logger，这时 daruk-logger 会获取到错误的 fileinfo，解决方式是传递 options.wrapDepth 参数：

const Logger = rquire('daruk-logger').logger

const logger = new Logger({
  // 因为这里封装了一次，所以 wrapDepth 传 1
  wrapDepth: 1
})

const myLogger = {
  info (msg) {
    logger.info(meg)
  }
}

需要注意，如果只是覆写 daruk-logger 的方法，不需要传 options.wrapDepth 参数：

const Logger = rquire('daruk-logger').logger

const logger = new Logger()
const info = logger.info
logger.info = function (msg) {
  info(msg)
}

配置options说明

选项	默认值	描述	其他
options.level	info	log等级，log等级，超过该级别的日志不会输出	内置的日志等级：{ error: 0, warn: 1, info: 2, access: 2, verbose: 3, debug: 4, silly: 5 }
options.customLevels	{}	自定义log等级	定义后，可以使用logger.levelName('log')输出日志
options.transports.file	''	输出日志文件的路径，如：/var/log/node-app/app.log	注意，日志文件不会自动进行切割，建议线上时，根据公司运维场景，决定最终的日志处理方式（保存到文件或者发送到日志中心），#2
options.transports.console	true	使用console输出日志	-
options.overwriteConsole	false	是否覆写console对象上的方法	-
options.logExt	{}	加到日志中的额外信息，可以为一个函数，函数需要返回一个key-value对象	比如，添加 { logType: "app1" } 后，每条日志都会添加 logType 字段
options.notStringifyLevles	['access']	不对日志的 msg 进行 JSON.stringify 的日志等级	注意，设置为 notStringifyLevles 后，该等级的日志方法不支持传递多个 msg 参数
options.disable	false	禁用日志输出	-
options.wrapDepth	0	外部的封装深度	-
options.fileInfo	false	在开发环境下，输出打印日志的文件信息	影响性能，不要在线上环境使用
options.prettyLog	false	在开发环境下美化日志输出	不要在线上环境使用
options.separator	------------------------	美化日志时，用于分割每条日志	-
options.prettyLogOption	{}	美化日志选项	https://www.npmjs.com/package/prettyjson

使用中间件

// 在 daruk 中已经默认使用了该中间件
const loggerMiddleware = require('daruk-logger').middleware

// 需要在所有中间件之前，使用该中间件，这样才能取到更加准确的响应时间
server.use(loggerMiddleware({
  transform (logObj, ctx) {
    console.log(JSON.stringify(logObj))
    logger.access(logObj)
  },
  filter (ctx) {
    return true
  }
}))
// 其他中间件
// server.use(json()).use(cors())
// server.use(router.routes()).use(router.allowedMethods())

配置options说明

选项	类型	描述
options.transform	function	日志通过该函数输出，第一个参数为日志内容对象，第二个参数为koa context
[options.filter]	function	日志过滤，返回false则过滤该条日志，参数为koa context
[options.requiredLogs]	string[]	需要输出的日志内容

options.requiredLogs默认值为:

['remote_addr','method','url','http_version','status','referrer','request_time','perf','user_agent']

支持的日志内容有：

['time','url','protocol','hostname','method','status','response_time','request_time','perf', 'date', 'referrer', 'http_version', 'remote_addr', 'user_agent', 'content_length', 'req', 'res']