connect-ltsv-logger

Introduction

LTSV format logger for (connect|express).

This is just a wrapper of connect.middleware.logger.

Usage

var express = require("express"),
    ltsvlogger = require('connect-ltsv-logger');
 
// define output WriteStream
var out = fs.createWriteStream("ltsv-access.log",{flags: 'a+'}),
 
// define tokens
var ltsv = [];
ltsv.push("host");
ltsv.push("ident");
ltsv.push("user");
ltsv.push("time");
ltsv.push("req");
ltsv.push("status");
ltsv.push("size");
ltsv.push("referer");
ltsv.push("ua");
 
var app = express();
app.configure(function(){
    // app.set(/*snip*/)
    // ...
 
    app.use(ltsvlogger({format:ltsv,stream:out}));
 
    // app.use(/*snip*/)
    // ...
});
 

tail -f ltsv-access.log
host:127.0.0.1<TAB>ident:-<TAB>user:-<TAB>time:[13/Feb/2013:19:15:44 +09:00]<TAB>req:GET /stylesheets/style.css HTTP/1.1<TAB>status:200<TAB>size:110<TAB>referer:http://localhost:3001/<TAB>ua:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_5) AppleWebKit/537.17 (KHTML, like Gecko) Chrome/24.0.1312.57 Safari/537.17

Options

• format: Format string or Token array, see below for tokens
• stream :is the same as connect.logger.
• buffer: is the same as connect.logger.
• immediate: is the same as connect.logger.

Formats

Just override connect.logger's formats as ltsv

• default

host:127.0.0.1<TAB>ident:-<TAB>user:-<TAB>time:[Wed, 13 Feb 2013 10:00:55 GMT]<TAB>req:GET / HTTP/1.1<TAB>status:200<TAB>size:110<TAB>referer:-<TAB>ua:-

• short

host:127.0.0.1<TAB>ident:-<TAB>req:GET / HTTP/1.1<TAB>status:200<TAB>size:-<TAB>response-time:1 ms

• tiny

req:GET /<TAB>status:200<TAB>size:-<TAB>response-time:1 ms

• dev

concise output colored by response status for development use (Not ltsv format).

Tokens

The following tokens are available

• time

  logger.token("time",function(){
    return "[" + moment().format("DD/MMM/YYYY:HH:mm:ss Z") + "]" ;
  });

• host

  logger.token("host",function(req,res){
    return req.connection.address().address || '-';
  });

• X-Forwarded-For

  logger.token("X-Forwarded-For",function(req,res){
    return res.getHeader("X-Forwarded-For") || "-";
  });

• user

  logger.token("user",function(req,res){
    return '-';
  });

• ident

  logger.token("ident",function(req,res){
    return '-';
  });

• req

  logger.token("req",function(req,res){
    var ret = [];
    ret.push(req.method);
    ret.push(req.url);
    ret.push("HTTP/"+req.httpVersion);
    return ret.join(" ");
  });

• method

  logger.token("method",function(req,res){
    return req.method;
  });

• uri

  logger.token("uri",function(req,res){
    return url.parse(req.url).href;
  });

• protocol

  logger.token("protocol",function(req,res){
    return url.parse(req.url).protocol;
  });

• status

  logger.token("status",function(req,res){
    return res.statusCode;
  });

• size

  logger.token("size",function(req,res){
    return res.getHeader("content-length");
  });

• reqsize

  logger.token("reqsize",function(req,res){
    if(req.body) return req.body.length;
    return "-";
  });

• referer

  logger.token("referer",function(req,res){
    return req.headers['referer'] || req.headers['referrer'];
  });

• ua

  logger.token("ua",function(req,res){
    return req.headers['user-agent'];
  });

• vhost

  logger.token("vhost",function(req,res){
    return req.headers["host"];
  });

• reqtime

  logger.token("reqtime",function(req,res){
    return new Date - req._startTime;;
  });

• X-Cache

  logger.token("X-Cache",function(req,res){
    return res.getHeader('X-Cache');
  });

• X-Runtime

  logger.token("X-Runtime",function(req,res){
    return res.getHeader('X-Runtime');
  });

Install

npm do

npm install connect-ltsv-logger

License

Source code can be found on github, licenced under MIT.

Author

Developed by Takeharu.Oshida

Contributor

• tshimogaisho