Skip to main content
Element Software

volumeStats

Contributors

The volumeStats object contains statistical data for an individual volume.

Object members

You can use the following methods to get volumeStats objects for some or all volumes:

This object contains the following members:

Name Description Calculation Type

accountID

The ID of the account of the volume owner.

N/A

integer

actualIOPS

The current actual IOPS to the volume in the last 500 milliseconds.

Point in time

integer

asyncDelay

The length of time since the volume was last synced with the remote cluster. If the volume is not paired, this is null. Note: A target volume in an active replication state always has an asyncDelay of 0 (zero). Target volumes are system-aware during replication and assume asyncDelay is accurate at all times.

N/A

ISO 8601 duration string or null

averageIOPSize

The average size in bytes of recent I/O to the volume in the last 500 milliseconds.

Point in time

integer

burstIOPSCredit

The total number of IOP credits available to the user. When volumes are not using up to the configured maxIOPS, credits are accrued.

N/A

integer

clientQueueDepth

The number of outstanding read and write operations to the volume.

N/A

integer

desiredMetadataHosts

The metadata (slice) services being migrated to if the volume metadata is being migrated between metadata services. A "null" value means the volume is not migrating.

N/A

JSON object

latencyUSec

The average time, in microseconds, to complete operations to the volume in the last 500 milliseconds. A "0" (zero) value means there is no I/O to the volume.

Point in time

integer

metadataHosts

The metadata (slice) services on which the volume metadata resides. Possible values:

  • primary: The primary metadata services hosting the volume.

  • liveSecondaries: Secondary metadata services that are currently in a "live" state.

  • deadSecondaries: Secondary metadata services that are in a dead state.

N/A

JSON object

normalizedIOPS

Average number of IOPS for the entire cluster in the last 500 milliseconds.

Point in time

integer

nonZeroBlocks

The total number of 4KiB blocks that contain data after the last garbage collection operation has completed.

N/A

integer

readBytes

The total cumulative bytes read from the volume since the creation of the volume.

Monotonically increasing

integer

readBytesLastSample

The total number of bytes read from the volume during the last sample period.

Point in time

integer

readLatencyUSec

The average time, in microseconds, to complete read operations to the volume in the last 500 milliseconds.

Point in time

integer

readLatencyUSecTotal

The total time spent performing read operations from the volume.

Monotonically increasing

integer

readOps

The total read operations to the volume since the creation of the volume.

Monotonically increasing

integer

readOpsLastSample

The total number of read operations during the last sample period.

Point in time

integer

samplePeriodMSec

The length of the sample period, in milliseconds.

N/A

integer

sliceIopsStats

The I/O usage statistics for a volume. Available beginning with Element 12.8. Possible values for sliceIopsStats:

  • largeStatistics: The I/O statistics for the volume measured over a longer time period, typically the last 24 hours.

  • smallStatistics: The I/O statistics for the volume measured over a shorter time period, typically the last hour.

Possible values for largeStatistics and smallStatistics:

  • averageReadIops: The average read IOPS for the volume.

  • averageTotalIops: The average total (read + write) IOPS for the volume.

  • averageWriteIops: The average write IOPS for the volume.

  • nSamples: The number of samples included in the statistic calculation.

  • peakReadIops: The maximum read IOPS observed over a statistic interval.

  • peakTotalIops: The maximum total IOPS observed over a statistic interval.

  • peakWriteIops: The maximum write IOPS observed over a statistic interval.

  • sliceID: Volume ID or Slice ID

Point in time

JSON object

throttle

A floating value between 0 and 1 that represents how much the system is throttling clients below their maxIOPS because of re-replication of data, transient errors, and snapshots taken.

N/A

float

timestamp

The current time in UTC+0 format.

N/A

ISO 8601 date string

unalignedReads

The total cumulative unaligned read operations to a volume since the creation of the volume.

Monotonically increasing

integer

unalignedWrites

The total cumulative unaligned write operations to a volume since the creation of the volume.

Monotonically increasing

integer

volumeAccessGroups

The list of IDs of volume access group(s) to which a volume belongs.

N/A

integer array

volumeID

The ID of the volume.

N/A

integer

volumeSize

Total provisioned capacity in bytes.

N/A

integer

volumeUtilization

A floating point value that describes how fully the client is using the volume's input / output capabilities in comparison with the maxIOPS QoS setting for that volume. Possible values:

  • 0: The client is not using the volume.

  • 0.01 to 0.99: The client is not fully utilizing the volume's IOPS capabilities.

  • 1.00: The client is fully utilizing the volume up to the IOPS limit set by the maxIOPS setting.

  • > 1.00: The client is utilizing more than the limit set by maxIOPS. This is possible when the burstIOPS QoS setting is set higher than maxIOPS. For example, if maxIOPS is set to 1000 and burstIOPS is set to 2000, the volumeUtilization value would be 2.00 if the client fully utilizes the volume.

N/A

float

writeBytes

The total cumulative bytes written to the volume since the creation of the volume.

Monotonically increasing

integer

writeBytesLastSample

The total number of bytes written to the volume during the last sample period.

Monotonically increasing

integer

writeLatencyUSec

The average time, in microseconds, to complete write operations to a volume in the last 500 milliseconds.

Point in time

integer

writeLatencyUSecTotal

The total time spent performing write operations to the volume.

Monotonically increasing

integer

writeOps

The total cumulative write operations to the volume since the creation of the volume.

Monotonically increasing

integer

writeOpsLastSample

The total number of write operations during the last sample period.

Point in time

integer

zeroBlocks

The total number of empty 4KiB blocks without data after the last round of garbage collection operation has completed.

Point in time

integer

Looking for answers?
Try Doc, our Gen AI Assistant.