/ovirt-engine-metrics

Used to configure and deploy oVirt metrics, logs collection and integration with the central metrics store

Primary LanguageShellApache License 2.0Apache-2.0

oVirt Engine Metrics

The oVirt.metrics role enables you to set up oVirt Metrics store, deploy rsyslog/fluentd and collectd on the engine and hypervisors and manage the services.

Role Variables

Configure metrics

This role configures collectd and rsyslog or fluentd services on the oVirt engine and hypervisors, to be able to send metrics and logs to a remote metrics store.

In order to run this role you will need to run:

 configure_ovirt_machines_for_metrics.sh

You will need to set the following variables:

  • ovirt_env_name: (required - default: "engine")

    Environment name. Is used to identify data collected in a single central store sent from more than one oVirt engine. Maximum field length is 49 characters. For more details see: https://www.ovirt.org/develop/release-management/features/metrics/metrics-store-installation/#ovirt-metrics-store-setup

  • elasticsearch_host: (required - no default value)

    Address or hostname (FQDN) of the Elasticsearch server host.

  • manage_services: (default: "true")

    If set to true, fluentd and collectd services will be enabled.

  • manage_packages: (default: "true")

    If set to true, all defined collectd and fluentd packages will be installed / updated to latest.

Manage Services

This role manages collectd and fluentd services on the oVirt machines It can start (default) / restart / reload / stop the services.

It can also enable / disable the services.

In order to run this role you will need to run:

 configure_ovirt_machines_for_metrics.sh --playbook=manage-ovirt-metrics-services.yml

You will need to set the following variables:

  • service_enabled: (default: "yes")

    Set this to no if you don't what to enable the process

  • service_state: (default: "restarted")

    Set this to the required action. Optional values are: started, restarted, stopped reloaded.

  • service_name: (default: ["collectd", "fluentd"])

    A list of the the services that will be managed by the role.

In order to set these variable add the required variables to a file in /etc/ovirt-engine-metrics/config.yml.d/ or in the command line.

License

Apache License 2.0