connect-ltsv-logger v0.0.2

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

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

• host

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

• X-Forwarded-For

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

• user

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

• ident

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

• req

  	```js
  	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

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

• uri

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

• protocol

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

• status

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

• size

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

• reqsize

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

• referer

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

• ua

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

• vhost

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

• reqtime

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

• X-Cache

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

• X-Runtime

  	```js
  	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