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 (
	"github.com/quipo/statsd"
)

func main() {
	// init
	prefix := "myproject."
	statsdclient := statsd.NewStatsdClient("localhost:8125", prefix)
	statsdclient.CreateSocket()
	stats := statsd.NewStatsdBuffer(interval, statsdclient)
	defer stats.Close()

	// not buffered: send immediately
	statsdclient.Incr("mymetric", 4)

	// buffered: aggregate in memory before flushing
	stats.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