Bug 1379313

Summary:	Document the fact that Telemetry services ain't installed on undercloud by default
Product:	Red Hat OpenStack	Reporter:	Yurii Prokulevych <yprokule>
Component:	documentation	Assignee:	Dan Macpherson <dmacpher>
Status:	CLOSED CURRENTRELEASE	QA Contact:	RHOS Documentation Team <rhos-docs>
Severity:	urgent	Docs Contact:
Priority:	urgent
Version:	10.0 (Newton)	CC:	dmacpher, jdanjou, maufart, mburns, pkilambi, rhel-osp-director-maint, srevivo, yprokule
Target Milestone:	ga	Keywords:	Documentation, Triaged
Target Release:	10.0 (Newton)
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2018-08-06 05:37:37 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:

Description Yurii Prokulevych 2016-09-26 10:56:40 UTC

Description of problem:
-----------------------
By default telemetry components(aodh/ceilometer) ain't installed by default on the undercloud.

This has to be well documented since CloudForms is using events processed by ceilometer.

Also, if telemetry is not installed/configured on undercloud, all the remaining services(nova/neutron/...) have to be configured not to emit notifications, until there is another consumer setup.


Version-Release number of selected component (if applicable):
-------------------------------------------------------------
instack-undercloud-5.0.0-0.20160907134010.649dc3f.el7ost.noarch

How reproducible:
-----------------
100%

Steps to Reproduce:
1. Install the undercloud.
2. Check telemetry related services ain't installed and running.

Comment 1 Marek Aufart 2016-10-18 11:06:46 UTC

Thanks for reporting this BZ. I can confirm that CloudForms uses Ceilometer on both Undercloud and Overcloud.

Are steps to enable Ceilometer manually available already?

Comment 2 Pradeep Kilambi 2016-10-18 14:54:40 UTC

@Marek:

Yes, before you run undercloud install set enable_telemetry = true in undercloud.conf.

Comment 3 Dan Macpherson 2017-09-20 04:50:34 UTC

Checking my backlog and found this bug. The description for "enable_telemetry" should be updated to include the default:

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/10/html/director_installation_and_usage/chap-installing_the_undercloud#sect-Configuring_the_Director

enable_telemetry
    Defines whether to install OpenStack Telemetry (ceilometer, aodh) services in the undercloud. The default value is false, which disables telemetry on the undercloud. 

@Yurii, was this what you were after?

Comment 4 Yurii Prokulevych 2017-09-20 10:51:18 UTC

Partially, also I'd like to emphasize the impact if telemetry services are disabled.

Adding Julien cause he can has another pov.

Comment 5 Julien Danjou 2017-09-20 13:34:10 UTC

The biggest direct impact for customers is CloudForms not going to work correctly with telemetry disabled. I don't know if we want to talk about CloudForms in OSP documentation?

I imagine the current doc is enough otherwise.

Comment 6 Dan Macpherson 2017-09-21 01:57:33 UTC

It should be okay for just a casual mention. I'm very much in favor of pointing out the links between out products, so I'll add a reference to it.

Comment 8 Dan Macpherson 2018-08-06 05:37:37 UTC

Yep, this has been implemented:

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html/director_installation_and_usage/installing-the-undercloud#director-configuration-parameters