node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



Winston http request logger for express which is loosely based on express-request-logger.

Build Status

Getting Started

In an existing express project you can add the following configuration fragment to enable request logging to console, with colors while in development or test.

    app.configure('development', 'test', function(){
        // Request Logging 
        var logger = new (winston.Logger)({ transports: [ new (winston.transports.Console)({colorize:true}) ] });

Custom formats

You can optionally specify a second argument to create(logger, [format]) to customize the object sent to Winston:

    app.use(require('winston-request-logger').create(logger, {
        'responseTime': ':responseTime ms', // outputs '5 ms' 
        'url': ':url[pathname]' // outputs '/some/path' 

Format tokens:

  • :date - Timestamp of the request.
  • :statusCode - HTTP status code of the request.
  • :method - HTTP method (GET, POST, etc.)
  • :url[segment] - Segment of the URL requested (Refer to the url module for options).
  • :responseTime - Time it took for the response (in milliseconds).
  • :ip - The client's IP address (looks to X-forwarded-for header first).
  • :userAgent - The client's browser agent (parsed with useragent.


Mark WolfeGitHub/wolfeidauTwitter/@wolfeidau
Evan DudlaGitHub/evNNTwitter/@evandudla


In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using grunt.


Copyright (c) 2013 Mark Wolfe
Licensed under the MIT license.