npm/shelby

Name: shelby

Owner: npm

Description: a system agent in rust for the numbat metrics system

Created: 2017-02-11 04:53:12.0

Updated: 2018-01-22 18:48:13.0

Pushed: 2017-07-30 17:54:17.0

Homepage:

Size: 76

Language: Rust

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

shelby

The Shelby Cobra is an iconic sportscar as well as a monitoring agent monitoring agent for your unix system, written in Rust. Sends json metrics suitable for ingestion by numbat.

Build

o build

Usage

Shelby accepts one config option, passed in via the METRICS env var. This is the location of the numbat collector to send metrics to.

ICS=tcp://127.0.0.1:1337 shelby

All metrics sent are in the following form:

ost": "example.com",
ame": "host.start",
ime": 1486585740403,
alue": 1

Plugins

memory

Sends:

alue": 0.33
ame": "host.memory"

disk_usage

Sends two metrics, one for each mount point:

ost": "example.com",
ame": "host.disk-usage./",
ime": 1486587398361,
alue": 0.8535458850761212

"host": "example.com",
"name": "host.inode-usage./",
"time": 1486587398361,
"value": 0.0009513050355418086

The value is capacity used. (Multiply by 100 if you need a percentage used.) Mount points are hard-coded right now as / and /mnt.

heartbeat

A pulse from the host; value always 1.

ost": "example.com",
ame": "host.heartbeat",
ime": 1486587398361,
alue": 1

load_average

Sends 15, 5, and 1 minute load averages.

ost": "example.com",
ame": "host.load-average.1",
ime": 1486587398362,
alue": 2.69189453125 },
ost": "example.com",
ame": "host.load-average.5",
ime": 1486587398362,
alue": 3.35546875 },
ost": "example.com",
ame": "host.load-average.15",
ime": 1486587398363,
alue": 3.2265625 }

netstat

Sends one metric for each of the following:

ets.ESTABLISHED
ets.SYN_SENT
ets.SYN_RECV
ets.FIN_WAIT1
ets.FIN_WAIT2
ets.TIME_WAIT
ets.CLOSE
ets.CLOSE_WAIT
ets.LAST_ACK
ets.LISTEN
ets.CLOSING

License

shelby is released under the MIT license. See the LICENSE file for more information.