com.unbounce.dogstatsd.core — com.unbounce/clojure-dogstatsd-client 0.5.0

decrement clj

(decrement metric)

(decrement metric {:keys [tags sample-rate]})

event clj

(event {:keys [title text timestamp hostname aggregation-key priority
               source-type-name alert-type]}
       tags)

Records an Event.

This is a datadog extension, and may not work with other servers.

See http://docs.datadoghq.com/guides/dogstatsd/#events-1

Note: :date can either be inst? or msecs :priority can be either :normal or :low

gauge clj

(gauge metric value)

(gauge metric value {:keys [sample-rate tags]})

histogram clj

(histogram metric value)

(histogram metric value {:keys [sample-rate tags]})

increment clj

(increment metric)

(increment metric {:keys [tags sample-rate]})

service-check clj

(service-check {:keys [name status hostname message check-run-id timestamp]}
               tags)

Records a ServiceCheck. This is a datadog extension, and may not work with other servers.

See https://docs.datadoghq.com/agent/agent_checks/#sending-service-checks

At minimum, the name and status is required in the payload.

set-value clj

(set-value metric value {:keys [tags]})

setup! clj

(setup! & {:keys [host port prefix tags once?]})

Sets up the statsd client.

By default, assumes localhost and port 8125. You can change the host and port with:

(setup! :host "some-other-host" :port 1234)

To setup the client once and avoid reloading it, use :once?

(setup! :once? true)

shutdown! clj

(shutdown!)

Cleanly stops the statsd client.

May throw an exception if the socket cannot be closed.

str-array clj

(str-array tags)

time! clj macro

(time! [metric opts] & body)

Times the body and records the execution time (in msecs) as a histogram.

Takes opts is a map of :sample-rate and :tags to apply to the histogram

Examples:

(statsd/time! ["my.metric"] (Thread/sleep 1000))

(statsd/time! ["my.metric.with.tags" {:tags #{"foo" :sample-rate 0.3}}] (Thread/sleep 1000))