Sensu StatsD Extension
A StatsD implementation for the Sensu client. This check extension creates a StatsD TCP & UDP listener, receives StatsD metrics, parses them, and flushes them to the Graphite plaintext format for Sensu to send to Graphite or another TSDB.
This StatsD implementation attempts to adhere to Etsy's metric type specifications.
Installation
This extension requires Sensu version >= 0.26.
On a Sensu client machine.
sensu-install -e statsd:1.0.0
Edit /etc/sensu/conf.d/extensions.json to load it.
{
"extensions": {
"statsd": {
"version": "1.0.0"
}
}
}Restart the Sensu client.
sudo service sensu-client restartConfiguration
Edit /etc/sensu/conf.d/statsd.json to change its configuration.
{
"statsd": {
"bind": "0.0.0.0"
}
}The following defaults make the integration behave like Etsy's StatsD implementation.
| attribute | type | default | description |
|---|---|---|---|
| bind | string | "127.0.0.1" | IP to bind the StatsD sockets to |
| port | integer | 8125 | Port to bind the StatsD sockets to |
| flush_interval | integer | 10 | The StatsD flush interval |
| send_interval | integer | 30 | How often Graphite metrics are sent to Sensu |
| percentile | integer | 90 | The percentile to calculate for StatsD metrics |
| add_client_prefix | boolean | true | If the Sensu client name should prefix the Graphite metric path |
| path_prefix | string | "statsd" | The optional Graphite metric path prefix (after client name) |
| add_path_prefix | boolean | true | If the path_prefix should be used |
| delete_gauges | boolean | false | If gauges that have not been updated should be deleted instead of flushed |
| delete_counters | boolean | false | If counters with a value of 0 should be deleted instead of flushed |
| delete_timers | boolean | false | If timers with a count of 0 should be deleted instead of flushed |
| reset_gauges | boolean | false | If gauges should be reset to 0 after flushing |
| reset_counters | boolean | true | If counters should be reset to 0 after flushing |
| reset_timers | boolean | true | If timers should be reset/cleared after flushing |
| handler | string | "graphite" | Handler to use for the Graphite metrics |
| truncate_output | boolean | true | If output should be truncated |
Example
Test the StatsD TCP socket:
echo "orders:1|c" | nc 127.0.0.1 8125