StatsD Bosun publisher backend

Overview

This is a pluggable backend for StatsD, which publishes stats to Bosun. It is based off statsd-influxdb-backend and statsd-opentsdb-backend.

Installation

Copy lib/bosun.js to your statsd backends directory

Configuration

The backend will read the configuration options from the following 'bosun' hash defined in the main statsd config file:

bosun: {
  host: '127.0.0.1',   // Bosun host. (default 127.0.0.1)
  port: 8087,          // Bosun port. (default 8087)
  ssl: false,          // Bosun is hosted over SSL. (default false)
  tagPrefix: '_t_'     // Tag prefix for metrics that include tags
}

Tag support

This backend allows you to attach tags to your metrics. To add a counter called users and tag the data foo=bar, you'd write the following to statsd:

users._t_foo.bar:261|c

Notes

• Bosun metadata is not yet supported
• Metrics are suffixed with their types (eg. activeusers.gauge, responsetype.timer, downloads.counter)
• This backend can also be used to send metrics directly to an OpenTSDB server over HTTP/S

Dependencies

• none

Issues

• Issues