@contrast/agent 4.5.2 → 4.6.0

package/node_modules/winston-syslog/README.md

@@ -1,135 +0,0 @@
-# winston-syslog
-
-A Syslog transport for [winston][0].
-
-[![Version npm](https://img.shields.io/npm/v/winston-syslog.svg?style=flat-square)](https://www.npmjs.com/package/winston-syslog)[![npm
-Downloads](https://img.shields.io/npm/dm/winston-syslog.svg?style=flat-square)](https://npmcharts.com/compare/winston-syslog?minimal=true)[![Build
-Status](https://img.shields.io/travis/winstonjs/winston-syslog/master.svg?style=flat-square)](https://travis-ci.org/winstonjs/winston-syslog)[![Dependencies](https://img.shields.io/david/winstonjs/winston-syslog.svg?style=flat-square)](https://david-dm.org/winstonjs/winston-syslog)
-
-[![NPM](https://nodei.co/npm/winston-syslog.png?downloads=true&downloadRank=true)](https://nodei.co/npm/winston-syslog/)
-
-## Requirements
-
-* winston >= 3.0.0
-
-## Installation
-
-### Installing npm (node package manager)
-
-``` bash
-  $ curl http://npmjs.org/install.sh | sh
-```
-
-### Installing winston-syslog
-
-``` bash
-  $ npm install winston
-  $ npm install winston-syslog
-```
-
-## Motivation
-`tldr;?`: To break the [winston][0] codebase into small modules that work together.
-
-The [winston][0] codebase has been growing significantly with contributions and other logging transports. This is **awesome**. However, taking a ton of additional dependencies just to do something simple like logging to the Console and a File is overkill.
-
-## Usage
-To use the Syslog transport in [winston][0], you simply need to require it and then either add it to an existing [winston][0] logger or pass an instance to a new [winston][0] logger:
-
-``` js
-  const winston = require('winston');
-
-  //
-  // Requiring `winston-syslog` will expose
-  // `winston.transports.Syslog`
-  //
-  require('winston-syslog').Syslog;
-
-  winston.add(new winston.transports.Syslog(options));
-```
-
-In addition to the options accepted by the syslog (compliant with [RFC 3164][1] and [RFC 5424][2]), the Riak transport also accepts the following options. It is worth noting that the riak-js debug option is set to *false* by default:
-
-* __host:__ The host running syslogd, defaults to localhost.
-* __port:__ The port on the host that syslog is running on, defaults to syslogd's default port.
-* __protocol:__ The network protocol to log over (e.g. `tcp4`, `udp4`, `unix`, `unix-connect`, etc).
-* __path:__ The path to the syslog dgram socket (i.e. `/dev/log` or `/var/run/syslog` for OS X).
-* __pid:__ PID of the process that log messages are coming from (Default `process.pid`).
-* __facility:__ Syslog facility to use (Default: `local0`).
-* __localhost:__ Host to indicate that log messages are coming from (Default: `localhost`).
-* __type:__ The type of the syslog protocol to use (Default: `BSD`, also valid: `5424`).
-* __app_name:__ The name of the application (Default: `process.title`).
-* __eol:__ The end of line character to be added to the end of the message (Default: Message without modifications).
-
-*Metadata:* Logged as string compiled by [glossy][3].
-
-## Log Levels
-Because syslog only allows a subset of the levels available in [winston][0], levels that do not match will be ignored. Therefore, in order to use `winston-syslog` effectively, you should indicate to [winston][0] that you want to use the syslog levels:
-
-``` js
-  const winston = require('winston');
-  const logger = winston.createLogger({
-    levels: winston.config.syslog.levels,
-    transports: [
-      new winston.transports.Syslog()
-    ]
-  });
-```
-
-The `Syslog` transport will only log to the level that are available in the syslog protocol. These are (in increasing order of severity):
-
-* debug
-* info
-* notice
-* warning
-* error
-* crit
-* alert
-* emerg
-
-## Syslog Configuration
-
-You will have to configure your syslog server to accept TCP connections.
-This is usually done in `/etc/syslog-ng.conf`. Let's say you have an app called `fnord`,
-the configuration would look something like this:
-
-```
-  source tcp_s {
-    tcp(ip(0.0.0.0) port(514) max-connections(256));
-  };
-  destination fnord_d {
-    file("/var/log/fnord.log");
-  };
-  log { source(tcp_s); destination(fnord_d); };
-```
-
-If you have multiple apps which need to log via TCP, you can specify filters, as such:
-
-```
-  filter fnord_f { program("fnord"); };
-```
-
-Then modify the log statement to read:
-
-```
-  log { source(tcp_s); filter(fnord_f); destination(fnord_d); };
-```
-
-Now if you have another app, called `bnord`, create similar `destination` and `filter` configurations for it, and specify a new log statement, with the same `source`:
-
-```
-  log { source(tcp_s); filter(bnord_f); destination(bnord_d); };
-```
-
-For this to work, you have to make sure you set the `process.title` variable in your node app.
-
-``` js
-  process.title = 'fnord';
-```
-
-#### Author: [Charlie Robbins](http://blog.nodejitsu.com)
-#### Contributors: [Squeeks](https://github.com/squeeks)
-
-[0]: https://github.com/indexzero/winston
-[1]: http://www.ietf.org/rfc/rfc3164.txt
-[2]: http://tools.ietf.org/html/rfc5424
-[3]: https://github.com/squeeks/glossy

package/node_modules/winston-syslog/lib/utils.js

@@ -1,26 +0,0 @@
-'use strict';
-
-exports.parseProtocol = function parseProtocol(protocol) {
-  switch (protocol) {
-    case 'unix':
-    case 'unix-connect':
-      return { type: 'unix', family: null, isDgram: true };
-
-    case 'udp':
-    case 'udp4':
-      return { type: 'udp', family: 4, isDgram: true };
-
-    case 'udp6':
-      return { type: 'udp', family: 6, isDgram: true };
-
-    case 'tcp':
-    case 'tcp4':
-      return { type: 'tcp', family: 4 };
-
-    case 'tcp6':
-      return { type: 'tcp', family: 6 };
-
-    default:
-      throw new Error('Invalid syslog protocol: ' + protocol);
-  }
-};

package/node_modules/winston-syslog/lib/winston-syslog.js

@@ -1,385 +0,0 @@
-/*
- * syslog.js: Transport for logging to a remote syslog consumer
- *
- * (C) 2011 Squeeks and Charlie Robbins
- * MIT LICENCE
- *
- */
-
-const dgram = require('dgram');
-const net = require('net');
-const utils = require('./utils');
-const glossy = require('glossy');
-const winston = require('winston');
-const Transport = require('winston-transport');
-const { MESSAGE, LEVEL } = require('triple-beam');
-
-// Ensure we have the correct winston here.
-if (Number(winston.version.split('.')[0]) < 3) {
-  throw new Error('Winston-syslog requires winston >= 3.0.0');
-}
-
-const levels = Object.keys({
-  debug: 0,
-  info: 1,
-  notice: 2,
-  warning: 3,
-  error: 4,
-  crit: 5,
-  alert: 6,
-  emerg: 7
-});
-
-//
-// ### function Syslog (options)
-// #### @options {Object} Options for this instance.
-// Constructor function for the Syslog Transport capable of sending
-// RFC 3164 and RFC 5424 compliant messages.
-//
-class Syslog extends Transport {
-  //
-  // Expose the name of this Transport on the prototype
-  //
-  get name() {
-    return 'syslog';
-  }
-
-  constructor(options = {}) {
-    //
-    // Inherit from `winston-transport`.
-    //
-    super(options);
-
-    //
-    // Setup connection state
-    //
-    this.connected = false;
-    this.congested = false;
-    this.retries = 0;
-    this.queue = [];
-    this.inFlight = 0;
-
-    //
-    // Merge the options for the target Syslog server.
-    //
-    this.setOptions(options);
-
-    //
-    // Setup our Syslog and network members for later use.
-    //
-    this.socket   = null;
-    this.producer = new glossy.Produce({
-      type: this.type,
-      appName: this.appName,
-      pid: this.pid,
-      facility: this.facility
-    });
-  }
-
-  setOptions(options) {
-    this.host = options.host || 'localhost';
-    this.port = options.port || 514;
-    this.path = options.path || null;
-    this.protocol = options.protocol || 'udp4';
-    this.endOfLine = options.eol;
-
-    this.parseProtocol(this.protocol);
-
-    //
-    // Merge the default message options.
-    //
-    this.localhost = typeof options.localhost !== 'undefined' ? options.localhost : 'localhost';
-    this.type = options.type || 'BSD';
-    this.facility = options.facility || 'local0';
-    this.pid = options.pid || process.pid;
-    this.appName = options.appName || options.app_name || process.title;
-  }
-
-  parseProtocol(protocol = this.protocol) {
-    const parsedProtocol = utils.parseProtocol(protocol);
-
-    this.protocolType   = parsedProtocol.type;
-    this.protocolFamily = parsedProtocol.family;
-    this.isDgram        = parsedProtocol.isDgram;
-
-    if (this.protocolType === 'unix' && !this.path) {
-      throw new Error('`options.path` is required on unix dgram sockets.');
-    }
-  }
-
-  //
-  // ### function log (info, callback)
-  // #### @info {object} All relevant log information
-  // #### @callback {function} Continuation to respond to when complete.
-  // Core logging method exposed to Winston. Logs the `msg` and optional
-  // metadata, `meta`, to the specified `level`.
-  //
-  log(info, callback) {
-    if (!~levels.indexOf(info[LEVEL])) {
-      return callback(new Error('Cannot log unknown syslog level: ' + info[LEVEL]));
-    }
-
-    const output = info[MESSAGE];
-
-    const syslogMsg = this.producer.produce({
-      severity: info[LEVEL],
-      host: this.localhost,
-      date: new Date(),
-      message: this.endOfLine ? output + this.endOfLine : output
-    });
-
-    //
-    // Attempt to connect to the socket
-    //
-    this.connect((err) => {
-      if (err) {
-        //
-        // If there was an error enqueue the message
-        //
-        this.queue.push(syslogMsg);
-
-        return callback(err);
-      }
-
-      //
-      // On any error writing to the socket, enqueue the message
-      //
-      const onError = (logErr) => {
-        if (logErr) {
-          this.queue.push(syslogMsg);
-          this.emit('error', logErr);
-        }
-        this.emit('logged', info);
-        this.inFlight--;
-      };
-
-      const onCongestion = () => {
-        onError(new Error('Congestion Error'));
-      };
-
-      const sendDgram = () => {
-        const buffer = new Buffer(syslogMsg);
-
-        if (this.protocolType === 'udp') {
-          this.inFlight++;
-          this.socket.send(buffer, 0, buffer.length, this.port, this.host, onError);
-        } else if (this.protocol === 'unix') {
-          this.inFlight++;
-          this.socket.send(buffer, 0, buffer.length, this.path, onError);
-        } else if (this.congested) {
-          this.queue.push(syslogMsg);
-        } else {
-          this.socket.once('congestion', onCongestion);
-          this.inFlight++;
-          this.socket.send(buffer, (e) => {
-            this.socket.removeListener('congestion', onCongestion);
-            onError(e);
-          });
-        }
-      };
-
-      //
-      // Write to the `tcp*`, `udp*`, or `unix` socket.
-      //
-      if (this.isDgram) {
-        sendDgram();
-      } else {
-        this.socket.write(syslogMsg, 'utf8', onError);
-      }
-
-      callback(null, true);
-    });
-  }
-
-  //
-  // ### function close ()
-  // Closes the socket used by this transport freeing the resource.
-  //
-  close() {
-    const max = 6;
-    let attempt = 0;
-
-    const _close = () => {
-      if (attempt >= max || (this.queue.length === 0 && this.inFlight <= 0)) {
-        if (this.socket) {
-          this.socket.close();
-        }
-
-        this.emit('closed', this.socket);
-      } else {
-        attempt++;
-        setTimeout(_close, 200 * attempt);
-      }
-    };
-    _close();
-  }
-
-  connectDgram(callback) {
-    if (this.protocol === 'unix-connect') {
-      return this._unixDgramConnect(callback);
-    } else if (this.protocol === 'unix') {
-      this.socket = require('unix-dgram').createSocket('unix_dgram');
-    } else {
-      // UDP protocol
-      this.socket = new dgram.Socket(this.protocol);
-    }
-
-    return callback(null);
-  }
-  //
-  // ### function connect (callback)
-  // #### @callback {function} Continuation to respond to when complete.
-  // Connects to the remote syslog server using `dgram` or `net` depending
-  // on the `protocol` for this instance.
-  //
-  connect(callback) {
-    //
-    // If the socket already exists then respond
-    //
-    if (this.socket) {
-      return ((!this.socket.readyState) || (this.socket.readyState === 'open')) || this.socket.connected
-        ? callback(null)
-        : callback(true);
-    }
-
-    //
-    // Create the appropriate socket type.
-    //
-    if (this.isDgram) {
-      return this.connectDgram(callback);
-    }
-
-    this.socket = new net.Socket();
-    this.socket.setKeepAlive(true);
-    this.socket.setNoDelay();
-
-    this.setupEvents();
-
-    const connectConfig = {
-      host: this.host,
-      port: this.port
-    };
-
-    if (this.protocolFamily) {
-      connectConfig.family = this.protocolFamily;
-    }
-
-    this.socket.connect(connectConfig);
-
-    //
-    // Indicate to the callee that the socket is not ready. This
-    // will enqueue the current message for later.
-    //
-    callback(true);
-  }
-
-  setupEvents() {
-    const readyEvent = 'connect';
-    //
-    // On any error writing to the socket, emit the `logged` event
-    // and the `error` event.
-    //
-    const onError = (logErr) => {
-      if (logErr) { this.emit('error', logErr); }
-      this.emit('logged');
-      this.inFlight--;
-    };
-
-    //
-    // Listen to the appropriate events on the socket that
-    // was just created.
-    //
-    this.socket.on(readyEvent, () => {
-      //
-      // When the socket is ready, write the current queue
-      // to it.
-      //
-      this.socket.write(this.queue.join(''), 'utf8', onError);
-
-      this.emit('logged');
-      this.queue = [];
-      this.retries = 0;
-      this.connected = true;
-    }).on('error', function () {
-      //
-      // TODO: Pass this error back up
-      //
-    }).on('close', () => {
-      //
-      // Attempt to reconnect on lost connection(s), progressively
-      // increasing the amount of time between each try.
-      //
-      const interval = Math.pow(2, this.retries);
-      this.connected = false;
-
-      setTimeout(() => {
-        this.retries++;
-        this.socket.connect(this.port, this.host);
-      }, interval * 1000);
-    }).on('timeout', () => {
-      if (this.socket.readyState !== 'open') {
-        this.socket.destroy();
-      }
-    });
-  }
-
-  _unixDgramConnect(callback) {
-    const self = this;
-
-    const flushQueue = () => {
-      let sentMsgs = 0;
-      this.queue.forEach((msg) => {
-        const buffer = new Buffer(msg);
-
-        if (!this.congested) {
-          this.socket.send(buffer, function () {
-            ++sentMsgs;
-          });
-        }
-      });
-
-      this.queue.splice(0, sentMsgs);
-    };
-
-    this.socket = require('unix-dgram').createSocket('unix_dgram');
-    this.socket.on('error', (err) => {
-      this.emit('error', err);
-
-      if (err.syscall === 'connect') {
-        this.socket.close();
-        this.socket = null;
-        return callback(err);
-      }
-      if (err.syscall === 'send') {
-        this.socket.close();
-        this.socket = null;
-      }
-    });
-
-    this.socket.on('connect', function () {
-      this.on('congestion', () => {
-        self.congested = true;
-      });
-
-      this.on('writable', () => {
-        self.congested = false;
-        flushQueue();
-      });
-
-      flushQueue();
-      callback();
-    });
-
-    this.socket.connect(this.path);
-  }
-}
-
-//
-// Define a getter so that `winston.transports.Syslog`
-// is available and thus backwards compatible.
-//
-winston.transports.Syslog = Syslog;
-
-module.exports = {
-  Syslog
-};

package/node_modules/winston-syslog/package.json

@@ -1,56 +0,0 @@
-{
-  "name": "winston-syslog",
-  "description": "A syslog transport for winston",
-  "version": "2.1.0",
-  "author": "Charlie Robbins <charlie.robbins@gmail.com>",
-  "contributors": [
-    {
-      "name": "Squeeks",
-      "email": "privacymyass@gmail.com"
-    },
-    {
-      "name": "Mempf",
-      "email": "mempf.com@gmail.com"
-    }
-  ],
-  "repository": {
-    "type": "git",
-    "url": "http://github.com/indexzero/winston-syslog.git"
-  },
-  "keywords": [
-    "logging",
-    "sysadmin",
-    "tools",
-    "winston",
-    "syslog"
-  ],
-  "dependencies": {
-    "cycle": "^1.0.3",
-    "glossy": "^0.1.7"
-  },
-  "optionalDependencies": {
-    "unix-dgram": "^2.0.2"
-  },
-  "peerDependencies": {
-    "winston": "^3.0.0"
-  },
-  "devDependencies": {
-    "eslint-config-populist": "^4.1.0",
-    "vows": "^0.8.2",
-    "winston": "^3.0.0"
-  },
-  "main": "./lib/winston-syslog",
-  "scripts": {
-    "lint": "populist **/*.js",
-    "pretest": "npm run lint",
-    "test": "vows test/*-test.js --spec"
-  },
-  "engines": {
-    "node": ">= 4.2.2"
-  },
-  "license": "MIT"
-
-,"_resolved": "https://registry.npmjs.org/winston-syslog/-/winston-syslog-2.1.0.tgz"
-,"_integrity": "sha512-y6wHm7vd99tcpIar6fNM5Widx7Kemf2iguGLC9wty351wqQU9LewRaMraj3FvO2xPJF6P4a4BuSN3jGx/tnIqg=="
-,"_from": "winston-syslog@2.1.0"
-}