README.md

Sensu

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

End of Life

Please note that this role solely deploys Sensu Core which has reached end of life status.

For more details, please checkout https://blog.sensu.io/eol-schedule-for-sensu-core-and-enterprise and https://blog.sensu.io/announcing-the-sensu-archives

If you'd like to migrate to Sensu Go, there are docs availible at https://docs.sensu.io/sensu-core/latest/migration/ and a new officially Ansible Collection supported by XLab available here: https://github.com/sensu/sensu-go-ansible

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

Automatically tested via TravisCI

• CentOS - 6
• CentOS - 7
• Debian - 8 (Jessie)
• Debian - 9 (Stretch)
• Ubuntu - 14.04 (Trusty Tahr)
• Ubuntu - 16.04 (Xenial Xerus)
• Ubuntu - 18.04 (Bionic Beaver)
• Fedora - 28
• Fedora - 29
• Fedora - 20
• Amazon Linux
• Amazon Linux 2

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: sensu.sensu

Or, passing parameter values:

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

Ansible version support

All changes to this role are actively tested against Ansible 2.6 and 2.7 at this time. Ansible 2.5 is required at a minimum.

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