PD_PLC

Ops Center Analyzer REST API Reference Guide

Version

11.0.x

Audience

anonymous

Part Number

MK-99ANA003-18

The PD_PLC record stores performance data that indicates the operation status of Dynamic Provisioning pools, Copy-on-Write Snapshot pools, and Thin Image pools. This is a multi-instance record.

Note: If the pool is blocked, RAID Agent does not collect information about the pool unless the usage rate of the pool capacity is 100%.

Collection Interval

3600

Key Field

POOL_ID

Lifetime

From when the pool is set up to when it is removed.

Fields

Field Name	Description	Access Type	Format
ATTRIBUTE	Type of the pool: Dynamic Provisioning Dynamic Provisioning (Tiering) Data Direct Mapping Thin Image	1, 2, 3, 4	string(32)
AUTO_EXPANSION²³	Indicates whether to automatically add pool volumes according to the compression ratio of a parity group for which accelerated compression is enabled: Enabled Automatically adds pool volumes according to the compression ratio of a parity group for which accelerated compression is enabled. Disabled Pool volumes for which accelerated compression is enabled are not added automatically. "" This function is not supported.	1, 2, 3, 4	string(32)
COLLECTION_TIME	Time (in GMT) when the data was collected from the storage system.	1, 2	time_t
DATA_SAVING	Availability of the deduplication function for the pool: 0x00 Deduplication Not Available.¹⁰ 0x02 Deduplication Not Available.¹⁰ 0x03 Deduplication Available.	1, 2, 3, 4	unsigned char
DATA_VOLUME_USED_CAPACITY¹⁸	Capacity used by a virtual volume (GB).¹¹	1, 2, 3, 4	double
DKC_COMP_CAPACITY¹⁸	Capacity compressed by capacity saving (GB).^{1, 12}	1, 2, 3, 4	double
DKC_COMP_RATIO¹⁸	Ratio of disk space that is saved through compression when using capacity saving. This is the value of N when the ratio of capacity before and after the reduction is N:1.^{12, 20}	1, 2, 3, 4	float
DKC_DUP_CAPACITY¹⁸	Capacity saved by deduplication of capacity saving (GB).^{1, 12}	1, 2, 3, 4	double
DKC_DUP_RATIO¹⁸	Ratio of disk space that is saved through deduplication when using capacity saving. This is the value of N when the ratio of capacity before and after the reduction is N:1.^{12, 20}	1, 2, 3, 4	float
DKC_PRE_PROC_CAPACITY¹⁸	Capacity of data (before reduction) to be reduced by capacity saving (GB).¹	1, 2, 3, 4	double
DKC_RECLAIM_CAPACITY¹⁸	Capacity saved by reclaiming the specified data pattern using capacity saving (GB).^{1, 12}	1, 2, 3, 4	double
DKC_SAVING_CAPACITY	Capacity reduced when deduplication and compression are used in a pool.^{1, 13, 19}	1, 2, 3, 4	double
DKC_SAVING_RATIO¹⁸	Saving effect achieved by capacity saving. This is the value of N when the ratio of capacity before and after the reduction is N:1.^{14, 20}	1, 2, 3, 4	float
DKC_SYSTEM_CAPACITY¹⁸	The amount of consumed system data (GB).¹	1, 2, 3, 4	double
EMULATION_TYPE	Emulation type of the pool.	1, 2, 3, 4	string(64)
FMC_CAPACITY_TOTAL¹⁸	The total logical capacity of the pool volume for FMC or the pool volume that supports accelerated compression used in the pool (GB).²	1, 2, 3, 4	double
FMC_CAPACITY_USED	The logically used capacity of the pool volume for FMC or the pool volume that supports accelerated compression used in the pool (GB).²	1, 2, 3, 4	double
FMC_POOL_CAPACITY_COMP	The compressed capacity with the accelerated compression function (GB).^{2, 21}	1, 2, 3, 4	double
FMC_POOL_CAPACITY_COMP_RATIO	Saving effect achieved by accelerated compression. This is the value of N when the ratio of capacity before and after the reduction is N:1.²⁰	1, 2, 3, 4	float
FMC_POOL_CAPACITY_RECLAIM¹⁸	The reclaimed capacity with the accelerated compression function (GB).^{2, 19}	1, 2, 3, 4	double
FMC_POOL_CAPACITY_SAVING	The saved capacity achieved with the accelerated compression function (GB).^{2, 15, 21}	1, 2, 3, 4	double
FMC_POOL_CAPACITY_SAVING_RATE	Reduction rate (%) of capacity reduced by the accelerated compression function.^{2, 16} The value is calculated based on the following formula: (FMC_POOL_CAPACITY_SAVING / (PHYSICAL_CAPACITY_USED + FMC_POOL_CAPACITY_SAVING)) * 100	1, 2, 3, 4	float
FREE_CAPACITY	Unused capacity remaining in the pool (GB).^{3, 4}	1, 2, 3, 4	double
INPUT_RECORD_TYPE	Record type identifier, which is always set to PLC.	1, 2, 3, 4	string(8)
INTERVAL	Interval (in seconds) when information is collected.	1, 2, 3, 4	ulong
PHYSICAL_CAPACITY_FREE	Total amount of free capacity in the physical capacity of the parity groups that make up the pool (GB).^{3, 5}	1, 2, 3, 4	double
PHYSICAL_CAPACITY_TOTAL	Total amount of the physical capacity of the parity groups that make up the pool (GB). If the pool is being expanded by adding drives to a DDP (Dynamic Drive Protection) parity group, the total capacity after the expansion is displayed, not the effective capacity.	1, 2, 3, 4	double
PHYSICAL_CAPACITY_USAGE_RATE	Usage percentage of the physical capacity of the parity groups that make up the pool. The value is calculated based on the following formula: (PHYSICAL_CAPACITY_USED / PHYSICAL_CAPACITY_TOTAL) * 100 However, if the pool is being expanded by adding drives to a DDP (Dynamic Drive Protection) parity group, the value is calculated as (PHYSICAL_CAPACITY_USED / effective capacity of the pool) * 100. For the Dynamic Provisioning pool that stores Thin Image or Thin Image Advanced snapshot data, the value includes the capacity of the snapshot data of the Thin Image pair or Thin Image Advanced pair using the pool.	1, 2, 3, 4	float
PHYSICAL_CAPACITY_USED	Total amount of used capacity in the physical capacity of the parity groups that make up the pool (GB).⁵ For the Dynamic Provisioning pool that stores Thin Image or Thin Image Advanced snapshot data, the value includes the capacity of the snapshot data of the Thin Image pair or Thin Image Advanced pair using the pool.	1, 2, 3, 4	double
PHYSICAL_FMC_CAPACITY_TOTAL¹⁸	The total physical capacity of the pool volume for FMC or the pool volume that supports accelerated compression used in the pool (GB).²	1, 2, 3, 4	double
PHYSICAL_FMC_CAPACITY_USED	The actually used capacity of the parity group for FMC or the parity group that supports accelerated compression (GB).²	1, 2, 3, 4	double
POOL_CAPACITY_EXPANSION_RATE	Expansion percentage of the pool capacity by using accelerated compression.⁶	1, 2, 3, 4	float
POOL_ID	ID of the pool.	1, 2, 3, 4	string(8)
POOL_NAME	Pool name.	1, 2, 3, 4	string(64)
POOL_VOLUME_COUNT	Number of pool volumes in the pool.	1, 2, 3, 4	ulong
RECORD_TIME	Time (in GMT) when the record was stored.	1, 2, 3, 4	time_t
RESERVED_CAPACITY	The capacity for the reserved pages in the pool (GB).⁴	1, 2	double
SAVING_CAPACITY¹⁸	The capacity saved by capacity saving or accelerate compression of the parity group (GB).^{17, 19}	1, 2, 3, 4	double
SAVING_RATIO¹⁸	Saving effect achieved by capacity saving or accelerate compression of the parity group. This is the value of N when the ratio of capacity before and after the reduction is N:1.^{20, 22}	1, 2, 3, 4	float
STATUS	Status of the pool: NORMAL (the status is normal) WARNING (the usage rate of the pool capacity has exceeded the value of the THRESHOLD field or the WARNING_THRESHOLD field) BLOCKED (the usage rate of the pool capacity is 100%, and the pool is blocked)	1, 2, 3, 4	string(64)
THRESHOLD	System threshold or depletion threshold set for the percentage of used pool space.⁷	1, 2, 3, 4	float
TOTAL_ACTUAL_CAPACITY	Capacity of the pool (GB). If the pool is being expanded by adding drives to a DDP (Dynamic Drive Protection) parity group, the total capacity after the expansion is displayed, not the effective capacity.^{4, 8}	1, 2, 3, 4	double
TOTAL_MANAGED_CAPACITY	Virtual capacity of all Dynamic Provisioning V- VOLs mapped to the pool (GB).⁴ For the Dynamic Provisioning pool that stores Thin Image or Thin Image Advanced snapshot data, the reserved capacity of the snapshot data of the Thin Image pair or Thin Image Advanced pair using the pool will be added.	1, 2, 3, 4	double
USAGE_RATE	Usage rate of the pool capacity.⁴ The value is calculated based on the following formula: (USED_CAPACITY / TOTAL_ACTUAL_CAPACITY) * 100 However, if the pool is being expanded by adding drives to a DDP (Dynamic Drive Protection) parity group, the value is calculated as (USED_CAPACITY / effective capacity of the pool) * 100. For the Dynamic Provisioning V-VOLs for which pool areas are reserved, the percentage includes the capacity for the reserved pages. For the Dynamic Provisioning pool that stores Thin Image or Thin Image Advanced snapshot data, the value includes the capacity of the snapshot data of the Thin Image pair or Thin Image Advanced pair using the pool.	1, 2, 3, 4	float
USED_CAPACITY	Amount of pool capacity that is actually being used (GB).^{4, 9} The value is calculated based on the following formula: TOTAL_ACTUAL_CAPACITY - FREE_CAPACITY However, if the pool is being expanded by adding drives to a DDP (Dynamic Drive Protection) parity group, the value is calculated as effective capacity of the pool - FREE_CAPACITY. For the Dynamic Provisioning V-VOLs for which pool areas are reserved, the value includes the capacity for the reserved pages. For the Dynamic Provisioning pool that stores Thin Image or Thin Image Advanced snapshot data, the value includes the capacity of the snapshot data of the Thin Image pair or Thin Image Advanced pair using the pool.	1, 2, 3, 4	double
VIRTUAL_VOLUME_COUNT	Number of Dynamic Provisioning V-VOLs mapped to the pool.	1, 2, 3, 4	ulong
WARNING_THRESHOLD	User-defined threshold or warning threshold set for the percentage of used pool space.⁷	1, 2, 3, 4	float
Notes: The amount is stored only when the capacity saving function (deduplication and compression) is enabled. In other cases, the amount is 0. The amount is stored only when the pool contains a parity group for which accelerated compression is also enabled. In other cases, the amount is 0. If the capacity saving function (deduplication and compression) is enabled, the amount represents the capacity after the capacity size is reduced. If the pool contains a parity group for which accelerated compression is also enabled, the amount includes the capacity of the expanded area. If the pool is being expanded by adding drives to a DDP (Dynamic Drive Protection) parity group, the free capacity and usage rate of the pool will be displayed based on the effective capacity. This value is differs from the device capacity information that is recognized by the host because this capacity information is managed by the storage system. If the pool contains a parity group for which accelerated compression is also enabled, the value is after compression. If the number of pool volumes created from parity groups that support the accelerated compression function is less than the physical capacity of those parity groups, the value is always 100. If no parity group supports the accelerated compression function, the value is 0. For the values to be displayed, see the manual of the storage system being used. If the pool contains a parity group for which accelerated compression is also enabled, the value is the amount that includes the capacity of the expanded area. If the settings of the capacity saving function (deduplication and compression) are enabled, the amount is the amount actually used after the size of the capacity is reduced. Note that if the pool contains a parity group for which accelerated compression is also enabled, the value does not include the compressed amount. For both 0x00 and 0x02, the deduplication function is disabled. The capacity used by the deduplication system data volume is not included. The saved amount does not include the amount of metadata and garbage data. The saved capacity includes the amount of zero data reduction, metadata, and garbage data. If you are using VSP G200, G400, G600, G800, VSP F400, F600, F800, VSP G1000 (earlier than version 80-06-21), G1500 (earlier than version 80-06-21), or VSP F1500 (earlier than version 80-06-21), the saved capacity does not includes the amount of zero data reduction, metadata, and garbage data. When the capacity saving function (deduplication and compression) is used, the saving ratio is calculated against the amount of metadata and garbage data generated internally in addition to user data. The compressed capacity with the accelerated compression function for VSP G200, G400, G600, G800, VSP F400, F600, F800, VSP G1000 (earlier than version 80-06-21), G1500 (earlier than version 80-06-21), or VSP F1500 (earlier than version 80-06-21). If the `Access Type` is `3` or `4`, the compressed capacity with the accelerated compression function for VSP G350, G370, G700, G900, VSP F350, F370, F700, F900 (earlier than version 88-03-01). Reduction rate (%) of capacity compressed by the accelerated compression function for VSP G200, G400, G600, G800, VSP F400, F600, F800, VSP G1000 (earlier than version 80-06-21), G1500 (earlier than version 80-06-21), or VSP F1500 (earlier than version 80-06-21). If the `Access Type` is `3` or `4`, reduction rate (%) of capacity compressed by the accelerated compression function for VSP G350, G370, G700, G900, VSP F350, F370, F700, F900 (earlier than version 88-03-01). The saved capacity includes the amount of zero data reduction, metadata, garbage data, metadata reduction, and garbage data reduction. This value is -1 for VSP G200, VSP G400, VSP G600, VSP G800, VSP F400, VSP F600, VSP F800, VSP G1000 (earlier than version 80-06-21) , VSP G1500 (earlier than version 80-06-21) , or VSP F1500 (earlier than version 80-06-21). If the capacity after the reduction becomes larger than the capacity before the reduction, the value is -2, which indicates an invalid value. If the data reduction function is disabled or the timing is just after a pool is created or a volume is deleted, the value might be -2 which indicates an invalid value. If the reduction is highly effective (the capacity after the reduction is close to 0), the value will be 99999. The saved capacity includes the amount of metadata reduction and garbage data reduction. When the data reduction function is used, the saving ratio is calculated against the amount of metadata, garbage data and parity data generated internally in addition to user data. This value cannot be obtained for VSP G200, VSP G400, VSP G600, VSP G800, VSP F400, VSP F600, VSP F800, VSP G1000 (earlier than version 80-06-41) , VSP G1500 (earlier than version 80-06-41) , and VSP F1500 (earlier than version 80-06-41).