@jennifer/statsd

A Jennifer deck that pushes metrics to a StatsD agent (StatsD, Datadog's DogStatsD, Telegraf) over UDP: counters, gauges, timings and sets, with sample rates, DogStatsD tags and batching. Fire-and-forget: a metric is one datagram and never blocks the program.

It was Jennifer's bundled statsd.j module until 0.27; the surface is the same, so moving over changes only the import:

import "@jennifer/statsd/" as statsd;   # was: import "statsd.j" as statsd;

Documentation

Install

jvc add @jennifer/statsd

This vendors the deck to vendor/<scope>/statsd/. Without jvc, unpack the src/ subtree of a release archive (<scope>-statsd-<version>.tar.gz) there.

Usage

import "@jennifer/statsd/" as statsd;

def c as statsd.Client init statsd.clientWith("127.0.0.1:8125", "web");
statsd.increment($c, "requests");
statsd.timing($c, "response", 42);
statsd.close($c);

Requirements

Jennifer 0.25.0 or newer, the default jennifer binary (net), not jennifer-tiny.

Development

tools/check-all.sh                   # the full gate, as CI runs it
jennifer test src/statsd_test.j      # the test overlay
tools/check-docs.sh                  # docs against the code
tools/pack.sh dist                   # build the release archive

Licence

LGPL-3.0-only, see LICENSE. Copyright (C) 2026 mplx <[email protected]>.

tools/check-headers.sh checks every source file's SPDX header against deck.toml.