Bug 1739692

Summary: Missing content from Reports documentation
Product: Red Hat CloudForms Management Engine Reporter: Parthvi Vala <pvala>
Component: DocumentationAssignee: Dayle Parker <dayleparker>
Status: VERIFIED --- QA Contact: Red Hat CloudForms Documentation <cloudforms-docs>
Severity: medium Docs Contact: Red Hat CloudForms Documentation <cloudforms-docs>
Priority: medium    
Version: 5.11.0CC: dayleparker, dvoss, kdixon
Target Milestone: GA   
Target Release: cfme-future   
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: Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: Feature
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: Documentation Target Upstream Version:
Embargoed:
Attachments:
Description Flags
Monitoring guide with updated Reports chapter none

Description Parthvi Vala 2019-08-09 18:56:29 UTC 
Document URL: 
1. https://access.redhat.com/documentation/en-us/red_hat_cloudforms/5.0-beta/html/monitoring_alerts_and_reporting/sect_reports

2.  https://access.redhat.com/documentation/en-us/red_hat_cloudforms/5.0-beta/html/monitoring_alerts_and_reporting/sect_reports#sect_report_menus


Section Number and Name: 
1. 
2. Report Menus


Describe the issue: 
1. It is now possible to filter report content and sort column, this feature is not documented.

2. Categories such as [Performance by Asset Type, Trending, Tenants, Provisioning, Running Processes] are missing from:
"Accordions that are general categories for the reports. The defaults supplied are Configuration Management, Migration Readiness, Operations, VM Sprawl, Relationships, and Events."


Suggestions for improvement: 

Additional information: 
1. BZ Reference - https://bugzilla.redhat.com/show_bug.cgi?id=1678150
2.
Comment 2 Dayle Parker 2019-09-19 15:07:38 UTC 
Hi Parthvi,

I've added a few new procedures to the "3.3. VIEWING REPORTS" section to describe how to use the filtering and column sorting. I also reorganized some of the sections in that area.

I've also added those missed report categories as you mentioned to the "3.10. MANAGING REPORT MENUS" section.

I'll attach a PDF preview -- please let me know what you think and if I missed anything important.

Cheers,
Dayle
Comment 3 Dayle Parker 2019-09-19 15:08:59 UTC 
Created attachment 1616780 [details]
Monitoring guide with updated Reports chapter

Please see CHAPTER 3. REPORTS in the PDF for the updates.
Comment 4 Dayle Parker 2019-09-19 15:24:44 UTC 
PRs (merged)

master: https://github.com/ManageIQ/manageiq_docs/pull/1260

ivanchuk: https://github.com/ManageIQ/manageiq_docs/pull/1261
Comment 5 Parthvi Vala 2019-09-20 09:07:16 UTC 
Hey Dayle, the PDF looks good, all the changes you made are nice, I just have 2 suggestions:
1. Could you please update the screenshots? Some of them are really old.
2. There is no mention about where custom-created reports will be put before they're moved to a specific menu. Now, this is probably not required, but it was just something that I observed.

Let me know what you think.
Comment 7 Parthvi Vala 2019-09-26 09:28:42 UTC 
Thanks for the update Dayle. I'll move this BZ to Verified and I have created another BZ like you suggested - https://bugzilla.redhat.com/show_bug.cgi?id=1755814.