Probe Dock Sensu monitoring solution

A dockerized Sensu installation of Sensu Server and API with Uchiwa as the web UI

The idea is to deploy in your infrastructure the Dockerized Sensu setup and then to install and configure your clients to connect to this infra.

Sensu API, Server and Uchiwa UI for Sensu installation

Pre-requisites

The sensu-server container uses a volume which is provided in this repos. Once started, the volume will be the sensu-data directory in this repo.

Once you cloned this repository, you need to create the file sensu-data/env.json. You can use the env-sample.json file for that. Then you will have to update the file with the correct configuration for your needs.

Installation

1. Clone this repository

2. Run the start.sh script

If everything is working, you should be able to connect to http://<ip>:9980 and see the Sensu community edition UI. You will see any of your Sensu clients appearing there once correctly setup and running.

Sensu client installation on VM Host

1. Clone this repository

2. Install Sensu on host VM

sudo ./install.sh

3. Update the /etc/sensu/conf.d/client.json configuration file:

• <hostname> The name of the host that will be appearing in the uchiwa UI
• <hostip> The IP of the host that will be appearing in the uchiwa UI
• <environment> The environment (production, development, ...)
• You probably also want to update the subscriptions for your needs.

4. Update the /etc/sensu/conf.d/redis.json configuration file:

• <redishostip> The IP of the redis instance used by sensu.

5. It's time to run the Sensu client

sudo service sensu-client start

Install a new checks

1. Go to the http://sensu-plugins.io/ website to choose the checks you need

2. Update the images/sensu-server/plugins.txt with the appropriate <plugin>:<version>

3. Create the configuration check following the sensu documentation:

• https://sensuapp.org/docs/0.26/guides/getting-started/intro-to-checks.html
• https://sensuapp.org/docs/0.26/reference/checks.html

Remark: You need to create your check in sensu-data/checks directory or sensu-data/handlers directory.

4. Push your modifications to the repository

5. Update your sensu server setup

6. Update your repo (git pull)

7. Re-run the start.sh script

8. On each node of your infra, run:

cd <repository>

git pull

sudo ./plugins.sh