logger middleware for koa-grace
Last updated 3 years ago by xiongwilee .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install koa-grace-logger 
SYNC missed versions from official npm registry.


Logger middleware for http://github.com/koajs. Inspired by morgan from expressjs and apache.


Simplest example that will print basic information to standard output:

var logger = require('koa-logger2');
app.use(logger().gen); // will log to standard output by default

More advanced usage which will output more apache-like combined log:

var logger = require('koa-logger2');

var log_middleware = logger('ip [day/month/year:time zone] "method url protocol/httpVer" status size "referer" "userAgent" duration ms custom[unpacked]');
log_middleware.setStream(fs.createWriteStream(path.join(__dirname, 'logs/2014-09.log'), { flags: 'a' }));

app.use(log_middleware.gen); // !! note there are no () after gen

As a result you will get lines like: [12/Sep/2014:22:12:26 +0200] "GET / HTTP/1.1" 301 22 "-" "Mozilla/5.0 (Android; Mobile; rv:31.0) Gecko/31.0 Firefox/31.0" 0 ms -

Later at any time you can call setStream again in order to replace stream you're writing to.


Just call the only function which is being exported:

logger([ format = " day/month time ip "method url protocol/httpVer" status size "referer" "userAgent" duration ms " ])

This will create logger object which has two properties - setStream method and gen. Formatters currently implemented are:

Formatter Description (Example)
ip IP address of the client
method Request method (GET)
url Request url (/)
status Status code (200)
httpVer Protocol version (1.1)
protocol HTTP or HTTPS
size Content-Length of response
referer Referer header
userAgent User-agent header
time Current time in 24-hour format HH:MM:SS
day Day of month 01-31
month Short month name (Sep)
year Year 4 digits (2014)
zone Timezone offset (+0200)
duration Duration of processing this request
custom[your.field] Basically access anything you want from koa (ctx) object

setStream( stream.Writable )

Use this function to replace output stream for the logger (for example for log rotation). Please keep in mind that actual writing to the stream happens "on the way back".


Returns generator function which should be used as middleware in your koaApp. ** NOTE: There are NO brackets () at the end. **


  • support for auth-module
  • unit tests
  • better code documentation
  • ...



Current Tags

  • 1.0.4                                ...           latest (3 years ago)

5 Versions

  • 1.0.4                                ...           3 years ago
  • 1.0.3                                ...           3 years ago
  • 1.0.2                                ...           3 years ago
  • 1.0.1                                ...           3 years ago
  • 1.0.0                                ...           3 years ago
Maintainers (1)
Today 0
This Week 0
This Month 5
Last Day 0
Last Week 0
Last Month 5
Dependencies (2)
Dev Dependencies (0)
Dependents (0)

Copyright 2014 - 2018 © taobao.org |