koa-log4

参考文章: 知乎专栏

一、日志配置
1、 依赖选择： 根据koa wiki中的介绍，中间件 koa-log4 是 log4js-node koa版本， 且支持 koa2。 npm i –save koa-log4
2、 新建日志路径： ./logs， 用于存放生成的日志文件
3、 新建日志配置文件： ./log.js, 加入代码：

./log.js
const path = require('path')
const log4js = require('koa-log4')
const logDir = path.join(__dirname, 'logs')  //配置目标路径 logs
/*生成logs目录*/
 try {
    require('fs').mkdirSync(logDir)  //新建目录， ./logs
 } catch(err) {
    if(err.code !== 'EEXIST') {
        console.error('Could not set up log directory, error was: ', err)
        process.exit(1)
    }
 }
 //根据log 配置文件(log4js.json)配置日志文件
log4js.configure(path.join(__dirname, 'log4js.json'), { cwd: logDir })
//注册日志： 日志名（前缀）startup
const logger = log4js.getLogger('startup')
//输入日志
logger.info('logs config finished!')

5、 日志配置文件 (log4js.json) 编写 实际使用中以下注释全部删除

{
  "appenders": [
    {
      "type": "console"  //控制台输出日志
    },
    {
      "type": "clustered",  //支持多 appender 时添加， 
      "appenders": [
         {  //在./logs目录生成 http.log文件
          "type": "dateFile", //datefile表示是输出按时间分文件的日志
          "filename": "http.log",  //文件件名
          "pattern": "-yyyy-MM-dd",  //非当天日志命名格式，例如：http.log-2016-08-02
          "category": "http"  //过滤所有日志名为 http 的日志
        },
        {  //记录所有日志
          "type": "file",  //file表示日志输出为普通文件,在此种配置下,所有日志会输出到该日志文件
          "filename": "app.log", //日志文件名
          "maxLogSize": 10485760,  //设置日志文件的最大大小，文件体积超过时，自动分文件
          "pattern": "-yyyy-MM-dd", //
          "numBackups": 5  //备份的文件数量,如果文件过多则会将最旧的删除
        },
        {
          "type": "logLevelFilter", //日志级别过滤
          "level": "ERROR",  //该日志文件只记录级别在error及以上的日志
          "appender": {
            "type": "file",  
            "filename": "errors.log"
          }
        },
      ]
    }
  ]
}

6、 在koa web工程中应如 log4

const Koa = require('koa')
const co = require('co')
const nunjucksViews = require('koa-nunjucks-promise')
const router = require('koa-router')
const mount = require('koa-mount')
const server = require('koa-static')
const session = require("koa-session2")
const log4js = require('koa-log4')
//----------------------------
require('./log')  //引入（运行）日志配置文件， 生产日志目录及相应文件
const logger = log4js.getLogger('app') //将当前文件日志命名为 app 
logger.info('--------step into koa-------------')
//----------------------------
const store = require('./store')
const app = new Koa()
const route = new router()
app.use(nunjucksViews(`${__dirname}/views`, {  //配置模板文件路径，
    ext: 'html',   //渲染文件后缀为 html
    noCache: true,  //开发环境下不设置缓存
    watch: true,  //开发环境下观察模板文件的变化并更新
    filters: {  //过滤器  
        json: function(str) {
          return JSON.stringify(str, null, 2)
        }
    },
    globals: {  //设置对于nunjucks的全局变量
        // staticPath: '//static'
    }
}))
app.use(mount('/static', server(`${__dirname}/public`)))  //设置静态文件路径
//------------- 记录所有http请求---------------
app.use(log4js.koaLogger(log4js.getLogger('http'), { level: 'auto' }))
//-------------------------------------------
app.use(session({
    key: "sessionId",   //default "koa:sess",
    store: new store(),
    maxAge: 5000  //设置session超时时间
}))
route.get('/', co.wrap(function* (ctx) {
 //-------------------------------------------
    logger.debug(' this is test log')  //打印日志，日志级别 debug
//-------------------------------------------
    if(ctx.session.view === undefined) {
        ctx.session.view = 0
    } else {
        ctx.session.view += 1   
    }
    console.log('viewNum', ctx.session.view)
    yield ctx.render('index', {title: 'Nunjucks', content: 'Feifeiyu yeah!'})
}))
route.get('/route/test', co.wrap(function* (ctx) {
    logger.info(' this is test log2')  //打印日志，日志级别 info
    ctx.body = 'feifeiyu nuaa'
}))
app.use(route.routes())
    .use(route.allowedMethods())
app.listen(3000, () => console.log('server started， port 3000'))
module.exports = app