golang-github-raintank-met-dev 0.0~git20161103.0.05a94bb-2 / usr / share / gocode / src / github.com / raintank / met / dogstatsd / init.go

// a metrics class that uses dogstatsd on the backend

// note that on creation, we automatically send a default value so that:
// * influxdb doesn't complain when queried for series that don't exist yet, which breaks graphs in grafana
// * the series show up in your monitoring tool of choice, so you can easily do alerting rules, build dashes etc
// without having to wait for data. some series would otherwise only be created when things go badly wrong etc.
// note that for gauges and timers this can create inaccuracies because the true values are hard to predict,
// but it's worth the trade-off.
// (for count 0 is harmless and accurate)

package dogstatsd

import "github.com/DataDog/datadog-go/statsd"

type Backend struct {
	client *statsd.Client
}

// note: library does not auto-add ending dot to prefix, specify it if you want it
func New(addr, prefix string, tags []string) (Backend, error) {
	client, err := statsd.New(addr)
	if err == nil {
		client.Namespace = prefix
		client.Tags = tags
	}
	return Backend{client}, err
}