winston-tcp-graylog

Published

25 Feb 09:11

Last Push

27 Apr 10:23

Marketplace Rating

Discussion

1 Comments

Readme from Github

winston-tcp-graylog

npm i -S winston-tcp-graylog winston

A graylog2 transport for winston based on the node-gelf-pro library. Support TCP and UPD protocol.

Example

import winston from 'winston'
import WinstonTcpGraylog from '../src'

var options = {
  gelfPro: {
    adapterName: 'tcp',
    adapterOptions: {
      host: '127.0.0.1',
      port: 12201
    }
  }
}

var wGraylog = new winston.transports.TcpGraylog(options)
var wConsole = new winston.transports.Console()

var logger = new winston.Logger({
  transports: [ wGraylog, wConsole ]
})

logger
  .on('error', err => {
    // internal winston problems
    console.error('!error: ', err)
  })
  .on('logging', (transport, level, msg, meta) => {
    // each winston transports
    console.info('!logging: ', transport.name, level, msg, meta)
  })

wGraylog
  .on('error', err => {
    // internal WinstonTcpGraylog problems
    console.error('!wtg:error: ', err)
  })
  .on('send', (msg, res) => {
    // only WinstonTcpGraylog "logging"
    console.info('!wtg:send: ', msg, res)
  })
  .on('skip', warn => {
    // only WinstonTcpGraylog "skiping"
    console.warn('!wtg:skip: ', warn)
  })

logger.info('123', { meta: 123, foo: 345, bar: 689 })
logger.warn('%j - %j - %s - %s', [1, 2, 3], { 1: 2 }, /123/, new Error('123'))
logger.error(`some formatted message \
  \n\t some: 123\
  \n\t foo: 123\
  \n\t bar: 345`)

Config

name: Transport name
level: Level of messages this transport should log. (default: info)
silent: Boolean flag indicating whether to suppress output. (default: false)
handleExceptions: Boolean flag, whenever to handle uncaught exceptions. (default: false)
humanReadableUnhandledException: Option to get more readable exceptions.
formatter: See winston-doc
gelfPro: See gelfPro-doc or my-jjv-schema
baseMsg: Object containing the default message fields.
levelMap: Object for extending the base levelMap

DefaultConfig

{
    name: 'tcpGraylog',
    silent: false,
    level: 'info',
    handleExceptions: false,
    humanReadableUnhandledException: false,
    formatter: v => v,
    baseMsg: {
        version: '1.1',    // GELF spec version
        appVersion: '...', // package.version || unknown version
        facility: '...',   // package.name || app-dir        
        host: '...'        // hostname -f || os.hostname()
    },
    gelfPro: {
        adapterName: 'udp',
        adapterOptions: {
            protocol: 'udp4',
            host: '127.0.0.1',
            port: 12201
        },
    },
    levelMap: {
      emergency: 0,
      emerg: 0,
      alert: 1,
      critical: 2,
      crit: 2,
      error: 3,
      err: 3,
      warning: 4,
      warn: 4,
      notice: 5,
      note: 5,
      information: 6,
      info: 6,
      log: 6,
      debug: 7
    }
}

Your Rating

Please sign in to rate this add-on.

Comments

atrioom almost 3 years ago

What is the `import WinstonTcpGraylog from '../src'` doing? It's never used in the code that follows and it assumes I have a folder `src` somewhere lying around? I tried implementing winston graylog like this and that does not seem to work:
```
var winston = require('winston');
// Only implement the graylog server transport, when the graylog Server IP is set.
var transports = [];
transports.push(new (require('winston-tcp-graylog'))({
name: 'tcpGraylog',
handleExceptions: false,
gelfPro: {
adapterName: 'tcp',
adapterOptions: {
protocol: 'tcp',
host: '93.189.28.58',
port: 12201
}
}
}));
var grayLogger = new winston.Logger({
transports: transports
});
```
I seem to miss something.... Any suggestions? Thanks

Please sign in to comment.

Back to listing