gollector

README

Gollector

Gollector is a metrics collector that emits JSON responses, which can be consumed by monitoring systems such as Circonus. The flexibility of the JSON responses leads to many monitoring possibilities, such as the included 'gstat', which is an n-host iostat-alike for all metrics gollector is collecting.

Here's a graph generated in Circonus from data provided by Gollector:

Most of the built-in collectors are linux-only for now, and probably the future unless pull requests happen. Many plugins very likely require a 3.0 or later kernel release due to dependence on system structs and other deep voodoo.

Gollector does not need to be run as root to collect its metrics.

Unlike other collectors that use fat tools like netstat and df which can take expensive resources on loaded systems, Gollector opts to use the C interfaces directly when it can. This allows it to keep a very small footprint; with the go runtime, it clocks in just above 5M resident and unnoticeable CPU usage at the time of writing. The agent can sustain over 8000qps with a benchmarking tool like wrk, so it will be plenty fine getting hit once per minute, or even once per second.

Quick Start

In the gollector directory on a Linux machine with kernel 3.0 or better:

$ make
$ ./gollector generate > gollector.json
$ ./gollector gollector.json &
$ ./gstat -hosts localhost -metric "load_average"

Should yield an array of floats that contain your current load average.

$ curl http://gollector:gollector@localhost:8000/

Will yield a json object of all current metrics.

Wiki

Our wiki contains tons of information on advanced configuration, usage, and even tools you can use with Gollector. Check it out!

License

• MIT (C) 2013 Erik Hollensbe