@datalust/winston-seq

winston-seq

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

Getting started

Add the @datalust/winston-seq winston and winston packages to your package.json, and configure winston with a SeqTransport:

import winston from 'winston';
import { SeqTransport } from '@datalust/winston-seq';

const logger = winston.createLogger({
  level: 'info',
  format: winston.format.combine(  /* This is required to get errors to log with stack traces. See https://github.com/winstonjs/winston/issues/1498 */
    winston.format.errors({ stack: true }),
    winston.format.json(),
  ),
  defaultMeta: { /* application: 'your-app-name' */ },
  transports: [
    new winston.transports.Console({
        format: winston.format.simple(),
    }),
    new SeqTransport({
      serverUrl: "https://your-seq-server:5341",
      apiKey: "your-api-key",
      onError: (e => { console.error(e) }),
      handleExceptions: true,
      handleRejections: true,
    })
  ]
});

• 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:

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

Attach context by creating child loggers:

const taskLogger = logger.child({ activity: "purchase" });
taskLogger.debug(
    "User {user} purchase product {product} at ${price}", 
    {
        user: "Millie Gilbert",
        product: "Yardtime Garden Shears",
        price: 29.99
    });