@caal-15/winston3-logstash-transport NPM

winston3-logstash-transport

A winston@3 transport for LogStash.

This winston transport has been rewritten from both winston-logastah and winston-logstash-udp to use the new Transport behavior from winston@3.

Where possible, this has been updated to mimic the behaviors of the original modules. There are some changes that have been made to allow the transport to handle either TCP or UDP connections to LogStash, instead of being dedicated to a single transport-layer protocol.

Usage

const Winston = require('winston');
const WinstonLogStash = require('winston3-logstash-transport');

const logger = Winston.createLogger();

logger.add(new WinstonLogStash({
  mode: 'udp',
  host: '127.0.0.1',
  port: 28777
}));

logger.error('Some Error');

API

constructor(options)

Create a new Logstash Transport

options

Name	Type	Description	Valid Values	Default	TCP	UDP
`mode`	string	The protocol to use to connect to LogStash. `tcp` is an alias for `tcp4` and `udp` is an alias for `udp4`.	`udp` `udp4` `udp6` `tcp` `tcp4` `tcp6`	`'udp4'`	✔️	✔️
`localhost`	string	The hostname sent to LogStash	Any	`os.hostname`	✔️	✔️
`host`	string	The LogStash server ip or hostname	Any valid IP or host address	`127.0.0.1` (ip4)`::0` (ip6)	✔️	✔️
`port`	integer	The LogStash server port number	Any integer	`28777`	✔️	✔️
`applicationName`	string	The application name sent to LogStash	Any	`process.title`	✔️	✔️
`pid`	string	The Operating System process ID for this process	Any valid PID	`process.pid`	✔️	✔️
`silent`	boolean	Offline/Silent mode enabled		`false`	✔️	✔️
`maxConnectRetries`	integer	The number of attempts to reconnect to make before erroring out	Any integer	`4`	✔️	✔️
`timeoutConnectRetries`	integer	The number of milliseconds to wait between connection attempts	Any integer	`100`	✔️	✔️
`label`	string	The LogStash label to send with the information	Any	`process.title`	✔️	✔️
`sslEnable`	boolean	Whether SSL/TLS connection should be attempted when connecting via TCP		`false`	✔️
`sslKey`	filepath	The filepath to the SSL Key	Any valid filepath	`''`	✔️
`sslCert`	filepath	The filepath to the SSL Cert	Any valid filepath	`''`	✔️
`sslCA`	filepath or Array(filepaths)	The filepath(s) to the Certificat Authority (CA) Intermediary Certs	Any valid filepath(s)	`''`	✔️
`sslPassPhrase`	string	The SSL Cert PassPhrase (if any)	Any	`''`	✔️
`rejectUnauthorized`	boolean	Enable connection rejection when cert is not valid		`false`	✔️
`trailingLineFeed`	boolean	Enable appending end of line character to UDP output		`false`		✔️
`trailingLineFeedChar`	string	The type of end of line character(s) to append to UDP output	Any	`os.EOL`		✔️
`json`	boolean	Use if you are logging JSON objects and don't want their structure changed	`true`/`false`	`false`	✔️	✔️

License

winston winston@3 logstash tcp udp transport winston-transport logging winston-logstash winston-logstash-udp

@outofsync/lodash-ex winston-transport

@everything-registry/sub-chunk-151 @zalastax/nolb-_caa @infinitebrahmanuniverse/nolb-_caa

1.0.4

4 years ago

1.0.3

4 years ago

1.0.2

4 years ago