Bug 1390371

Summary:	Document that Google Cloud Monitoring API needs to be enabled to collect GCE performance metrics
Product:	Red Hat CloudForms Management Engine	Reporter:	Nandini Chandra <nachandr>
Component:	Documentation	Assignee:	Chris Budzilowicz <cbudzilo>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Suyog Sainkar <ssainkar>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	5.7.0	CC:	adahms, hhudgeon, jhardy, nachandr, obarenbo
Target Milestone:	GA
Target Release:	5.7.0
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:	doc
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2017-04-25 18:46:04 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	GCE	Target Upstream Version:

Description Nandini Chandra 2016-10-31 20:26:57 UTC

Description of problem:
----------------------
CFME can collect C&U metrics from GCE only if Google Cloud Monitoring API is enabled.This needs to be documented in this section in the CFME Deployment Planning Guide

https://access.redhat.com/documentation/en/red-hat-cloudforms/4.1/single/deployment-planning-guide/#capacity_and_utilization_collection

Here's the error message logged in evm.log after a failed C&U data fetch when Google Cloud Monitoring API is not enabled.

[----] E, [2016-09-29T03:36:51.183489 #26689:79d13c] ERROR -- : MIQ(MiqQueue#deliver) Message id: [9194], Error: [Access Not Configured. Cloud Monitoring API has not been used in project 135776510666 before or it is disabled. Enable it by visiting https://console.developers.google.com/apis/api/cloudmonitoring/overview?project=135776510666 then retry. If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry.]

Version-Release number of selected component (if applicable):
-------------------------------------------------------------
5.7


How reproducible:
----------------


Steps to Reproduce:
-------------------
1.
2.
3.


Actual results:
--------------


Expected results:
----------------


Additional info:
---------------

Document URL: 

Section Number and Name: 

Describe the issue: 

Suggestions for improvement: 

Additional information:

Comment 2 Andrew Dahms 2016-11-17 01:48:41 UTC

Assigning to Chris for review.

Comment 3 Chris Budzilowicz 2017-01-25 19:44:02 UTC

Hi Nandini,

I've added the information about enabling the cloud monitoring API you provided as a note in the C&U doc. You canfind a preview of the doc here:

http://file.rdu.redhat.com/~cbudzilo/CloudForms/cumetrics-google/build/tmp/en-US/html-single/#capacity-and-utilization-collection

Please let me know if you think I should add anything further, ie procedural steps, etc. 

-Chris

Comment 5 Nandini Chandra 2017-03-02 23:50:22 UTC

Hi Chris,

The content looks good, but can it have its own section?
There are no additional procedural steps.

So, can we add a section like this right after 
3.5. Data Collection for Red Hat Enterprise Linux OpenStack Platform?


New section:

3.6. Data Collection for Google Compute Engine

CloudForms can collect capacity and utilization metrics from Google Compute Engine once Google Cloud Monitoring API is enabled. Visit the Google APIs API Manager site to enable the Google Cloud Monitoring API. Once enabled, it may take a few minutes to propgate to CloudForms.

Thanks,
Nandini