Backstop is a simple endpoint for submitting metrics to Graphite. It accepts JSON data via HTTP POST and proxies the data to one or more Carbon/Graphite listeners.
Backstop supports submission of metrics via the Collectd write_http output plugin. A sample client configuration:
<Plugin write_http>
<URL "https://backstop.example.com/collectd">
Format "JSON"
User ""
Password ""
</URL>
</Plugin>
Use the /publish endpoint in conjunction with one of the approved PREFIXES for submitting metrics to Backstop. In most environments it makes sense to use distinct prefixes for normal (e.g. gauge, counters, etc) metrics vs annotation (event-style) metrics.
Here is a basic example for posting an application metric to the custom prefix.
RestClient.post("https://backstop.example.com/publish/custom",
[{:metric => key, :value => value, :measure_time => Time.now.to_i}].to_json)Here is an example for posting a software release announcement to the note prefix.
RestClient.post("https://backstop.example.com/publish/note",
[{:metric => "foobar.release", :value => "v214", :measure_time => Time.now.to_i}].to_json)$ export CARBON_URLS=...
$ export PREFIXES=...
$ foreman start$ heroku create -s cedar
$ heroku config:add CARBON_URLS=...
$ heroku config:add PREFIXES=...
$ git push heroku masterBackstop is distributed under a 3-clause BSD license.
Thanks to Michael Gorsuch (@gorsuch) for his work on the collectd parser and the "Mitt" application that preceded Backstop.