ListDriveStats
Suggest changes
PDFs
You can use the ListDriveStats method to list high-level activity measurements for multiple drives in the cluster. By default, this method returns statistics for all drives in the cluster, and these measurements are cumulative from the addition of the drive to the cluster. Some values this method returns are specific to block drives, and some are specific to metadata drives.
Parameter
This method has the following input parameter:
| Name | Description | Type | Default value | Required |
|---|---|---|---|---|
drives |
List of drive IDs (driveID) for which to return drive statistics. If you omit this parameter, measurements for all drives are returned. |
integer array |
None |
No |
Return values
This method has the following return values:
Name |
Description |
Type |
driveStats |
List of drive activity information for each drive. |
driveStats array |
errors |
This list contains the driveID and associated error message. It is always present, and empty if there are no errors. |
JSON object array |
Request example
Requests for this method are similar to the following example:
{
"id": 1,
"method": "ListDriveStats",
"params": {
"drives":[22,23]
}
}
Response example
This method returns a response similar to the following example:
{
"id": 1,
"result": {
"driveStats": [
{
"driveID": 22,
"failedDieCount": 0,
"lifeRemainingPercent": 84,
"lifetimeReadBytes": 30171004403712,
"lifetimeWriteBytes": 103464755527680,
"powerOnHours": 17736,
"readBytes": 14656542,
"readOps": 3624,
"reallocatedSectors": 0,
"reserveCapacityPercent": 100,
"timestamp": "2016-03-01T00:19:24.782735Z",
"totalCapacity": 300069052416,
"usedCapacity": 1783735635,
"usedMemory": 879165440,
"writeBytes": 2462169894,
"writeOps": 608802
}
],
"errors": [
{
"driveID": 23,
"exception": {
"message": "xStatCheckpointDoesNotExist",
"name": "xStatCheckpointDoesNotExist"
}
}
]
}
}
New since version
9.6