plugeth/metrics
Péter Szilágyi be65b47645
all: update golang/x/ext and fix slice sorting fallout (#27909)
The Go authors updated golang/x/ext to change the function signature of the slices sort method. 
It's an entire shitshow now because x/ext is not tagged, so everyone's codebase just 
picked a new version that some other dep depends on, causing our code to fail building.

This PR updates the dep on our code too and does all the refactorings to follow upstream...
2023-08-12 00:04:12 +02:00
..
exp metrics: add cpu counters (#26796) 2023-03-23 14:13:50 +01:00
influxdb metrics/influxdb: use smaller dependency and reuse code between v1 and v2 reporters (#26963) 2023-03-23 15:12:32 -04:00
librato metrics/librato: ensure resp.body closed (#26969) 2023-03-27 07:44:41 -04:00
prometheus metrics: add cpu counters (#26796) 2023-03-23 14:13:50 +01:00
config.go cmd, metrics: add support for influxdb-v2 (cherry-picking from italoacasas' changes), leave existing support for v1 to maintain backwards-compatibility. (#23194) 2021-08-17 18:40:14 +02:00
counter_float64.go metrics: make gauge_float64 and counter_float64 lock free (#27025) 2023-04-04 09:53:44 -04:00
counter_float_64_test.go metrics: make gauge_float64 and counter_float64 lock free (#27025) 2023-04-04 09:53:44 -04:00
counter_test.go
counter.go metrics: use atomic type (#27121) 2023-04-20 03:36:54 -04:00
cpu_disabled.go all: add go:build lines (#23468) 2021-08-25 18:46:29 +02:00
cpu_enabled.go metrics: improve accuracy of CPU gauges (#26793) 2023-03-07 00:29:48 +01:00
cpu.go metrics: improve accuracy of CPU gauges (#26793) 2023-03-07 00:29:48 +01:00
cputime_nop.go metrics: improve accuracy of CPU gauges (#26793) 2023-03-07 00:29:48 +01:00
cputime_unix.go metrics: improve accuracy of CPU gauges (#26793) 2023-03-07 00:29:48 +01:00
debug_test.go
debug.go
disk_linux.go
disk_nop.go all: add go:build lines (#23468) 2021-08-25 18:46:29 +02:00
disk.go
doc.go
ewma_test.go
ewma.go metrics: use atomic type (#27121) 2023-04-20 03:36:54 -04:00
FORK.md
gauge_float64_test.go metrics: make gauge_float64 and counter_float64 lock free (#27025) 2023-04-04 09:53:44 -04:00
gauge_float64.go metrics: make gauge_float64 and counter_float64 lock free (#27025) 2023-04-04 09:53:44 -04:00
gauge_test.go all: fix some typos (#25551) 2022-08-19 09:00:21 +03:00
gauge.go metrics: use atomic type (#27121) 2023-04-20 03:36:54 -04:00
graphite_test.go
graphite.go metrics: add cpu counters (#26796) 2023-03-23 14:13:50 +01:00
healthcheck.go
histogram_test.go
histogram.go eth/protocols, metrics, p2p: add handler performance metrics 2021-03-26 14:00:06 +02:00
init_test.go
json_test.go
json.go
LICENSE
log.go metrics: add cpu counters (#26796) 2023-03-23 14:13:50 +01:00
memory.md
meter_test.go metrics: zero temp variable in updateMeter (#21470) 2020-08-21 11:04:36 +03:00
meter.go metrics: use atomic type (#27121) 2023-04-20 03:36:54 -04:00
metrics_test.go metrics: add cpu counters (#26796) 2023-03-23 14:13:50 +01:00
metrics.go metrics: add cpu counters (#26796) 2023-03-23 14:13:50 +01:00
opentsdb_test.go
opentsdb.go metrics: add cpu counters (#26796) 2023-03-23 14:13:50 +01:00
README.md
registry_test.go metrics: use sync.map in registry (#27159) 2023-05-11 05:39:13 -04:00
registry.go metrics: use sync.map in registry (#27159) 2023-05-11 05:39:13 -04:00
resetting_sample.go eth/protocols, metrics: use resetting histograms for rare packets 2021-03-26 16:14:12 +02:00
resetting_timer_test.go
resetting_timer.go metrics: NilResettingTimer.Time should execute the timed function (#27724) 2023-07-14 19:19:03 +02:00
runtimehistogram_test.go metrics: improve reading Go runtime metrics (#25886) 2022-11-11 13:16:13 +01:00
runtimehistogram.go metrics: improve reading Go runtime metrics (#25886) 2022-11-11 13:16:13 +01:00
sample_test.go all: remove deprecated uses of math.rand (#26710) 2023-02-16 14:36:58 -05:00
sample.go metrics: use slices package for sorting (#27493) 2023-06-19 08:53:15 +02:00
syslog.go metrics: add cpu counters (#26796) 2023-03-23 14:13:50 +01:00
timer_test.go
timer.go metrics: NilTimer should still run the function to be timed (#27723) 2023-07-14 18:10:16 +02:00
validate.sh
writer_test.go all: update golang/x/ext and fix slice sorting fallout (#27909) 2023-08-12 00:04:12 +02:00
writer.go all: update golang/x/ext and fix slice sorting fallout (#27909) 2023-08-12 00:04:12 +02:00

go-metrics

travis build status

Go port of Coda Hale's Metrics library: https://github.com/dropwizard/metrics.

Documentation: https://godoc.org/github.com/rcrowley/go-metrics.

Usage

Create and update metrics:

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

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

r := NewRegistry()
g := metrics.NewRegisteredFunctionalGauge("cache-evictions", r, func() int64 { return cache.getEvictionsCount() })

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)

Register() is not threadsafe. For threadsafe metric registration use GetOrRegister:

t := metrics.GetOrRegisterTimer("account.create.latency", nil)
t.Time(func() {})
t.Update(47)

NOTE: Be sure to unregister short-lived meters and timers otherwise they will leak memory:

// Will call Stop() on the Meter to allow for garbage collection
metrics.Unregister("quux")
// Or similarly for a Timer that embeds a Meter
metrics.Unregister("bang")

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 "github.com/cyberdelia/go-metrics-graphite"

addr, _ := net.ResolveTCPAddr("tcp", "127.0.0.1:2003")
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 "github.com/vrischmann/go-metrics-influxdb"

go influxdb.InfluxDB(metrics.DefaultRegistry,
  10e9, 
  "127.0.0.1:8086", 
  "database-name", 
  "username", 
  "password"
)

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 "github.com/mihasya/go-metrics-librato"

go librato.Librato(metrics.DefaultRegistry,
    10e9,                  // interval
    "example@example.com", // 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 "github.com/rcrowley/go-metrics/stathat"

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

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 "github.com/rcrowley/go-metrics/exp"

exp.Exp(metrics.DefaultRegistry)

Installation

go get github.com/rcrowley/go-metrics

StatHat support additionally requires their Go client:

go get github.com/stathat/go

Publishing Metrics

Clients are available for the following destinations: