@mcf/logger v0.4.42

@mcf/logger

Exposes a logger based on Winston. It includes formats and plugins for integration with the Morgan request logging library, and Zipkin request distributed tracing library.

Scope

• Basic logging
• Allows for formatter extensions
• Allows for transport extensions
• Console transport creator
• File transport creator
• FluentD transport creator
• Fluent transport security configuration
• Fluent transport ID tagger

Installation

Install it via npm or yarn:

npm i @mcf/logger
# or
yarn add @mcf/logger

Usage

Requiring

import {createConsoleTransport, createFluentTransport, createLogger} from '@mcf/logger';
// or
const {createConsoleTransport, createFluentTransport, createLogger} = require('@mcf/logger');

Basic

By default, the logger already logs to the console and no configuration is needed. This should suffice for basic apps.

const basicLogger = createLogger();
basicLogger.silly('a silly hi');
basicLogger.debug('a debug hi');
basicLogger.http('a http hi');
basicLogger.info('a info hi');
basicLogger.warn('a warn hi');
basicLogger.error('a error hi');

FluentD

We use fluent for our centralised logs collector. To initialise the transport, create the logger as such:

const fluentLogger = createLogger({
  additionalTransports: [
    createFluentTransport({
      host: 'localhost',
      port: 44224,
      timeout: 2.0,
      requireAckResponse: false,
    }),
  ],
  // optional message transformation, depends on your elasticsearch setup
  formatters: [
    (info) => {
      const messageIsObject = typeof info.message === 'object';
      return {
        ...info,
        message: messageIsObject ? 'meta' : info.message,
        meta: messageIsObject ? info.message : undefined,
      };
    },
  ],
});

fluentLogger.info('hello world!');

The following fluent.conf should get you up and running:

<source>
  @type forward
  bind 0.0.0.0
  port 24224
</source>

<match **.*>
  @type stdout
</match>

See the usage example for more examples of creating plaintext/encrypted loggers.

Documentation

The library exposes the following methods:

.createLogger(:options)

This function accepts a configuration object as the parameter where the keys are documented as follows:

.createFluentTransport(:options)

This function accepts a configuration object as the parameter where the keys are documented as follows:

This is referenced from the fluent-logger library.

.createConsoleTransport(:options)

This function accepts a configuration object as the parameter where the keys are documented as follows:

.createFileTransport(:options)

This function accepts a configuration object as the parameter where the keys are documented as follows:

.createMorganStream(:options)

This function returns an object that can be used by Morgan to specify a write stream.

The properties for the :options object are:

Examples

Confirm all dependencies have been installed:

yarn;

To run the usage example, set up FluentD first:

yarn svc:fluent;

In another terminal, run the usage application which will pipe to the FluentD instance:

yarn demo-usage;

To stop FluentD, run:

yarn svc:fluent:stop;

Changelog

0.2.x

0.2.1

Added in stream creator for Morgan (see .createMorganStream)

0.2.0

Added more:

• Fluent transport security configuration (.security)
• Fluent transport ID tagger (.tag)
• Fluent transport TLS support (.tls and .tlsOptions)

0.1.x

0.1.0

Initial release with:

• Basic logging
• Allows for formatter extensions
• Allows for transport extensions
• FluentD transport creator
• Console transport creator