log-node

log writer for typical Node.js processes

• Printf-like message formatting
• Configure log level visbility threshold through LOG_LEVEL env variable (defaults to notice)
• Extra debug output can be controlled via LOG_DEBUG env variable (fallbacks to DEBUG if provided)
• Optionally outputs timestamps by log messages, controlled by LOG_TIME env variable
• Outputs colored logs if terminal supports it (can overriden through DEBUG_COLORS env variable)
• Object inspection depth defaults to 4, but can be overriden via LOG_INSPECT_DEPTH (fallbacks to DEBUG_DEPTH if provided)
• Writes to stderr stream.

Usage

At beginning of main module of your program invoke:

require("log-node")();

Tests

$ npm test

Changelog

All notable changes to this project will be documented in this file. See standard-version for commit guidelines.

8.0.3 (2021-12-21)

Maintenance Improvements

8.0.2 (2021-10-22)

Maintenance Improvements

• Remove has-ansi dependency due to security issues (#6) (5813577) (Gareth Jones)

8.0.1 (2021-09-10)

Maintenance Improvements

• Do not apply decorators on empty message (e2d03d7)

8.0.0 (2021-09-02)

⚠ BREAKING CHANGES

• Node.js version 10 or later is required (dropped support for v6 and v8)

Features

• Allow to customize env in writer constructor (01bfaae)

Maintenance Improvements

• Drop support for Node.js versions below v10 (83bba3e)
• Upgrade has-ansi to v4 (caf610c)
• Upgrade supports-color to v8 (8b6f1d5)
• Upgrade to cli-color v2 (7ebe5f8)

7.0.0 (2019-04-10)

Features

• upgrade to log v6 (2c6a2ee)

BREAKING CHANGES

• Drop support for log v5

6.1.0 (2019-04-09)

Features

• seclude NodeLogWriter class (2399f45)

6.0.1 (2019-04-08)

6.0.0 (2019-04-08)

Features

• upgrade configuration ot use LogWriter (7ac81e3)

BREAKING CHANGES

• Removed format and formatEventMessage utilties

5.1.0 (2019-03-19)

Features

• dim log timestamps (f85a103)

5.0.0 (2019-03-19)

Features

• move from util to lib (cf7ce81)
• move from util to lib (f8f93c5)
• move from util to lib (c7e3de5)
• move from util to lib (f9fb731)
• move from util to lib (0d12bfa)
• upgrde to log v5 (2018502)

BREAKING CHANGES

• Move util/resolve-format-parts.js to lib/resolve-format-parts.js
• Move util/level-prefixes.js to lib/level-prefixes.js
• Move util/get-namespace-prefix.js into lib/get-namespace-prefix.js
• Move util/format.js into lib/format.js
• util/format-event-message.js was moved to lib/format-event-message.js
• Switch from log v4 to logv5

4.0.0 (2019-03-18)

Bug Fixes

• ensure private modules are in lib/private (73b75c5)

Code Refactoring

• upgrade to log v4 (703815b)

Features

• support LOG_TIME (e750b82)

BREAKING CHANGES

• Switch to log v4

3.2.1 (2018-11-29)

3.2.0 (2018-11-29)

Features

• rename to log-node (e4209d9)

3.1.1 (2018-10-02)

Bug Fixes

• do not wrap raw strings that contain ansi codes (1027877)

3.1.0 (2018-10-02)

Features

• format util (5d2d8fc)
• seclude inspectDepth resolution to lib (073351d)
• seclude partsResolver util (9a9b101)
• support raw string placeholder variant (f6fd4ac)

3.0.0 (2018-09-28)

Features

• rename to utils/format-event-message.js (d3a78f5)
• support default namespace (5e3c931)

BREAKING CHANGES

• utils/format-message.js was renamed to utils/format-event-message.js

2.3.1 (2018-08-06)

Bug Fixes

• do not decorate placeholders with message decorators (dcaa9ca)

2.3.0 (2018-06-05)

Features

• show warning logs in yellow when colors enabled (fe7564b)

2.2.0 (2018-06-05)

Features

• make error colors red when colors are enabled (9682138)
• Support logger.messageContentDecorator function (f194169)

2.1.1 (2018-06-05)

2.1.0 (2018-06-04)

Bug Fixes

• use less confusing "i" symbol for notice (8c545f5)

Features

• improve string formatting (7d2ea73)

2.0.0 (2018-06-01)

BREAKING CHANGES

• Drop support for log4 v2
• Drop support for Node.js v4
• Switch formatter to rely on sprintf-kit instead of native Node.js one
• Drop support for LOG4_COLORS env var (instead DEBUG_COLORS should be used)

• Change presentation of prefixes

• Hndler is exposed as a function and needs to be invoked:

require("log4-nodejs")();

1.0.0 (2018-03-22)