rapidus

A logging package that does the essentials

Usage no npm install needed!

<script type="module">
  import rapidus from 'https://cdn.skypack.dev/rapidus';
</script>

README

rapidus

NPM Version Build Status Coverage Status

A logging package that does the essentials.

Partners in crime

A connect middleware that generates an access log

Colourful logging with sparkle

A module to configure your logger from JSON, Yaml etc

Examples

Basic usage is very similiar to log4js or python's logging module

logger = require('rapidus').getLogger('myapp.network');

logger.debug('connecting to %s', host)
logger.error('failed to connect', err);

For more involved examples see the examples repository

Core concepts

Record

  • A single log event, contains message and additional details

Formatter

  • Formats a Record to a string, used by Sink

Processor

  • Applied to log record to add extra data before being given to the sinks

Sink

  • Append log event to specific destination
  • Uses attached formatter to format record
  • Can filter log events to include

Logger

  • A named logger within in a logging hierarchy
  • Can have multiple Sinks attached
  • Can have multiple Processors attached
  • Can filter log events to propagate

Hierarchy

  • A hierarchy of loggers

Something changed that's not your face

it's mine!