@loglayer/plugin-sampling

A sampling plugin for LogLayer that randomly drops log entries to control log volume and cost.

Features

• Rate-based sampling: Keep a configurable percentage of log entries
• Per-level sampling: Different rates per log level
• Custom sampling: Use a callback for content-aware filtering
• Fail-safe: error and fatal default to a 100% keep rate (can be overridden via perLevel or callback)
• Fail-open: Callback exceptions keep the event (never crash)

Installation

npm install @loglayer/plugin-sampling

Quick Start

import { samplingPlugin } from "@loglayer/plugin-sampling";
import { LogLayer, ConsoleTransport } from "loglayer";

const log = new LogLayer({
  transport: new ConsoleTransport({ logger: console }),
  plugins: [
    // Keep only 10% of logs (errors/fatals default to 100%)
    samplingPlugin({ rate: 0.1 }),
  ],
});

Documentation

For more details, visit https://loglayer.dev/plugins/sampling