Bug 1528219 - [Docs][RFE][Metrics User] Document descriptions for virt plugin
Summary: [Docs][RFE][Metrics User] Document descriptions for virt plugin
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Virtualization Manager
Classification: Red Hat
Component: Documentation
Version: 4.2.0
Hardware: Unspecified
OS: Unspecified
high
medium
Target Milestone: ovirt-4.3.4
: 4.3.0
Assignee: Eli Marcus
QA Contact: rhev-docs@redhat.com
URL:
Whiteboard: docs-accepted
Depends On:
Blocks: 1464013
TreeView+ depends on / blocked
 
Reported: 2017-12-21 10:30 UTC by Emma Heftman
Modified: 2019-10-30 07:29 UTC (History)
8 users (show)

Fixed In Version:
Doc Type: Enhancement
Doc Text:
Clone Of: 1528214
: 1528221 (view as bug list)
Environment:
Last Closed: 2019-06-04 16:35:45 UTC
oVirt Team: Metrics
Target Upstream Version:
Embargoed:
apinnick: needinfo-


Attachments (Terms of Use)

Description Emma Heftman 2017-12-21 10:30:50 UTC
The following plugins have only very limited documentation on the web:

collectd.statsd.host_storage
collectd.statsd.vm_balloon_cur
collectd.statsd.vm_balloon_max
collectd.statsd.vm_balloon_min
collectd.statsd.vm_balloon_target
collectd.statsd.vm_cpu_sys
collectd.statsd.vm_cpu_usage
collectd.statsd.vm_cpu_user
collectd.statsd.vm_disk_apparent_size
collectd.statsd.vm_disk_flush_latency
collectd.statsd.vm_disk_read_bytes
collectd.statsd.vm_disk_read_latency
collectd.statsd.vm_disk_read_ops
collectd.statsd.vm_disk_read_rate
collectd.statsd.vm_disk_true_size
collectd.statsd.vm_disk_write_bytes
collectd.statsd.vm_disk_write_latency
collectd.statsd.vm_disk_write_ops
collectd.statsd.vm_disk_write_rate
collectd.statsd.vm_nic_rx_bytes
collectd.statsd.vm_nic_rx_dropped
collectd.statsd.vm_nic_rx_errors
collectd.statsd.vm_nic_speed
collectd.statsd.vm_nic_tx_bytes
collectd.statsd.vm_nic_tx_dropped
collectd.statsd.vm_nic_tx_errors

Comment 1 Yaniv Lavi 2017-12-25 11:55:37 UTC
Can you please add this based on the DWH docs?

Comment 2 Shirly Radco 2018-01-11 09:56:35 UTC
(In reply to Emma Heftman from comment #0)
> The following plugins have only very limited documentation on the web:
> 
> collectd.statsd.host_storage

> collectd.statsd.vm_balloon_cur
The current amount of memory available to the guest (in KiB)

> collectd.statsd.vm_balloon_max
The maximum amount of memory available to the guest (in KiB)

> collectd.statsd.vm_balloon_min
The minimum amount of memory guaranteed to the guest (in KiB)

> collectd.statsd.vm_balloon_target
The amount of memory requested (in KiB)

> collectd.statsd.vm_cpu_sys
Ratio of CPU time spent by qemu on other than guest time

> collectd.statsd.vm_cpu_usage
Total cpu usage since VM start in ns

> collectd.statsd.vm_cpu_user
Ratio of CPU time spent by the guest VM

> collectd.statsd.vm_disk_apparent_size
The size of the disk (in bytes)

> collectd.statsd.vm_disk_flush_latency
The virtual disk flush latency measured in seconds.

> collectd.statsd.vm_disk_read_bytes
Read rate to disk in bytes per second.

> collectd.statsd.vm_disk_read_latency
The virtual disk read latency measured in seconds.

> collectd.statsd.vm_disk_read_ops
Read operations since VM start

> collectd.statsd.vm_disk_read_rate
The read activity in bytes per second

> collectd.statsd.vm_disk_true_size
The amount of underlying storage allocated (in bytes)

> collectd.statsd.vm_disk_write_bytes
Write rate to disk in bytes per second.

> collectd.statsd.vm_disk_write_latency
The virtual disk write latency measured in seconds.

> collectd.statsd.vm_disk_write_ops
Write operations since VM start 

> collectd.statsd.vm_disk_write_rate
The write activity in bytes per second

> collectd.statsd.vm_nic_rx_bytes
The number of incoming bytes in total

> collectd.statsd.vm_nic_rx_dropped
The number of incoming packets that have been dropped

> collectd.statsd.vm_nic_rx_errors
The number of incoming packets that have contained errors

> collectd.statsd.vm_nic_speed
The interface speed (in Megabits/s)

> collectd.statsd.vm_nic_tx_bytes
The number of outgoing bytes in total

> collectd.statsd.vm_nic_tx_dropped
The number of outgoing packets that have been dropped

> collectd.statsd.vm_nic_tx_errors
The number of outgoing packets that have contained errors

Comment 3 Shirly Radco 2018-01-11 09:57:41 UTC
Can you please explain collectd.statsd.host_storage metric? What are the units, What is the description.

Comment 4 Yaniv Bronhaim 2018-01-22 13:50:03 UTC
host storage key contains the storageDomain "delay" and "last check" values.  the time costs for writing to storage domain and when it occurred

Comment 5 Emma Heftman 2018-02-01 08:56:32 UTC
(In reply to Yaniv Bronhaim from comment #4)
> host storage key contains the storageDomain "delay" and "last check" values.
> the time costs for writing to storage domain and when it occurred

Hi Yaniv/Shirly
You have described two values here, the delay and when it occurred, however, we only have one metric - collectd.statsd.host_storage, so could you tell me which value is collected?
Thanks!

Comment 7 Emma Heftman 2018-02-07 11:38:28 UTC
(In reply to Emma Heftman from comment #5)
> (In reply to Yaniv Bronhaim from comment #4)
> > host storage key contains the storageDomain "delay" and "last check" values.
> > the time costs for writing to storage domain and when it occurred
> 
> Hi Yaniv/Shirly
> You have described two values here, the delay and when it occurred, however,
> we only have one metric - collectd.statsd.host_storage, so could you tell me
> which value is collected?
> Thanks!

Information from Nir Sofer:
We need both. The delay is the time to read from storage. We use this value to
display warnings in engine when the delay is too long (more than 5 seconds).

lastcheck .... this is not the time of the last check, but the time
since the last check.

If the last check was at 12:59:00, and I check the status at 12:59:32
lastCheck will be 32.00 seconds.

High lastCheck value mean that the storage monitor is stuck, or in other
words, storage is not responsive.

Shirly, which of these values do you display?

Comment 9 Lucy Bopf 2018-06-29 04:15:14 UTC
Accepting into 4.2.5 program.

Comment 13 Sandro Bonazzola 2019-01-28 09:40:09 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 15 Emma Heftman 2019-01-29 07:17:03 UTC
Shirly, I didn't see you respond to https://bugzilla.redhat.com/show_bug.cgi?id=1528219#c8 so I'm reassigning this to you to approve the descriptions we wrote for statsd for virt.


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