Send email on bunyan log record.

This module is cheap way to send email on bunyan log record using nodemailer.

Here is a simple example to send 'fatal' level log messages to [email protected] via gmail's SMTP service.

var bunyan = require('bunyan');
var EmailStream = require('bunyan-emailstream').EmailStream;

var emailStream = new EmailStream(
  // Nodemailer mailOptions
  { from: '[email protected]',
    to: '[email protected]'
  },
  // Nodemailer transporter
  { service: 'gmail',
    auth: {
      user: 'username',
      pass: 'password'
    }
  }
);

var myLogger = bunyan.createLogger({
    name: 'SleepBreaker',
    streams: [{
        type: 'raw', // You should use EmailStream with 'raw' type!
        stream: emailStream,
        level: 'fatal',
    }
        // Some other streams you want
    ]
});

myLogger.fatal(new Error('No sweet sleep anymore'), 'Something bad happened');

Above will send email like this

X-Mailer: Nodemailer (0.6.0; +http://github.com/andris9/nodemailer; stub)
Date: Thu, 06 Feb 2014 09:14:00 GMT
Message-Id: <[email protected]>
To: [email protected]
Subject: [FATAL] SleepBreaker/33973 on localhost.local
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0

* name: SleepBreaker
* hostname: localhost.local
* pid: 33973
* time: Thu Feb 06 2014 16:59:12 GMT+0900 (JST)
* msg: Something bad happened
* err.stack: Error: No sweet sleep anymore
    at Object.<anonymous> (/Somewhere/Of/Code/badass.js:19:16)
    ...
    at node.js:902:3

npm install bunyan-emailstream

Include the module

var EmailStream = require('bunyan-emailstream').EmailStream;

Create stream instance

var emailStream = new EmailStream(mailOptions, transporter);

Where,

• mailOptions is options of composing email message. See mailOptions for more detail.
• transporter is one for nodemailer's avalible transports. Refer transporter section for detailed options.

Pass to bunyan logger as a 'raw' type stream

bunyan.createLogger({
    streams: [{
        type: 'raw', // You should use EmailStream with 'raw' type!
        stream: emailStream,
        level: 'fatal', // I bet you don't want to set 'debug' level
    }
);

Email will be sent on log level you set. Below is an example of setting sending email on uncaught exception.

process.on('uncaughtException', function (err) {
    logger.fatal(err, 'Something bas happened');
    process.exit(1);
});

mailOptions will be passed to nodemail.transport.sendMail() when log record comes via EmailStream#write. You may need to specify body type in the mailOptions.

• bodyType: (optional) sets how email was rendered on client. One of 'text' or 'html'. Default is 'text'. bodyType property will be extracted from the object and used as property name of email body.

See nodemailer document for full list of options.

transporter is argument for modemailer.createTransport(), one for nodemailer's avalible transports, or plain object (creates SMTP transport). When omitted SMTP direct transport will be used by default.

See nodemailer document for available transports and full list of options.

This event will be emitted on callback of nodemailer.transport.sendMail(). The arguments passed to event listeners are identical to responseStatus object described at nodemailer document

In addition to any possible case of stream's error event, the error event will be emitted when nodemailer.transport.sendMail callback with error.

EmailStream#formatBody will be called in order to format body text. You may set custom formatter on module's exported formatBody or instance's method formatBody.

You can set your own formatter like this:

// Setting custom formatter on EmailStream instance.
emailStream.formatBody = function (log) {
    // log is bunyan log record object

    var rows = [];
    rows.push('* name: ' + log.name);
    rows.push('* hostname: ' + log.hostname);
    rows.push('* pid: ' + log.pid);
    rows.push('* time: ' + log.time);

    if (log.msg) {
        rows.push('* msg: ' + log.msg);
    }

    if (log.err) {
        rows.push('* err.stack: ' + log.err.stack);
    }

    return rows.join('\n');
});

Just like formatting body EmailStream#formatSubject will be called in order to format subject text.

You can set your own formatter like this:

// Setting custom formatter on EmailStream instance.
emailStream.formatSubject = function (log) {
    // log is bunyan log record object

    return util.format(
        '[%s] %s/%s on %s',
        levelName(log.level),
        log.name,
        log.pid,
        log.hostname
    );
});

• Source code will explain much more.
• Create some issue to poke me.

MIT license.