mirror of
https://github.com/etcd-io/etcd.git
synced 2024-09-27 06:25:44 +00:00
13b6c1e684
for i in github.com/BurntSushi/toml github.com/coreos/go-etcd/etcd github.com/coreos/go-log/log github.com/gorilla/context github.com/rcrowley/go-metrics bitbucket.org/kardianos/osext github.com/coreos/go-systemd/journal github.com/coreos/raft code.google.com/p/goprotobuf/proto ; do goven -copy -rewrite $i; done
77 lines
1.5 KiB
Markdown
77 lines
1.5 KiB
Markdown
go-metrics
|
|
==========
|
|
|
|
Go port of Coda Hale's Metrics library: <https://github.com/codahale/metrics>.
|
|
|
|
Documentation: <http://godoc.org/github.com/rcrowley/go-metrics>.
|
|
|
|
Usage
|
|
-----
|
|
|
|
Create and update metrics:
|
|
|
|
```go
|
|
c := metrics.NewCounter()
|
|
metrics.Register("foo", c)
|
|
c.Inc(47)
|
|
|
|
g := metrics.NewGauge()
|
|
metrics.Register("bar", g)
|
|
g.Update(47)
|
|
|
|
s := metrics.NewExpDecaySample(1028, 0.015) // or metrics.NewUniformSample(1028)
|
|
h := metrics.NewHistogram(s)
|
|
metrics.Register("baz", h)
|
|
h.Update(47)
|
|
|
|
m := metrics.NewMeter()
|
|
metrics.Register("quux", m)
|
|
m.Mark(47)
|
|
|
|
t := metrics.NewTimer()
|
|
metrics.Register("bang", t)
|
|
t.Time(func() {})
|
|
t.Update(47)
|
|
```
|
|
|
|
Periodically log every metric in human-readable form to standard error:
|
|
|
|
```go
|
|
go metrics.Log(metrics.DefaultRegistry, 60e9, log.New(os.Stderr, "metrics: ", log.Lmicroseconds))
|
|
```
|
|
|
|
Periodically log every metric in slightly-more-parseable form to syslog:
|
|
|
|
```go
|
|
w, _ := syslog.Dial("unixgram", "/dev/log", syslog.LOG_INFO, "metrics")
|
|
go metrics.Syslog(metrics.DefaultRegistry, 60e9, w)
|
|
```
|
|
|
|
Periodically emit every metric to Graphite:
|
|
|
|
```go
|
|
addr, _ := net.ResolveTCPAddr("tcp", "127.0.0.1:2003")
|
|
go metrics.Graphite(metrics.DefaultRegistry, 10e9, "metrics", addr)
|
|
```
|
|
|
|
Periodically emit every metric to StatHat:
|
|
|
|
```go
|
|
import "github.com/rcrowley/go-metrics/stathat"
|
|
|
|
stathat.Stathat(metrics.DefaultRegistry, 10e9, "example@example.com")
|
|
```
|
|
|
|
Installation
|
|
------------
|
|
|
|
```sh
|
|
go get github.com/rcrowley/go-metrics
|
|
```
|
|
|
|
StatHat support additionally requires their Go client:
|
|
|
|
```sh
|
|
go get github.com/stathat/go
|
|
```
|