Go Client library for StatsD. Contains a direct and a buffered client. The buffered version will hold and aggregate values for the same key in memory before flushing them at the defined frequency.
This client library was inspired by the one embedded in the Bit.ly NSQ project, and extended to support some extra custom events used at DataSift.
go get github.com/quipo/statsd
- Increment - Count occurrences per second/minute of a specific event
- Decrement - Count occurrences per second/minute of a specific event
- Timing - To track a duration event
- Gauge - Gauges are a constant data type. They are not subject to averaging, and they don’t change unless you change them. That is, once you set a gauge value, it will be a flat line on the graph until you change it again
- Absolute - Absolute-valued metric (not averaged/aggregated)
- Total - Continously increasing value, e.g. read operations since boot
package main
import (
"log""os""time""github.com/quipo/statsd"
)
funcmain() {
// initprefix:="myproject."statsdclient:=statsd.NewStatsdClient("localhost:8125", prefix)
err:=statsdclient.CreateSocket()
ifnil!=err {
log.Println(err)
os.Exit(1)
}
interval:=time.Second*2// aggregate stats and flush every 2 secondsstats:=statsd.NewStatsdBuffer(interval, statsdclient)
deferstats.Close()
// not buffered: send immediatelystatsdclient.Incr("mymetric", 4)
// buffered: aggregate in memory before flushingstats.Incr("mymetric", 1)
stats.Incr("mymetric", 3)
stats.Incr("mymetric", 1)
stats.Incr("mymetric", 1)
}The string "%HOST%" in the metric name will automatically be replaced with the hostname of the server the event is sent from.
Lorenzo Alberton
- Web: http://alberton.info
- Twitter: @lorenzoalberton
- Linkedin: /in/lorenzoalberton
See LICENSE document
