Package Exports

@log4js-node/loggly

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@log4js-node/loggly) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Loggly Appender for Log4JS

Sends logging events to Loggly, optionally adding tags. This appender uses node-loggly-bulk. Consult the docs for node-loggly-bulk, or loggly itself, if you want more information on the configuration options below.

Installation

npm install @log4js-node/loggly

(This is a plug-in appender for log4js, so you'll need that as well)

Configuration

type - @log4js-node/loggly
token - string - your really long input token
subdomain - string - your subdomain
auth - object (optional) - authentication details
- username - string
- password - string
tags - Array<string> (optional) - tags to include in every log message

This appender will scan the msg from the logging event, and pull out any argument of the shape { tags: [] } so that it's possible to add additional tags in a normal logging call. See the example below.

Example

log4js.configure({
  appenders: {
    loggly: {
      type: 'loggly',
      token: 'somethinglong',
      subdomain: 'your.subdomain',
      tags: [ 'tag1' ]
    }
  },
  categories: {
    default: { appenders: ['loggly'], level: 'info' }
  }
});

const logger = log4js.getLogger();
logger.info({ tags: ['my-tag-1', 'my-tag-2'] }, 'Some message');

This will result in a log message being sent to loggly with the tags tag1, my-tag-1, my-tag-2.