elbstack-logger

Just another simple logging module

Usage no npm install needed!

<script type="module">
  import elbstackLogger from 'https://cdn.skypack.dev/elbstack-logger';
</script>

README

Simple logger for NodeJS

What does it do?

This logger simply uses the Javascript console object to log messages in JSON format. The JSON will be transformed to a string by simply running JSON.stringify on it. If you log a text message the format will be:

{
  "@appId": "elbstack-logs-test",
  "@version": "1.0.0",
  "@level": "info",
  "@timestamp": 1490676496916,
  "text": "This is a sample text"
}

If you log a JSON serializable object the format will be:

{
  "@appId": "elbstack-logs-test",
  "@version": "1.0.0",
  "@level": "warn",
  "@timestamp": 1490676496916,
  "key1": "value1",
  "key2": 2
}

Installation

npm install --save elbstack-logger

Usage

const Logger = require('elbstack-logger');
const logger = new Logger('sample-app-id', '1.0.0', Logger.LOG_LEVEL_INFO);

Log level hierarchy

Logger.LOG_LEVEL_DEBUG
Logger.LOG_LEVEL_INFO
Logger.LOG_LEVEL_WARN
Logger.LOG_LEVEL_ERROR
Logger.LOG_LEVEL_FATAL

Usage with text messages

logger.info('This is a sample text');

Usage with JSON serializable objects

logger.info({ key1: 'value1', key2: 2 });

Usage with both

The logger simply accepts multiple arguments. All object type arguments will be merged straight away into the logged JSON from the right to the left. All arguments of other types will be merged to one string divided by spaces. That means that if you would do the following function call:

logger.info({ key1: 'value1' }, 'abcdefg', { key1: 'value1Overwrite', anotherKey: 1 }, 5);

Then the result will be:

{
  "@appId": "sample-app-id",
  "@version": "1.0.0",
  "@level": "info",
  "@timestamp": 1490676496916,
  "key1": "value1Overwrite",
  "anotherKey": 1,
  "text": "abcdefg 5"
}