Bug 1303976 - [Docs] [Release Notes] Add information on watermark reporting
Summary: [Docs] [Release Notes] Add information on watermark reporting
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat CloudForms Management Engine
Classification: Red Hat
Component: Documentation
Version: 5.5.0
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: GA
: 5.5.2
Assignee: Dayle Parker
QA Contact: Shikha
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-02-02 15:26 UTC by Deon Ballard
Modified: 2016-04-28 00:32 UTC (History)
7 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-03-10 02:13:42 UTC
Category: ---
Cloudforms Team: ---
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)
Watermark report release note, with screenshot of settings (114.07 KB, image/png)
2016-02-15 01:47 UTC, Dayle Parker
no flags Details


Links
System ID Private Priority Status Summary Last Updated
Red Hat Knowledge Base (Article) 2148911 0 None None None 2016-02-03 17:43:33 UTC

Description Deon Ballard 2016-02-02 15:26:19 UTC
Hey.

We have a reports and monitoring doc here:
https://access.redhat.com/documentation/en/red-hat-cloudforms/version-4.0/monitoring-alerts-and-reporting/

A new type of report was added in Capablanca / 5.5 to address high watermark (max usage) for different resources. Associated engineering bugs:
https://bugzilla.redhat.com/show_bug.cgi?id=1238287 (watermark for sockets per hypervisor)
https://bugzilla.redhat.com/show_bug.cgi?id=1238288 (watermark for vms per provider)

This is the description from the doc text:

Previous CloudForms Management Engine versions did not report a high watermark for the number of virtual machine sockets on a provider's hypervisors over a one-month period. This functionality has been added to the current version of CloudForms Management Engine. A report can now be queued to collect watermark information for sockets on each hypervisor per provider.

The engineering contact is Gregg Tanzillo.


Document URL: 

Section Number and Name: 

Describe the issue: 

Suggestions for improvement: 

Additional information:

Comment 2 Andrew Dahms 2016-02-03 00:05:06 UTC
Looks like these two reports are there by default under All Reports > Configuration Management > Providers > Watermark *

Comment 3 Andrew Dahms 2016-02-03 00:06:42 UTC
Assigning to Dayle for review.

Comment 4 Marianne Feifer 2016-02-03 17:43:33 UTC
Added article with listing of all reports for 5.5.

Did this by running bundle exec rails r tools/doc/reports_to_csv.rb from /var/www/miq/vmdb/tools/doc

The resulting file is /var/www/miq/vmdb/reports.csv

Comment 5 Dayle Parker 2016-02-05 00:44:19 UTC
Thanks Marianne! I'll make sure a link to that article ends up in the Monitoring, Alerts, and Reporting guide. Another bug is being created to update the Reports chapter in that guide.

Since the Monitoring, Alerts, and Reporting doc does not cover any reports specifically, it would be best to document the addition of the watermark reports to the Release Notes, so I'm changing the component for this particular bug.

Comment 6 Dayle Parker 2016-02-05 05:16:22 UTC
(from comment #5)

Another bug is being created to
> update the Reports chapter in that guide.
> 

https://bugzilla.redhat.com/show_bug.cgi?id=1304934 tracks review & updates to the Reports chapter.

Comment 7 Dayle Parker 2016-02-05 05:36:09 UTC
Added the following to the Release Notes in the Enhancements chapter:

Watermark reports
    CloudForms Management Engine can now report a high watermark for the maximum number of virtual machines on a provider over a one-month period, which can be used for billing. Reports can be queued to collect watermark information for host sockets per provider and for virtual machines per provider. These reports are located in the Reports menu under Configuration Management → Providers. 

Deon, Gregg, does this seem sufficient/accurate for this bug?

Comment 8 Dayle Parker 2016-02-15 01:47:10 UTC
Created attachment 1127145 [details]
Watermark report release note, with screenshot of settings

Following feedback from the product marketing team, I've expanded the release note so there's a bit more info about what's important for the user to know, along with a screenshot. Any feedback is welcome.

Comment 11 Andrew Dahms 2016-03-10 02:13:42 UTC
This content is now live on the Customer Portal.

Closing.


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