Sensu

This role deploys a full Sensu stack, a modern, open source monitoring framework.

Features

• Deploy a full Sensu stack, including RabbitMQ, redis, and the Uchiwa dashboard
• Full support for Sensu Enterprise
• Tight integration with the Ansible inventory - deployment of monitoring checks based on inventory grouping
• Fine grained control over dynamic client configurations
• Remote plugin deployment
• Automatic generation and dynamic deployment of SSL certs for secure communication between your clients and servers
• Highly configurable

Batteries included, but not imposed

Along with deploying the Sensu Server, API and clients, this role can deploy a full stack: RabbitMQ, redis, and the Uchiwa dashboard. However, if you want to rely on other roles/management methods to deploy/manage these services, it's nice and easy to integrate this role.

Documentation

Read the full documentation for a comprehensive overview of this role and its powerful features.

Requirements

This role requires:

• A supported version of Ansible, see Ansible version support for details.
• The dynamic_data_store variable to be set: see Dynamic Data Store
• If sensu_include_plugins is true (the default), the static_data_store variable needs to be set: see Check Deployment

Supported Platforms

Current Release

Automatically tested via TravisCI

• CentOS - 7
• Amazon Linux - only client side support is tested
• Debian - 8 (Jessie)
• Debian - 9 (Stretch)
• Ubuntu - 14.04 (Trusty Tahr)
• Ubuntu - 16.04 (Xenial Xerus)

Supported manually (compatibility not always guaranteed)

• SmartOS - base-64 15.x.x
• FreeBSD - 10.3, 11.0 (64-bit only)
• OpenBSD - 6.2

Role Variables

See Role Variables for a detailed list of the variables this role uses

Example Playbook

  - hosts: all
    roles:
      - role: cmacrae.sensu

Or, passing parameter values:

  - hosts: sensu_masters
    roles:
      - { role: cmacrae.sensu, sensu_master: true, sensu_include_dashboard: true  }

Ansible version support

All changes to this role are actively tested with the last two stable versions of Ansible to ensure compatibility. As such, this role only officially supports running with the last two stable releases of Ansible, which aligns with the Ansible support model.

License

MIT

Author Information

Originally created by Calum MacRae and supported by the Sensu Community Ansible Maintainers

Contributors

See the projects Contributors page

Feel free to: Raise an issue Contribute