Bug 1464013

Summary: [Docs][RFE][Metrics] Tracker - Document what statistics and logs data are collected from the hosts and Manager machines
Product: Red Hat Enterprise Virtualization Manager Reporter: Shirly Radco <sradco>
Component: DocumentationAssignee: Petr Kovar <pkovar>
Status: CLOSED DUPLICATE QA Contact: rhev-docs <rhev-docs>
Severity: high Docs Contact:
Priority: high    
Version: 4.2.0CC: aperotti, dcadzow, didi, eheftman, jcoscia, lsurette, rhev-docs, srevivo
Target Milestone: ovirt-4.3.1Keywords: FutureFeature, Triaged
Target Release: 4.3.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Enhancement
Doc Text:
Story Points: ---
Clone Of:
: 1465012 (view as bug list) Environment:
Last Closed: 2019-01-29 07:08:32 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: Metrics RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On: 1528211, 1528213, 1528219, 1528221, 1528225, 1528237, 1528242, 1528247, 1528250, 1528251, 1528254, 1528255, 1528258, 1528278, 1528991    
Bug Blocks: 1402901    

Description Shirly Radco 2017-06-22 09:35:18 UTC
Description of problem:
Document  what statistics and logs data do we collectd from the hosts and engine machines

Comment 2 Lucy Bopf 2017-07-24 06:44:39 UTC
Assigning to Emma for review.

Emma, this is closely related to bug 1451625. You may find it easier to work on these two tasks in a single bug, in which case feel free to close this one and track everything in bug 1451625.

Comment 3 Shirly Radco 2017-07-27 12:29:31 UTC
Upstream documentation
http://www.ovirt.org/develop/release-management/features/engine/metrics-store/

Comment 4 Lucy Bopf 2017-07-31 01:51:14 UTC
I'm untargeting this bug pending proper docs team triage.

Shirly, if you have further information, please feel free to add it to this bug.

Comment 5 Emma Heftman 2017-11-15 10:12:32 UTC
TRACKER BUG - individual bugs will be opened per plugin and for the logs.

The effort here is for 
1. Logs
2. Plugins responsible for collecting metrics.

LOGS
====
There are two logs - engine and vdsm. Need to be documented and add links to the current documentation after verifying that this is enough to create reports and understand what is being displayed. (original effort 4d)

PLUGINS
======
There are 14 plugins each of which have several sub-categories. All of which must documented.

After analyzing the available full documentation from signalfx [1], which uses an Apache license and therefore can be reused, I have come up with the following information.

Plugins covered by Signalfx docs and therefore requiring "less" documentation effort: (original estimate 2d per plugin)
disk
interface
df
memory 
swap
load
postgresql

Plugins NOT covered by Signalfx docs that require a much greater documentation effort: (original estimate 4d per plugin)
NFS 
Processes
CPU
VIRT
Entropy
Swap
vm statsd


[1] https://github.com/signalfx/integrations

Comment 6 Emma Heftman 2017-11-15 11:45:01 UTC
(In reply to Emma Heftman from comment #5)
> TRACKER BUG - individual bugs will be opened per plugin and for the logs.
> 
> The effort here is for 
> 1. Logs
> 2. Plugins responsible for collecting metrics.
> 
> LOGS
> ====
> There are two logs - engine and vdsm. Need to be documented and add links to
> the current documentation after verifying that this is enough to create
> reports and understand what is being displayed. (original effort 4d) BZ#1513032
> 
> PLUGINS
> ======
> There are 14 plugins each of which have several sub-categories. All of which
> must documented.
> 
> After analyzing the available full documentation from signalfx [1], which
> uses an Apache license and therefore can be reused, I have come up with the
> following information.
> 
> Plugins covered by Signalfx docs and therefore requiring "less"
> documentation effort: (original estimate 2d per plugin)
> disk
> interface
> df
> memory 
> swap
> load
> postgresql
> 
> Plugins NOT covered by Signalfx docs that require a much greater
> documentation effort: (original estimate 4d per plugin)
> NFS 
> Processes
> CPU
> VIRT
> Entropy
> Swap
> vm statsd
> 
> 
> [1] https://github.com/signalfx/integrations

Comment 7 Yaniv Lavi 2017-11-19 14:00:19 UTC
We are looking to get a simple list for the MVP, full details can be added later on.

Comment 8 Yaniv Lavi 2017-12-03 13:37:48 UTC
That tracked in 1518561.

Comment 9 Emma Heftman 2017-12-21 10:07:03 UTC
After further analyzing the available documentation from both Signalfx and colectd's wiki,the situation is as follows:

Available documentation:
disk
> interface
> df
> memory 
> swap
> load
> postgresql
NFS - 21 /69 will be split into two sep. bugs.

Limited documentation:
Process
Most of NFS
statsd

Comment 10 Emma Heftman 2017-12-21 12:49:01 UTC
*** Bug 1475819 has been marked as a duplicate of this bug. ***

Comment 14 Sandro Bonazzola 2019-01-28 09:43:51 UTC
This bug has not been marked as blocker for oVirt 4.3.0.
Since we are releasing it tomorrow, January 29th, this bug has been re-targeted to 4.3.1.

Comment 16 Emma Heftman 2019-01-29 07:08:32 UTC

*** This bug has been marked as a duplicate of bug 1451625 ***