Bug 1390371 - Document that Google Cloud Monitoring API needs to be enabled to collect GCE performance metrics
Summary: Document that Google Cloud Monitoring API needs to be enabled to collect GCE ...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat CloudForms Management Engine
Classification: Red Hat
Component: Documentation
Version: 5.7.0
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: GA
: 5.7.0
Assignee: Chris Budzilowicz
QA Contact: Suyog Sainkar
URL:
Whiteboard: doc
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-10-31 20:26 UTC by Nandini Chandra
Modified: 2017-04-25 18:46 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-04-25 18:46:04 UTC
Category: ---
Cloudforms Team: GCE
Target Upstream Version:


Attachments (Terms of Use)

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


Note You need to log in before you can comment on or make changes to this bug.