clj-statsd is a client for the statsd protocol for the clojure programming language.
Here is a snippet showing the use of clj-statsd:
(ns testing (:require [clj-statsd :as s])) (s/setup "127.0.0.1" 8125) ;; Set a shared prefix for all stats keys (s/setup "127.0.0.1" 8125 :prefix :my-app) (s/increment :some_counter) ;; simple increment (s/decrement "some_other_counter") ;; simple decrement (s/increment :some_counter 2) ;; double increment (s/increment :some_counter 2 0.1) ;; sampled double increment (s/timing :timing_value 300) ;; record 300ms for "timing_value" (s/gauge :current_value 42) ;; record an arbitrary value (s/modify-gauge :current_value -2) ;; offset a gauge (s/with-timing :some_slow_code ;; time (some-slow-code) and then (some-slow-code)) ;; send the result using s/timing (s/with-sampled-timing :slow_code 1.0 ;; Like s/with-timing but with (slow-code) ;; a sample rate. (s/with-tagged-timing :slow 1.0 ["foo"] ;; Like s/with-timing but with (slow) ;; a sample rate and tags.Buckets can be strings or keywords. For more information please refer to statsd
Since clj-statsd uses agents, (shutdown-agents) must be called when exiting the program.