Skip to content
Commodify Your System Stats
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Stat Badger - Commodify Your Stats

badger (verb): to harass or urge persistently; pester; nag

Stat Badger is a tool to commodify system stats. It makes zero assumptions about what stats you want to gather, and zero assumptions about where you want to send those stats.

The Basics

Badger is intended to be run on every (Linux) host you could possibly want to gather stats from. It consists of the Badger Core, Modules, and Emitters. It collects metrics from all modules and emits (asynchronously) from all emitters on a 1 second interval. You can configure custom intervals on both a per-module and per-emitter basis. You can also blacklist stats at the module and emitter level. (More detail on custom intervals and blacklists in the module and emitter README files).

Out of the box, Badger can collect detailed system stats. You're provided the following:

  • Modules: cpu, load, disk, network, memory, system (for mostly-static values like disk and core counts)

  • Emitters: stdout, stdout_pretty, influxdb08, graphite, kafka

The stock file and directory structure is similar to the following (module and emitter dirs are configurable):

├── config.json
├── badger_emitters
│   ├── conf.d
│   │   ├── influxdb08_emitter.conf
│   │   └── stdout_pretty.conf
│   ├──
│   └──
└── badger_modules
    ├── conf.d
    │   ├── cpu.conf
    │   └── network.conf


Badger expects a JSON configuration file, provided via the -f command-line argument. This file can contain comment lines / blocks (//, /* ... */) See config.json as an example.

Stats Format

Badger modules present stats as an array of simple dictionary objects, which are rolled up into a larger dictionary with some additional metadata about the host. Emitters accept this larger dictionary, and can chop it up for emission in any manner they choose.

Example module output:

    {"cpu.user": {"value": 8, "units": "percent"}},
    {"cpu.ctxt_per_sec": {"value": 8, "units": ""}}

Example emitter input:

    "datacenter": "EC2",
    "region":     "us-west-1"
    "zone":       "us-west-1a",
    "cluster":    "test-cluster-01",
    "hostname":   "test-node-01",
    "ipv4":       "",
    "ipv6":       "",
    "timestamp":  1429628878,
    "points": [
        {"cpu.user": {"value": 8, "units": "percent"}},
        {"cpu.ctxt_per_sec": {"value": 8, "units": ""}}

The metadata above "points: [...]" is cobbled together by the Core and included in every payload.

Modules and Emitters

You are free (and encouraged) to define your own Modules and Emitters. You can get a pretty good idea of what it takes to create a module or emitter by looking at those that are included with Badger out of the box. For more detail, see badger_modules/ and badger_emitters/

More to Come

There are a number of things I'd like to get added / refactored in the near future. I'm certainly open to suggestions, as well!

  • More Emitters

  • InfluxDB 0.9

  • OpenTSDB

  • KairosDB

  • Druid

  • Redis

  • RabbitMQ

  • ActiveMQ

  • ZeroMQ

  • SQS

  • Avro File

  • whatever else I stumble across

  • More Modules

  • Per-process disk and network IO

  • thread stats (system-wide and per-process)

  • Docker - initially grab per-container stats by running on Docker hosts

  • Docker container stats - if possible, restrict stats gathered within a container to that particular container's relevant stats (currently, stats like cpu and memory that are collected within a container reflect system-wide Docker host stats)

  • Tests

  • I'm not a developer by trade, so I slacked and wrote code without tests. I originally started this as a fun experiment to help me wrap my head around some extra Python goodness, and it worked better than I expected. Ultimately it seemed like it might be useful to others since nothing else like it exists, so here we are. Now I need to be un-lazy and make this stuff testable (which will probably take a significant rewrite of some portions).

You can’t perform that action at this time.