PI_RGS

Ops Center Analyzer REST API Reference Guide

Version

11.0.x

Audience

anonymous

Part Number

MK-99ANA003-18

The PI_RGS record holds performance data indicating the execution status of read or write operations on a parity group. This is a multi-instance record. The following records are not generated:

Records for external volume groups or virtual volume groups (Copy-on-Write Snapshot, Thin Image, and Dynamic Provisioning virtual volume groups)
Records for parity groups without a logical device

Note that if you are monitoring a VSP 5000 series storage system and the Access Type is 3 or 4, you cannot collect performance information about mainframe systems.

Collection Interval

300

Key Field

RAID_GROUP_NUMBER

Lifetime

From when the parity group is set up to when it is removed.

Fields

Field Name	Description	Access Type	Format
BUSY_RATE	Usage rate of the parity group.¹	1, 2, 3, 4	float
INPUT_RECORD_TYPE	Record type identifier, which is always set to RGS.	1, 2, 3, 4	string(8)
INTERVAL	Interval (in seconds) at which information is collected.	1, 2, 3, 4	ulong
MAX_BUSY_RATE	Usage rate of the parity group.¹ This field stores the value of the BUSY_RATE field.	1, 2, 3, 4	float
RAID_GROUP_NUMBER	Parity group number.	1, 2, 3, 4	string(64)
RANDOM_READ_IO_PCT	Percentage of the total number of read and write operations that are random read operations.	1, 2	float
RANDOM_READ_IO_RATE	Frequency of random read operations (times per second).	1, 2, 3, 4	float
RANDOM_READ_XFER_PCT²	Percentage of the total transfers that are random read operations.	1, 2	float
RANDOM_READ_XFER_RATE²	Transfer rate of random read operations (megabytes per second).	1, 2	float
RANDOM_TOTAL_IO_RATE	Frequency of random operations (sum of processing times for random read and write operations per second).	1, 2, 3, 4	float
RANDOM_TOTAL_XFER_RATE²	Transfer rate of random operations (total megabytes for random read and write operations per second).	1, 2, 3, 4	float
RANDOM_WRITE_IO_PCT	Percentage of the total number of read and write operations that are random write operations.	1, 2	float
RANDOM_WRITE_IO_RATE	Frequency of random write operations (times per second).	1, 2, 3, 4	float
RANDOM_WRITE_XFER_PCT²	Percentage of the total transfers that are random write operations.	1, 2	float
RANDOM_WRITE_XFER_RATE²	Transfer rate of random write operations (megabytes per second).	1, 2	float
READ_AVG_RESPONSE³	Average processing time for each read operation request (in microseconds).	1, 2, 3, 4	float
READ_HIT_IO_COUNT	Number of times the cache is hit in read operations.	1, 2	double
READ_HIT_RATE	Cache hit rate of read operations. The value is calculated based on the following formula: (READ_HIT_IO_COUNT / READ_IO_COUNT) * 100	1, 2, 3, 4	double
READ_IO_COUNT	Number of read operations.	1, 2, 3, 4	double
READ_IO_PCT	Percentage of the total number of read and write operations that are read operations. The value is calculated based on the following formula: {READ_IO_COUNT / (READ_IO_COUNT + WRITE_IO_COUNT )} * 100	1, 2, 3, 4	float
READ_IO_RATE	Frequency of read operations (number of times per second). The value is calculated based on the following formula: READ_IO_COUNT / INTERVAL	1, 2, 3, 4	double
READ_MBYTES³	Transfer size of read data (MB).	1, 2	double
READ_TOTAL_RESPONSE³	Sum of processing times for read-operation requests processed during the collection period (in microseconds).	1, 2, 3, 4	double
READ_XFER_PCT³	Percentage of the total transfers that are read operations. The value is calculated based on the following formula: {READ_MBYTES / (READ_MBYTES + WRITE_MBYTES)} * 100	1, 2	float
READ_XFER_RATE³	Read data transfer rate (MB per second). The value is calculated based on the following formula: READ_MBYTES / INTERVAL	1, 2, 3, 4	double
RECORD_TIME	Time (in GMT) at which data was collected from the storage system and the record was created.	1, 2, 3, 4	time_t
SEQUENTIAL_READ_IO_PCT	Percentage of the total number of read and write operations that are sequential read operations.	1, 2	float
SEQUENTIAL_READ_IO_RATE	Frequency of sequential read operations (times per second).	1, 2, 3, 4	float
SEQUENTIAL_READ_XFER_PCT²	Percentage of the total transfers that are sequential read operations.	1, 2	float
SEQUENTIAL_READ_XFER_RATE²	Transfer rate of sequential read operations (megabytes per second).	1, 2	float
SEQUENTIAL_TOTAL_IO_RATE	Frequency of sequential operations (sum of processing times for sequential read and write operations per second).	1, 2, 3, 4	float
SEQUENTIAL_TOTAL_XFER_RATE²	Transfer rate of sequential operations (total megabytes for sequential read and write operations per second).	1, 2, 3, 4	float
SEQUENTIAL_WRITE_IO_PCT	Percentage of the total number of read and write operations that are sequential write operations.	1, 2	float
SEQUENTIAL_WRITE_IO_RATE	Frequency of sequential write operations (times per second).	1, 2, 3, 4	float
SEQUENTIAL_WRITE_XFER_PCT²	Percentage of the total transfers that are sequential write operations.	1, 2	float
SEQUENTIAL_WRITE_XFER_RATE²	Transfer rate of sequential write operations (megabytes per second).	1, 2	float
TOTAL_RESPONSE_RATE³	Average processing time (in microseconds) per read/write processing request.	1, 2, 3, 4	float
WRITE_AVG_RESPONSE³	Average processing time for each write operation request (in microseconds).	1, 2, 3, 4	float
WRITE_HIT_IO_COUNT	This field cannot be used because it is reserved.	--	--
WRITE_HIT_RATE	This field cannot be used because it is reserved.	--	--
WRITE_IO_COUNT	Number of write operations.	1, 2	double
WRITE_IO_PCT	Percentage of the total number of read and write operations that are write operations. The value is calculated based on the following formula: {WRITE_IO_COUNT / (READ_IO_COUNT + WRITE_IO_COUNT )} * 100	1, 2, 3, 4	float
WRITE_IO_RATE	Frequency of write operations (number of times per second). The value is calculated based on the following formula: WRITE_IO_COUNT / INTERVAL	1, 2, 3, 4	double
WRITE_MBYTES³	Write data transfer size (MB).	1, 2	double
WRITE_TOTAL_RESPONSE³	Sum of processing times for write-operation requests processed during the collection period (in microseconds).	1, 2, 3, 4	double
WRITE_XFER_PCT³	Percentage of the total transfers that are write operations. The value is calculated based on the following formula: {WRITE_MBYTES / (READ_MBYTES + WRITE_MBYTES)} * 100	1, 2	float
WRITE_XFER_RATE³	Write data transfer rate (MB per second). The value is calculated based on the following formula: WRITE_MBYTES / INTERVAL	1, 2, 3, 4	double
Notes: For storage systems other than those of the following models, if the storage system has a built-in flash drive (FMD, FMC, or SSD), the value displayed as the usage rate of the parity groups of the flash drive might be higher than the actual usage rate, regardless of the load on the flash drive: VSP 5000 series, VSP Gx00, VSP Fx00, VSP G1000, G1500, and VSP F1500. For such storage systems, do not use as reference the value displayed as the usage rate of the parity groups of the flash drive. This field is not supported for parity groups that include a logical device for which the mainframe emulation type is set. For parity groups that include a logical device for which the mainframe emulation type is set, this value can be collected only when the storage system is VSP 5000 series, VSP G1000 (80-03 or later), G1500, or VSP F1500.