@log4js-node/loggly

Loggly Appender for log4js-node

Stats

StarsIssuesVersionUpdatedCreatedSize
@log4js-node/loggly
301.0.04 years ago4 years agoMinified + gzip package size for @log4js-node/loggly in KB

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.

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.