Home

Awesome

logFaces Appender (UDP) for log4js-node

The logFaces appenders send JSON formatted log events to logFaces receivers. This appender uses UDP to send the events (there is another logFaces appender that uses HTTP). It uses the node.js core UDP support, so you do not need to include any other dependencies.

npm install log4js @log4js-node/logfaces-udp

Configuration

This appender will also pick up Logger context values from the events, and add them as p_ values in the logFaces event. See the example below for more details.

Example (default config)

log4js.configure({
  appenders: {
    logfaces: { type: '@log4js-node/logfaces-udp' }
  },
  categories: {
    default: { appenders: [ 'logfaces' ], level: 'info' }
  }
});

const logger = log4js.getLogger();
logger.addContext('requestId', '123');
logger.info('some interesting log message');
logger.error('something has gone wrong');

This example will result in two log events being sent via UDP to 127.0.0.1:55201. Both events will have a p_requestId property with a value of 123.