Already using Sensu Core? Upgrade to Sensu Enterprise today to take advantage of its enterprise console, added-value features, built-in integrations, FREE annual training, and enterprise-class support.
The purpose of this guide is to help provide new and experienced Sensu users alike with a detailed guide for installing and configuring Sensu into a variety of operating environments. By default, this guide will direct you to install and configure Sensu Core or Sensu Enterprise in a standalone configuration.
If you are a new Sensu user – or if you have only ever used automation tools like Chef, Puppet, or Ansible to install and configure Sensu – working through this installation guide for the exercise alone is strongly recommended. Sensu’s architecture is one of its most compelling features, so learning how Sensu’s components work together will greatly improve your ability to leverage Sensu’s architecture to your advantage.
NOTE: manual installation is recommended for pre-production environments only. Please note that this guide is not intended to provide instructions for deploying Sensu into “production” environments. Production deployment strategies – including using automation tools like Chef, Puppet, or Ansible to install and configure Sensu – will be discussed at the conclusion of this guide.
By default, this installation guide will focus on the instructions for configuring a standalone installation, however instructions are available for other configurations including distributed and high-availability. Please consult the installation strategies reference documentation for more information
What will be covered in this guide:
Upon the completion of the first four (4) steps in this guide, you should have a fully functional Sensu installation, with one or more Sensu clients reporting keepalives (Sensu’s built-in “heartbeat” mechanism) back to the Sensu server, and a web-based Sensu dashboard providing visibility into the health of your infrastructure.
Once you have a fully functional Sensu installation, you will be encouraged to move on to the Getting Started Guide, which will introduce you to Sensu’s four primary building blocks (Checks, Handlers, Filters, and Mutators). But let’s not get ahead of ourselves…
What will you need to install Sensu?
Ready? Let’s get started with selecting an installation strategy!