Monitoring Formula

The monitoring services in Uyuni are configured using formulas with forms. The package is installed by default, and contains these formulas:

  • Grafana

  • Prometheus

  • Prometheus Exporters

For more information about using monitoring, see administration:monitoring.adoc.

Procedure: Configuring the Grafana Formula

  1. Navigate to the Formulas  Grafana tab, and set these parameters in the Grafana section:

    • Check the Enabled box to enable Grafana visualizations.

    • In the Default admin user field, type the name of the default Grafana user.

    • In the Default admin password field, enter a password for the default user. Alternatively, click Generate new password to generate a password and fill the field.

  2. For each Prometheus data source you want to use, in the Datasources  Prometheus section, click +, and set these parameters:

    • In the Datasource name field, type a name to identify the data source.

    • In the Prometheus URL field, type the location of the Prometheus server, and append port 9090. For example, http://example.com:9090.

  3. In the Dashboards section, check the dashboards you want to use:

    • Uyuni server dashboard

    • Uyuni clients dashboard

    • PostgreSQL dashboard

    • Apache HTTPD dashboard

    • Kubernetes cluster dashboard

    • Kubernetes etcd dashboard

    • Kubernetes namespaces dashboard

  4. Click Save Formula to save your configuration.

Procedure: Configuring the Prometheus Formula

  1. Navigate to the Formulas  Prometheus tab, and set these parameters in the Prometheus section:

    • Check the Enabled box to enable Prometheus monitoring.

    • In the Scrape interval field, type the frequency of data scraping, in seconds. For example, 15 will scrape data every fifteen seconds.

    • In the Evaluation interval field, type the FIXME, in seconds. For example, 15 will FIXME every fifteen seconds.

  2. In the Uyuni Server section, set these parameters:

    • Check the Enabled box to enable monitoring on this server.

    • Check the Autodiscover clients box to enable Prometheus to automatically find and monitor new clients when they are added to the server.

    • In the Username field, type the user name of the Prometheus account on the server.

    • In the Password field, type the password of the Prometheus account on the server.

  3. In the Alerting section, set these parameters:

    • Check the Enable local Alertmanager service box to enable the alert manager service.

    • Check the Use local Alertmanager box to use the local alert manager service.

  4. For each alert manager you want to use, in the Alerting  Alertmanagers section, click +, and set these parameters:

    • In the IP Address:Port field, type the location of the alert manager target, including the port number.

  5. To use a rule file, in the Alerting  Rule Files section, click +, and set these parameters:

    • In the Rule Files field, type the location of the rule file you want to use.

  6. To use a scrape configuration, in the User defined scrape configurations section, click +, and set these parameters:

    • In the Job name field, type a name for your configuration.

    • In the Files field, type the location of the configuration file you want to use.

  7. Click Save Formula to save your configuration.

Procedure: Configuring the Prometheus Exporters Formula

  1. Navigate to the Formulas  Prometheus Exporters tab, and set these parameters in the Node Exporter section:

    • Check the Enabled box to enable the node exporter.

    • In the Arguments field, type any customized arguments for this exporter. For example, --web.listen-address=":9100".

  2. In the Apache Exporter section:

    • Check the Enabled box to enable the Apache exporter.

    • In the Arguments field, type any customized arguments for this exporter. For example, --telemetry.address=":9117".

  3. In the Postgres Exporter section:

    • Check the Enabled box to enable the PostreSQL exporter.

    • In the Data source Name field, type the name of the data source to use.

    • In the Arguments field, type any customized arguments for this exporter. For example, --web.listen-address=":9187".

  4. Click Save Formula to save your configuration.

When you have completed and saved all the forms, apply the highstate.

For more information about using monitoring, see administration:monitoring.adoc.