hot-shots (StatsD) mixin for LogLayer


Adds StatsD metrics functionality to the LogLayer logging library using hot-shots.

The mixin provides a fluent builder API for sending metrics to StatsD, DogStatsD, and Telegraf through a stats property on LogLayer instances. See the hot-shots documentation for detailed usage information about available methods and options.

Installation

``bash
npm install loglayer @loglayer/mixin-hot-shots hot-shots
`

`bash
yarn add loglayer @loglayer/mixin-hot-shots hot-shots
`

`bash
pnpm add loglayer @loglayer/mixin-hot-shots hot-shots
`

Usage

`typescript
import { LogLayer, useLogLayerMixin, ConsoleTransport } from 'loglayer';
import { StatsD } from 'hot-shots';
import { hotshotsMixin } from '@loglayer/mixin-hot-shots';

// Create a StatsD client
const statsd = new StatsD({
host: 'localhost',
port: 8125
});

// Register the mixin (must be called before creating LogLayer instances)
useLogLayerMixin(hotshotsMixin(statsd));

// Create LogLayer instance
const log = new LogLayer({
transport: new ConsoleTransport({
logger: console
})
});

// Use StatsD methods through the stats property
log.stats.increment('request.count').send();
log.stats.decrement('request.count').send();
log.stats.timing('request.duration', 150).send();
log.stats.gauge('active.connections', 42).send();

// Use builder pattern for advanced configuration
log.stats.increment('request.count')
.withValue(5)
.withTags(['env:production', 'service:api'])
.withSampleRate(0.5)
.send();
``

Documentation

For more details, visit https://loglayer.dev/mixins/hot-shots.