Transports

Configure multiple log destinations

ConsoleTransport

Output logs to the console with colors and formatting

Configuration

new ConsoleTransport({
  level: 'debug',
  colors: true,
  structured: false,
})

Color-coded levelsPretty printingJSON mode for prod

HTTPTransport

Send logs to any HTTP endpoint with batching

Configuration

new HTTPTransport({
  endpoint: 'https://logs.example.com/ingest',
  batchSize: 100,
  flushInterval: 5000,
  headers: { 'Authorization': 'Bearer ${API_KEY}' },
})

Batch processingRetry with backoffCustom headers

FileTransport

Write logs to files with rotation and compression

Configuration

new FileTransport({
  filename: './logs/app.log',
  maxSize: '10mb',
  maxFiles: 5,
  compress: true,
})

Log rotationGzip compressionSize limits

DatadogTransport

Send logs directly to Datadog Log Management

Configuration

new DatadogTransport({
  apiKey: process.env.DD_API_KEY,
  service: 'my-app',
  source: 'nodejs',
  tags: ['env:production'],
})

Datadog integrationAutomatic taggingSource mapping

SentryTransport

Send errors and logs to Sentry for monitoring

Configuration

new SentryTransport({
  dsn: process.env.SENTRY_DSN,
  environment: 'production',
  release: '1.0.0',
  minLevel: 'warn',
})

Error trackingStack tracesLevel filtering

Multi-Transport Configuration

import {
  createLogger,
  ConsoleTransport,
  HTTPTransport,
  FileTransport,
  SentryTransport,
} from 'vestig'

const log = createLogger({
  level: 'debug',
  transports: [
    // Console for development
    new ConsoleTransport({
      enabled: process.env.NODE_ENV !== 'production',
      colors: true,
    }),

    // HTTP for log aggregation service
    new HTTPTransport({
      endpoint: process.env.LOG_ENDPOINT,
      batchSize: 50,
    }),

    // File for local persistence
    new FileTransport({
      filename: './logs/app.log',
      maxSize: '50mb',
    }),

    // Sentry for error monitoring (warn+ only)
    new SentryTransport({
      dsn: process.env.SENTRY_DSN,
      minLevel: 'warn',
    }),
  ],
})

// All transports receive every log
log.info('Application started', { version: '1.0.0' })

Common Transport Options

level — Minimum log level

enabled — Toggle transport on/off

filter — Custom filter function

batchSize — Logs per batch

flushInterval — Auto-flush timing

maxRetries — Retry attempts

Key Features

›

Multiple Destinations — Send logs to console, files, HTTP, and Datadog

›

Batch Processing — Efficient batching with configurable size

›

Retry Logic — Automatic retries with exponential backoff

›

Custom Transports — Extend BatchTransport to create your own

Multi-Transport Configuration

import {
  createLogger,
  ConsoleTransport,
  HTTPTransport,
  FileTransport,
  SentryTransport,
} from 'vestig'

const log = createLogger({
  level: 'debug',
  transports: [
    // Console for development
    new ConsoleTransport({
      enabled: process.env.NODE_ENV !== 'production',
      colors: true,
    }),

    // HTTP for log aggregation service
    new HTTPTransport({
      endpoint: process.env.LOG_ENDPOINT,
      batchSize: 50,
    }),

    // File for local persistence
    new FileTransport({
      filename: './logs/app.log',
      maxSize: '50mb',
    }),

    // Sentry for error monitoring (warn+ only)
    new SentryTransport({
      dsn: process.env.SENTRY_DSN,
      minLevel: 'warn',
    }),
  ],
})

// All transports receive every log
log.info('Application started', { version: '1.0.0' })