@mechanicalhuman/bunyan-pretty

Prettifies NDJSON (Newline Delimited JSON) logs, like `bunyan -o short` but actually pretty.

Stats

StarsIssuesVersionUpdatedCreatedSize
@mechanicalhuman/bunyan-pretty
223.0.12 months ago4 years agoMinified + gzip package size for @mechanicalhuman/bunyan-pretty in KB

Readme

@mechanicalhuman/bunyan-pretty

hero image

Prettifies NDJSON (Newline Delimited JSON) logs, like `bunyan -o short` but actually pretty.


Table of contents

Install

npm install @mechanicalhuman/bunyan-pretty

Usage

The tool reads from the STDIN and is installed as the cmd pretty in the shell.

  • You can pipe it to the output of a running application:

    node index.js | pretty [OPTIONS]
    
  • Or just feed it an already existing file.

    pretty [OPTIONS] < input.log
    

Options

pretty --help
___

Usage: ... | pretty [options]

Time Staps
--time-stamps                   Print TimeStamps.                   [boolean][default: true]
--stamps-format, -f             TimeStamps format.                  [YYYY-MM-DD-HH:mm:ss]
--stamps-time-zone, --tz        TimeStamps zone offset.             [default: "Etc/UTC"]
--print-host                    Prepends the host to the log line.  [boolean][default: false]

Filter
--strict                        Only show "legal" log lines.        [boolean][default: false]
--level, -l                     Only show messages >= level.        [string][default: "trace"]

Inspect
--depth                         (passed to util.inspect)            [number][default: 4]
--max-array-length              (passed to util.inspect)            [number][default: 100]

Other
--force-color                   Force color output                  [boolean][default: false]

Notes

  • Theboolean options can be set false using --no-option. Example: --no-time-stamps
  • The--level choices are: "trace", "debug", "info", "error", "warn", "fatal"
  • The--stamps-format value is passed directly to moment.format()
  • You force the colored output using the env variable: FORCE_COLOR=1
  • You can pass the time stamps zone offset via the env variable: PRETTY_TZ
  • You can pass the time stamps format via the env variable: PRETTY_STAMPS_FORMAT

Programatic Interface

You can use pretty as a writable stream from inside your NodeJS scripts. Probably usefull on development.

/**
 * WIll wrap the given stream with pretty.
 *
 * @param  {WritableStream} stream          Writable stream to wrap pretty around
 * @param  {Object} [opts]                  Options object, will merge with the default options.
 *
 * @return {WritableStream}
 */

const pretty = require('@mechanicalhuman/bunyan-pretty')

Default Options

The options object passed to pretty will merge with the default options.

const defaultOptions = {
  level: 0, // Named level or bunyan/pino level value
  strict: false,

  forceColor: false,
  termColors: false, // trust the term colors, not the stream ones
  colorLevel: 2, // based on your terminal (uses supports-color)

  depth: 4,
  maxArrayLength: 100,

  printHost: false,
  timeStamps: true,
  stampsFormat: 'YYYY-MM-DD-HH:mm:ss',
  stampsTimeZone: moment.tz.guess(), // Based on your Locale
}

Example

const pretty = require('@mechanicalhuman/bunyan-pretty')
const bunyan = require('bunyan')

const log = bunyan.createLogger({
  name: 'myapp',
  stream: pretty(process.stdout, { timeStamps: false }),
  level: 'info',
})

log.info('hello world')

Maintainers

Changelog

Find the CHANGELOG here, generated using Conventional Commits.

License

MIT © Jorge Proaño

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.