View Disk IOPS

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

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

XML Output example

<?xml version="1.0" encoding="UTF-8"?>
<disk_hourly_stats type="array">
<disk_hourly_stat>
<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_hourly_stat>
...
<disk_hourly_stat></disk_hourly_stat>
...
</disk_hourly_stats>


Where:

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