[cloudstack-documentation] branch volumes-metrics-doc-update created (now 753c9b1)

[an...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

andrijapanic pushed a change to branch volumes-metrics-doc-update
in repository https://gitbox.apache.org/repos/asf/cloudstack-documentation.git.


      at 753c9b1  Description on the volume metrics

This branch includes the following new commits:

     new 753c9b1  Description on the volume metrics

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.

[cloudstack-documentation] 01/01: Description on the volume metrics

[an...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

andrijapanic pushed a commit to branch volumes-metrics-doc-update
in repository https://gitbox.apache.org/repos/asf/cloudstack-documentation.git

commit 753c9b159967c4abb2fba57846d662368ca2e4e9
Author: Andrija Panic <45...@users.noreply.github.com>
AuthorDate: Thu Jul 25 18:02:51 2019 +0200

    Description on the volume metrics
---
 source/adminguide/storage.rst | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst
index 44f5fcb..63b2ae7 100644
--- a/source/adminguide/storage.rst
+++ b/source/adminguide/storage.rst
@@ -789,6 +789,35 @@ snapshot data.
    been taken and stored in OVA format will continue to exist in that 
    format, and will continue to work as expected.
 
+Volume Metrics
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Volume statistics are collected on a regular interval (defined by global
+setting volume.stats.interval with a default of 600 seconds). 
+This feature is currently only available for VMware and KVM. 
+Volume stats include include bytes/s and IO/s statistics as shown in the
+API output bellow.
+
+.. code:: bash
+
+   [root@mgmt]# cmk list volumesmetrics id=272c3d8b-ef2c-499e-abfb-736b54d3d6b1
+   {
+   "count": 1,
+   "volume": [
+      {
+         ...
+         "diskiopstotal": 30245,
+         "diskioread": 22443,
+         "diskiowrite": 7802,
+         "diskkbsread": 343124,
+         "diskkbswrite": 217619,
+         ...
+Bytes read/write statistics are not exposed via UI, as shown in the image below.
+
+|volume-metrics.png|
+
+These statistics are obtained from the hypervisor directly and they represent
+"current" bytes/s and IO/s values at the time of collection.
 
 .. |AttachDiskButton.png| image:: /_static/images/attach-disk-icon.png
    :alt: Attach Disk Button.
@@ -802,3 +831,5 @@ snapshot data.
    :alt: Detach Disk Button.
 .. |Migrateinstance.png| image:: /_static/images/migrate-instance.png
    :alt: button to migrate a volume.
+.. |volume-metrics.png| image:: /_static/images/volume-metrics.png
+   :alt: Volume metrics