Tracks sum, count, and average for any arbitrary metrics that you send to it.

Download the binary for your platform from the bin directory to the location where you want it to store data, then run it as an unpriviledged user. It will run on port 8080 by default.

List metrics that are currently being tracked

Get a JSON representation of all samples currently being tracked for this metric

Get a PNG representation of this metric, where operation is "sum", "count", or "avg"

Send metrics to be tracked. Any unrecognized metrics will be created automatically. The API format is as follows:

{
    "metric.name": {
        "count": 100,
        "value": 86753.09
    }
}

Multiple metrics can be sent in a single request, and you can aggregate upstream by including a count in your request. Count is optional, and will default to 1.

If you no longer wish to track a metric, stop the server, delete its datafile in the data directory, then restart the server.

Assuming you install counter to /opt/counter on Ubuntu, you can download the counter.example.service and run the following:

sudo mv counter.example.service /lib/systemd/system/counter.service
sudo systemctl start counter