Red Hat SummitChapter 3. Installing and configuring operational measurement tools
You must install the data collecting agent, collectd, and the time-series database, Gnocchi.
3.1. Installing collectd
When you install collectd, you can configure multiple collectd plug-ins to suit your environment.
Procedure
-
Copy the file
/usr/share/openstack-tripleo-heat-templates/environments/collectd-environment.yamlto your local directory. Open
collectd-environment.yamland list the plug-ins you want underCollectdExtraPlugins. You can also provide parameters in theExtraConfigsection:Copy to Clipboard Copied! Toggle word wrap Toggle overflow By default, collectd comes with the
disk,interface,load,memory,processes, andtcpconnsplug-ins. You can add additional plug-ins using theCollectdExtraPluginsparameter. You can also provide additional configuration information for the CollectdExtraPlugins using theExtraConfigoption as shown. This example adds thevirtplug-in and configures the connection string and the hostname format.Include the modified YAML files in the
openstack overcloud deploycommand to install the collectd daemon on all overcloud nodes:openstack overcloud deploy
$ openstack overcloud deploy --templates \/home/templates/environments/collectd.yaml \ -e /path-to-copied/collectd-environment.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Additional resources
- For more information about collectd, see Section 1.3.2, “collectd”.
- To view the collectd plug-ins and configurations, see collectd plug-ins in the Service Telemetry Framework guide.
3.2. Installing Gnocchi
By default, Gnocchi is not enabled on the undercloud. Red Hat does not recommend that you enable Telemetry on the undercloud as it generates a lot of data that the undercloud cannot handle due to limited resources and single point of failure.
By default, Telemetry and Gnocchi are installed on the controller and Compute nodes. The default storage back end for Gnocchi is file.
You can deploy Gnocchi on the overcloud in one of two ways:
- Internally. For more information, see Section 3.2.1, “Deploying Gnocchi internally”.
- Externally. For more information, see Section 3.2.2, “Deploying Gnocchi externally”.
3.2.1. Deploying Gnocchi internally
The default deployment is internal.
Procedure
-
To deploy collectd to send metrics data to internal Gnocchi, add
/usr/share/openstack-tripleo-heat-templates/environments/services/collectd.yamlto theovercloud deploycommand.
Additional resources
- For more information, see Section 3.1, “Installing collectd”.
3.2.2. Deploying Gnocchi externally
Procedure
Create a custom YAML file in your local directory, for example
ExternalGnocchi.yaml, and ensure that you include the following details:CollectdGnocchiServer: <IPofExternalServer> CollectdGnocchiUser: admin CollectdGnocchiAuth: basic
CollectdGnocchiServer: <IPofExternalServer> CollectdGnocchiUser: admin CollectdGnocchiAuth: basicCopy to Clipboard Copied! Toggle word wrap Toggle overflow To deploy Gnocchi, add the custom YAML file to the
overcloud deploycommand. Replace<existing_overcloud_environment_files>with the list of environment files that are part of your existing deployment.openstack overcloud deploy \ -e <existing_overcloud_environment_files> \ -e /usr/share/openstack-tripleo-heat-templates/environments/services/collectd.yaml \ -e /home/templates/environments/ExternalGnocchi.yaml \ ...
openstack overcloud deploy \ -e <existing_overcloud_environment_files> \ -e /usr/share/openstack-tripleo-heat-templates/environments/services/collectd.yaml \ -e /home/templates/environments/ExternalGnocchi.yaml \ ...Copy to Clipboard Copied! Toggle word wrap Toggle overflow NoteYou can find all of the Gnocchi parameters in the following YAML file:
/usr/share/openstack-tripleo-heat-templates/puppet/services/metrics/collectd.yaml
3.2.3. Verifying the Gnocchi deployment
Procedure
List the new resources and metrics:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}