Chapter 23. Monitoring and observability
This chapter provides a number of ways to monitor and obtain metrics and logs from your Red Hat Virtualization system. These methods include:
- Using Data Warehouse and Grafana to monitor RHV
- Sending metrics to a remote instance of Elasticsearch
- Deploying Insights in Red Hat Virtualization Manager
23.1. Using Data Warehouse and Grafana to monitor RHV
Grafana is a web-based UI tool used to display reports based on data collected from the oVirt Data Warehouse PostgreSQL database under the database name
ovirt_engine_history. See Grafana dashboards.
Data from the Manager is aggregated in hourly and daily aggregations. The data is retained according to the scale setting defined in the Data Warehouse configuration during engine-setup (Basic or Full scale):
- Basic (default) - sampled every 24 hours, hourly data saved for 1 month, daily data - no daily aggregations saved.
- Full (recommended)- sampled every 24 hours, hourly data saved for 2 months, daily aggregations saved for 5 years.
Full sample scaling may require migrating the Data Warehouse to a separate virtual machine.
- For Data Warehouse scaling instructions, see Changing the Data Warehouse Sampling Scale.
- For instructions on migrating the Data Warehouse to or installing on a separate machine, see Migrating Data Warehouse to a Separate Machine and Installing and Configuring Data Warehouse on a Separate Machine.
Red Hat only supports installing the Data Warehouse database, the Data Warehouse service and Grafana all on the same machine as each other, even though you can install each of these components on separate machines from each other.
23.1.2. Configuring Grafana
Grafana integration is enabled and installed by default when running Red Hat Virtualization Manager
engine-setup for Stand Alone Manager installations. For Self-Hosted engine installations, you must enable Grafana integration manually when running
To enable Grafana integration in the Self-Hosted engine:
Put the environment in global maintenance mode:
# hosted-engine --set-maintenance --mode=global
- Log in to the machine where you want to install Grafana.
engine-setupcommand as follows:
# engine-setup --reconfigure-optional-components
Yesto install Grafana on this machine:
Configure Grafana on this host (Yes, No) [Yes]:
Disable global maintenance mode:
# hosted-engine --set-maintenance --mode=none
To access the Grafana dashboards:
https://<engine FQDN or IP address>/ovirt-engine-grafana
- Click Monitoring Portal in the web administration welcome page for the Administration Portal.
Configuring Grafana for Single Sign-on
The Manager engine-setup automatically configures Grafana to allow existing users on the Manager to log in with SSO from the Administration Portal, but does not automatically create users. You need to create new users (
Invite in the Grafana UI), confirm the new user, and then they can log in.
- Set an email address for the user in the Manager, if it is not already defined.
- Log in to Grafana with an existing admin user (the initially configured admin).
- Go to → and select .
- Input the email address and name, and select a Role.
Send the invitation using one of these options:
Selectand click . For this option, you need an operational local mail server configured on the Grafana machine.
- Locate the entry you want
- Copy and use this link to create the account by pasting it directly into a browser address bar, or by sending it to another user.
If you use the Pending Invites option, no email is sent, and the email address does not really need to exist - any valid looking address will work, as long as it’s configured as the email address of a Manager user.
To log in with this account:
- Log in to the Red Hat Virtualization web administration welcome page using the account that has this email address.
Monitoring Portalto open the Grafana dashboard.
- Select .
23.1.3. Grafana dashboards
Built-in Grafana dashboards
The following dashboards are available in the initial Grafana setup to report Data Center, Cluster, Host, and Virtual Machine data:
Table 23.1. Built-in Grafana dashboards
Service Level dashboards
Customized Grafana dashboards
You can create customized dashboards or copy and modify existing dashboards according to your reporting needs.
Built-in dashboards cannot be customized.