Getting the monitoring up and running

Setting up monitoring

Once we have our systems prepared, configuration and inventory files setup. We can move forward to installing Satellite-monitoring.

Setting up collectd

Collectd is a daemon which collects the usage metrics of your system and sends them over to graphite.

Currently our collectd setup supports two scenarios:

• collectd on satellite
• collectd on capsule

Collectd on Satellite

To install collectd on satellite, execute the following command

ansible-playbook -i conf/hosts.ini ansible/collectd-generic.yaml --tags "satellite6"

Collectd on capsule

To install collectd on capsule, execute the following command

ansible-playbook -i conf/hosts.ini ansible/collectd-generic.yaml --tags "capsules"

Setting up graphite

Once collectd is installed, the next step is to setup graphite. To setup graphite on our monitoring host, execute the following command:

ansible-playbook -i conf/hosts.ini ansible/graphite.yaml

Setting up grafana

Grafana is a tool which reads its data from graphite and provides visualization of the data to the user. To install grafana, execute the command as mentioned below

ansible-playbook -i conf/hosts.ini ansible/grafana.yaml

Setting up dashboard

Once grafana is setup, we need a dashboard which will show metrics collectd from our satellite and capsule hosts. You can setup this dashboard yourself, but to ease the task, satellite-monitoring provides a prebuilt dashboard that can be used to visualize the metrics. To utilize this prebuilt dashboard, execute the following command:

ansible-playbook -i conf/hosts.ini ansible/dashboard-generic.yaml

Note: Satellite-monitoring also provides additional statsd modules which extend the functionality of the monitoring setup to provide customized metrics about different satellite components. The installation for these is covered in the Installing optional statsd modules part of the wiki.