Go port of Coda Hale's Metrics library

go get



travis build status

Go port of Coda Hale's Metrics library:



Create and update metrics:

c := metrics.NewCounter()
metrics.Register("foo", c)

g := metrics.NewGauge()
metrics.Register("bar", g)

s := metrics.NewExpDecaySample(1028, 0.015) // or metrics.NewUniformSample(1028)
h := metrics.NewHistogram(s)
metrics.Register("baz", h)

m := metrics.NewMeter()
metrics.Register("quux", m)

t := metrics.NewTimer()
metrics.Register("bang", t)
t.Time(func() {})

Periodically log every metric in human-readable form to standard error:

go metrics.Log(metrics.DefaultRegistry, 5 * time.Second, log.New(os.Stderr, "metrics: ", log.Lmicroseconds))

Periodically log every metric in slightly-more-parseable form to syslog:

w, _ := syslog.Dial("unixgram", "/dev/log", syslog.LOG_INFO, "metrics")
go metrics.Syslog(metrics.DefaultRegistry, 60e9, w)

Periodically emit every metric to Graphite using the Graphite client:

import ""

addr, _ := net.ResolveTCPAddr("tcp", "")
go graphite.Graphite(metrics.DefaultRegistry, 10e9, "metrics", addr)

Periodically emit every metric into InfluxDB:

NOTE: this has been pulled out of the library due to constant fluctuations in the InfluxDB API. In fact, all client libraries are on their way out. see issues #121 and #124 for progress and details.

import ""

go influxdb.Influxdb(metrics.DefaultRegistry, 10e9, &influxdb.Config{
    Host:     "",
    Database: "metrics",
    Username: "test",
    Password: "test",

Periodically upload every metric to Librato using the Librato client:

Note: the client included with this repository under the librato package has been deprecated and moved to the repository linked above.

import ""

go librato.Librato(metrics.DefaultRegistry,
    10e9,                  // interval
    "", // account owner email address
    "token",               // Librato API token
    "hostname",            // source
    []float64{0.95},       // percentiles to send
    time.Millisecond,      // time unit

Periodically emit every metric to StatHat:

import ""

go stathat.Stathat(metrics.DefaultRegistry, 10e9, "")

Maintain all metrics along with expvars at /debug/metrics:

This uses the same mechanism as the official expvar but exposed under /debug/metrics, which shows a json representation of all your usual expvars as well as all your go-metrics.

import ""



go get

StatHat support additionally requires their Go client:

go get

Publishing Metrics

Clients are available for the following destinations: