Sensu

This role sets up a complete Sensu Core stack, which is an open-source monitoring framework.

End of Life Notice

Please note that this role only installs Sensu Core, which is no longer supported.

For more information, visit the following links:

• End of Life Schedule
• Announcing the Sensu Archives

If you want to upgrade to Sensu Go, you can find migration documentation here and a new Ansible Collection supported by XLab here.

Features

• Installs a full Sensu stack, including RabbitMQ, Redis, and the Uchiwa dashboard.
• Fully supports Sensu Enterprise.
• Works well with Ansible inventory for monitoring checks.
• Allows detailed control of client configurations.
• Can deploy plugins remotely.
• Automatically creates and manages SSL certificates for secure client-server communication.
• Highly customizable.

Built-in Options

This role not only sets up the Sensu Server, API, and clients but can also install RabbitMQ, Redis, and the Uchiwa dashboard. If you prefer to use other roles to manage these services, it's easy to integrate them with this role.

Documentation

You can view the full documentation here for detailed information about this role and its features.

Requirements

To use this role, you need:

• A supported version of Ansible (see the Ansible version support section).
• The dynamic_data_store variable set (see Dynamic Data Store).
• If sensu_include_plugins is true (the default), you also need to set the static_data_store variable (see Check Deployment).

Supported Platforms

Automatically Tested Platforms

• 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 30
• Amazon Linux
• Amazon Linux 2

Manually Supported Platforms (Compatibility Not Guaranteed)

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

Role Variables

You can find a detailed list of role variables here.

Example Playbook

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

Or with specific parameters:

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

Ansible Version Support

Current changes are actively tested against Ansible versions 2.6 and 2.7. A minimum of Ansible 2.5 is required.

License

MIT

Author Information

Originally created by Calum MacRae and maintained by the Sensu Community Ansible Maintainers.

Contributors

For a list of contributors, visit the Contributors Page.

Feel free to:

• Raise an issue
• Contribute