winston-seq

A Winston v3 transport that sends structured logs to the Seq log server.

Install @datalust/winston-seq

1$ npm install @datalust/winston-seq winston
2# Or with yarn
3$ yarn add @datalust/winston-seq winston

Configure Logging

1const winston = require('winston');
2const { SeqTransport } = require('@datalust/winston-seq');
3// or import { SeqTransport } from '@datalust/winston-seq';
4
5const logger = winston.createLogger({
6  level: 'info',
7  format: winston.format.combine(  /* This is required to get errors to log with stack traces. See https://github.com/winstonjs/winston/issues/1498 */
8    winston.format.errors({ stack: true }),
9    winston.format.json(),
10  ),
11  defaultMeta: { /* application: 'your-app-name' */ },
12  transports: [
13    new winston.transports.Console({
14        format: winston.format.simple(),
15    }),
16    new SeqTransport({
17      serverUrl: "https://your-seq-server:5341",
18      apiKey: "your-api-key",
19      onError: (e => { console.error(e) }),
20      handleExceptions: true,
21      handleRejections: true,
22    })
23  ]
24});

• serverUrl - the URL for your Seq server's ingestion
• apiKey - (optional) The Seq API Key to use
• onError - Callback to execute when an error occurs within the transport
• handleExceptions - (optional) Send an event when an uncaught exception occurs
• handleRejections - (optional) Send an event when an unhandled promise rejection occurs

Send Log Events

Send structured log events, with properties that can be used later for filtering and analysis:

1logger.info("Hello {name}", {name: "World"});

Attach context by creating child loggers:

1const taskLogger = logger.child({ activity: "purchase" });
2taskLogger.debug(
3    "User {user} purchase product {product} at ${price}", 
4    {
5        user: "Millie Gilbert",
6        product: "Yardtime Garden Shears",
7        price: 29.99
8    });

Contributing

Install Yarn if you don't already have it. Next, add a .env file with content like:

SEQ_INGESTION_URL=http://192.168.98.99:5341
SEQ_API_URL=http://192.168.98.99
SEQ_API_KEY=fsf7sa9f9sf7s9df7

Where SEQ_INGESTION_URL is the ingestion address of a test Seq server, SEQ_API_URL is the API address of the test server and SEQ_API_KEY is an API key with the Ingest and Read permissions.

Scripts

• To build:

$ yarn build

• To test:

$ yarn test

NB. One test will fail if the Seq server is configured to require an API key.

• Calculate test coverage:

$ yarn test:coverage

• Lint source

$ yarn lint