README.md

Stouts.statsd

Ansible role which help you with:

• Install and setup Statsd

Variables

statsd_enabled: yes                 # Enable the role
statsd_home: /opt/statsd            # Where to install

statsd_port: 8125                   # StatsD listening port
statsd_graphiteHost: 127.0.0.1      # Hostname or IP of Graphite server
statsd_graphitePort: 2003           # Line Receiver port of Graphite (Carbon)
statsd_backends:                    # Enabled backends
- ./backends/graphite
statsd_debug: false
statsd_address: 0.0.0.0             # address to listen on over UDP
statsd_address_ipv6: false          # defines if the address is an IPv4 or IPv6 address [true or false]
statsd_mgmt_address: 0.0.0.0        # address to run the management TCP interface on
statsd_mgmt_port: 8126              # port to run the management TCP interface on
statsd_title: statsd                # Allows for overriding the process title
statsd_healthStatus: up             # default health status to be returned and statsd process starts ['up' or 'down']
statsd_flushInterval: 10000         # interval (in ms) to flush to Graphite
statsd_percentThreshold: 90
statsd_flush_counts: true           # send stats_counts metrics
statsd_graphite:
  legacyNamespace: false

statsd_additional_options: {}       # Setup additional options

Usage

Add Stouts.statsd to your roles and set vars in your playbook file.

Example:

- hosts: all

  roles:
    - Stouts.statsd

  vars:
    statsd_graphiteHost: g.myhost.com

License

Licensed under the MIT License. See the LICENSE file for details.

Feedback, bug-reports, requests, ...

Are welcome!

If you wish to express your appreciation for the role, you are welcome to send a postcard to:

Kirill Klenov
pos. Severny 8-3
MO, Istra, 143500
Russia