Logger for node.js cluster, compatible with logrotate
JavaScript Shell
Switch branches/tags
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



This module is designed to be used with Node Cluster in production:

  • one log file for all workers
  • compatible with logrotate: an USR2 signal reopen the log file

This module is compatible with node 0.8.x. For the node 0.6.x, please use version 0.0.1 of this module.

This module is inspired from this module.

How to use it


npm install log4node


Default logger:

var log = require('log4node');

log.error("this is a log");

Will output to console.

Note: you can reconfigure default logger by calling

log.reconfigure({level: 'info', file: 'toto.log'});

Will now write into toto.log

Your custom logger:

var log4node = require('log4node');
    log = new log4node.Log4Node({level: 'warning', file: 'test.log'});

log.error("this is a log");
log.debug("this is a debug log");

Note : you can use the syntax accepted by utils.format.

Log level

Log level can be adjusted for each logger:


Log level for default logger is 'info'.

Available log levels are:

  • emergency
  • alert
  • critical
  • error
  • warning
  • notice
  • info
  • debug


Prefix of log lines can be changed:

log.setPrefix("%d - %p ");

You can use following field in prefix:

  • %d: current date
  • %p: current process id
  • %l: log level

Default prefix is: [%d] %l

Cluster mode

Workers processes will send logs to the cluster master for writing to file.

Setup is fully transparent for developper.

A full example can be found here.

Reopen log file

Just send USR2 signal to node process, or, in cluster mode, to master node process:

kill -USR2 pid

Example of logrotate file:

/var/log/node.log {
  rotate 5
    kill -USR2 `cat process.pid`

Create a specialized logger

This feature is provided to specialize a logger for a sub-component. You can create a new logger with its own level and prefix for a sub-component. The logs will be send to the same files with a prefix.

log = new log4node.Log4Node('warning', 'test.log');
sublogger1 = log.clone({prefix:'SUBMODULE - ', level:'error');

or with the default logger

sublogger1 = log4node.clone(prefix:'SUBMODULE - ', level:'error');


Copyright 2012 Bertrand Paquet

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at


Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.