winston-office365-connector-hook

A Winston transport hook to send logs over to a Office 365 Connector, e.g. Microsoft Teams channel.

Inspired by winston-slack-hook by fahad19.

Uses queue implementation by jessetane for processing transport tasks.

Install

$ npm install --save winston winston-office365-connector-hook

Requirements

• Use winston
• Get a Webhook URL by setting up an Incoming Connector for the Teams channel you wish to send the logs to.

Note that Office 365 Connector Webhook URL is tied to a given channel, so you don't need to specify a channel name separately.

Usage

Basic

1var winston = require('winston');
2var Office365ConnectorHook = require('winston-office365-connector-hook');
3
4var Logger = winston.Logger;
5var Console = winston.transports.Console;
6
7var logger = new Logger({
8  transports: [
9    new Console({}),
10    new Office365ConnectorHook({
11      hookUrl: 'https://outlook.office.com/webhook/XXXXXXXXXXXXX' // No need for a channel name
12    })
13  ]
14});
15
16logger.info('I am being logged here'); // will be sent to both console and Teams channel

Options

Require:

• hookUrl: Connector Webhook URL to post to

Optional:

• prependLevel: set to true by default, sets [level] at the beginning of the message
• appendMeta: set to true by default, sets stringified meta at the end of the message
• formatter(options): function for transforming the message before posting to Slack
• colors: use this to set custom colors to log levels. Note that you MUST use hex format, not names. e.g.

  "colors": {
     "debug": "4256f4",
     "error": "f00"
   }

Behind the scenes, the level color is sent as the themeColor property of the card.

Markdown support in messages

Channel messages support Markdown syntax. Any formatting is sent as-is to the Channel.

logger.info('# Seriously!?\n > This is cool!', { title: 'You can use Markdown in messages.' });

Setting card title

You can set a title for the card by sending it as a part of the meta hash:

logger.info('This text appears in card body.', { title: 'My puny title' });

Formatter

Messages can be formatted further before posting to the channel:

1var logger = new Logger({
2  transports: [
3    new Office365ConnectorHook({
4      hookUrl: 'https://outlook.office.com/webhook/XXXXXXXXXXXXX'
5
6      formatter: function (options) {
7        var message = options.message; // original message
8
9        // var level = options.level;
10        // var meta = options.meta;
11
12        // do something with the message
13
14        return message;
15      }
16    })
17  ]
18});

Roadmap

See here