Overview

This Chapter contains documentation on how to configure OpenNebula to work with the Prometheus monitoring and alerting toolkit. The integration consists of four components:

  • A Libvirt Exporter that provides information about VM (KVM domains) running on an OpenNebula Host.
  • An OpenNebula Exporter that provides basic information about the overall OpenNebula cloud.
  • Alert rules sample files based on the provided metrics.
  • Grafana dashboards to visualize VM, Host, and OpenNebula information in a convenient way.

Additionally, four optional exporter sub-packages are shipped to cover deployment-specific telemetry:

  • OVS Exporter for Open vSwitch metrics on Hosts using OVS networking.
  • MySQL Exporter for MariaDB/MySQL server metrics on Front-ends using the MySQL backend.
  • SMART Exporter for S.M.A.R.T. disk health on Hosts (or any machine with physical disks).
  • LVM Exporter for LVM physical-volume / volume-group / logical-volume metrics on Hosts using LVM-backed datastores.

These are opt-in — install only the ones relevant to your deployment. Prometheus auto-detects them via TCP probe and adds matching scrape configs the next time patch_datasources.rb runs (see the installation guide).

How Should I Read This Chapter

Before reading this Chapter, you should have already installed your Front-end and KVM Hosts, and have an OpenNebula cloud up and running with at least one virtualization node.

This Chapter is structured as follows:

Finally, you can find a reference of the metrics gathered by the exporters here.

Hypervisor Compatibility

These guides are compatible with the KVM hypervisor.