@debugr/elastic v3.0.0-rc.10

Elastic Log Handler for Debugr

This LogHandler adds logging to Elastic via SDK.

Installation

npm install --save @debugr/elastic

Usage

import { Logger, LogLevel } from '@debugr/core';
import { ElasticHandler } from '@debugr/elastic';

const globalContext = {
  applicationName: 'example',
};

const logger = new Logger(globalContext, [
  new ElasticHandler({
    index: 'example-app-logs',
  }),
]);

logger.setContextProperty('jobName', 'elasticTest');

logger.info('Application started.');
// should send a new entry to the `example-app-logs` index with the following content:
// {
//   level: 30,
//   message: 'Application started.',
//   ts: '2022-09-04T12:13:14Z',
//   context: {
//     applicationName: 'example',
//     jobName: 'elasticTest',
//   },
// }

Options

The ElasticHandler constructor accepts a required options object as the first argument. An instance of the Client class from the @elastic/elasticsearch SDK can be passed as the second argument; if it is not provided, the constructor will attempt to create it using the provided options object. So when calling the constructor with just a single argument, the options object is a union of the log handler options defined here and the Elastic Client options. See the @elastic/elasticsearch package documentations for the available Client options. The available options of the handler itself are as follows: