View Disk IOPS

To view Input/Output statistics for your disks, use the following request:

GET /settings/disks/:id/usage.xml
GET /settings/disks/:id/usage.json

XML Request Example

curl -i -X GET -H 'Accept: application/xml' -H 'Content-type: application/xml' -u user:userpass --url http://onapp.test/settings/disks/64/usage.xml

JSON Request Example

curl -i -X GET -H 'Accept: application/json' -H 'Content-type: application/json' -u user:userpass --url http://onapp.test/settings/disks/64/usage.json

XML Output Example

<disk_hourly_stats type="array">
<disk_id type="integer">64</disk_id>
<created_at type="datetime">2011-07-19T13:00:10Z</created_at>
<updated_at type="datetime">2011-07-19T13:00:10Z</updated_at>
<writes_completed type="integer">345685</writes_completed>
<stat_time type="datetime">2011-07-19T13:00:00Z</stat_time>
<data_written type="integer">11061920</data_written>
<data_read type="integer">53840</data_read>
<id type="integer">1028</id>
<user_id type="integer">13</user_id>
<virtual_machine_id type="integer">34</virtual_machine_id>
<reads_completed type="integer">1684</reads_completed>


disk_id - the ID of a disk

created_at - the timestamp in DB when the record was created

updated_at - the timestamp in DB when the record was updated

data_read – the amount of data read (kB) from this disk

data_written - the amount of data written (kB) to the disk

stat_time - the time when statistics were generated

writes_completed - the number of completed write operations performed during the hour for which this statistics has been gathered

reads_completed - the number of completed read operations performed during the hour for which this statistics has been gathered

user_id – ID of the user whose VS is using this disk

virtual_machine_id – ID of the VS using this disk

Use the following formulas to convert disk usage statistics data received in the API output:

(data_read / 1024) / 3600

(data_written / 1024) / 3600