winston-logrotate

1.3.0 • Public • Published

winston-logrotate

Build Status

Overview

Winston's default file transport rotation creates new logs daily, or if the file exceeds a max size, but it does not expunge old logs. This means that an additional module must be used to delete old log files.

winston-logrotate provides a transport with full support for size based rotation, compression and pruning log files.

winston-logrotate uses logrotate-stream under the covers, which is used to perform compression/rotation and winston's common.log to get timestamps, colorization, and log formatting.

Options

Field Required Description
file yes The filename of the logfile to write output to.
colorize no Boolean flag indicating if we should colorize output.
timestamp no Boolean flag indicating if we should prepend output with timestamps (default false). If function is specified, its return value will be used instead of timestamps.
json no If true, messages will be logged as JSON (default true).
size no The max file size of a log before rotation occurs. Supports 1024, 1k, 1m, 1g. Defaults to 100m
keep no The number of rotated log files to keep (including the primary log file). Defaults to 5
compress no Optionally compress rotated files with gzip. Defaults to true.

Usage

Require:

require('winston-logrotate');

Create a rotate transport:

var rotateTransport = new winston.transports.Rotate({
        file: '/tmp/my.log', // this path needs to be absolute
        colorize: false,
        timestamp: true,
        json: false,
        size: '100m',
        keep: 5,
        compress: true
});

and add it to default winston logger:

winston.add(rotateTransport)

or create a custom logger using the transport:

var logger = new (winston.Logger)({ transports: [rotateTransport] });

Readme

Keywords

Package Sidebar

Install

npm i winston-logrotate

Weekly Downloads

2,221

Version

1.3.0

License

Apache-2.0

Last publish

Collaborators

  • bkutil
  • davidvgalbraith
  • demmer
  • mstemm