dogstatsd

A small, idiomatic Clojure wrapper over the official Datadog java-dogstatsd-client for sending DogStatsD metrics, events, and service checks to a Datadog Agent.

Stack

Why

The existing Clojure DogStatsD libraries are abandoned and roll their own UDP socket. This one is a thin layer over Datadog's own actively-maintained Java client, so you get UDS support, client-side aggregation, telemetry, and origin detection for free - with a Clojure-shaped API.

Installation

Leiningen (project.clj):

[net.clojars.savya/dogstatsd "0.1.2"]

tools.deps (deps.edn):

net.clojars.savya/dogstatsd {:mvn/version "0.1.2"}

Usage

(require '[dogstatsd.core :as dd])

;; Build a client (Closeable). Defaults to localhost:8125.
(def statsd
  (dd/client {:prefix "myapp"
              :constant-tags {:env "prod" :service "api"}}))

(dd/increment statsd :page.views)
(dd/increment statsd :page.views {:page "home"})
(dd/count     statsd :jobs.processed 5)
(dd/gauge     statsd :queue.depth 42)
(dd/histogram statsd :response.size 2048)
(dd/distribution statsd :request.latency 12.5)
(dd/timing    statsd :db.query 150)            ; milliseconds
(dd/set-metric statsd :users.active "user-123")

;; Tags: a map {:k "v"} -> k:v, or a seq of strings ["k:v" ...].
(dd/gauge statsd :temperature 20 {:region "eu" :unit "c"})

;; Events and service checks.
(dd/event statsd "Deploy" "v1.2.3 shipped" {:alert-type :success
                                            :tags {:version "1.2.3"}})
(dd/service-check statsd "api.healthy" :ok {:message "all good"})

;; Closeable: prefer with-open for short-lived clients.
(with-open [c (dd/client {:host "localhost" :port 8125})]
  (dd/increment c :ping))

A Datadog Agent must be listening for DogStatsD packets (UDP 8125 by default).

API

fn	DogStatsD type
increment / decrement	counter ±1
count	counter by delta
gauge	gauge
histogram	histogram
distribution	distribution
timing	timer (ms)
set-metric	set
event	event
service-check	service check

Each metric fn takes the client, a metric name (keyword or string), an optional value, and optional tags.

License

Copyright © 2026 Savyasachi

Distributed under the Eclipse Public License 2.0.