Skip to main content

Dell PowerVault ME4 Series Storage System CLI Guide

PDF

show pool-statistics


Description	Shows live or historical performance statistics for virtual pools. For pool performance statistics, the system samples live data every 30 seconds and historical data every 5 minutes, and retains historical data for 6 months. The historical option allows you to specify a time range or a number (count) of data samples to include. It is not recommended to specify both the time-range and count parameters. If both parameters are specified, and more samples exist for the specified time range, the samples' values will be aggregated to show the required number of samples. Statistics shown only in API output are described in API basetype properties.
Minimum role	monitor
Syntax	To show live statistics: show pool-statistics [pools `pool`] [tier performance\|standard\|archive\|readcache] To show historical statistics: show pool-statistics [all] [count `number-of-data-samples`] [filename `filename`.csv] historical [pools `pool`] [tier performance\|standard\|archive\|readcache] [time-range "`date/time-range`"]
Parameters	all Optional. Specifies to show the full set of performance metrics. If this parameter is omitted, the default set of performance metrics will be shown. count number-of-data-samples Optional. Specifies the number of data samples to display, from 1 to 100. Each sample will be shown as a separate row in the command output. If this parameter is omitted, 100 samples will be shown. If you specify this parameter, do not specify the time-range parameter. filename `filename`.csv Optional. Specifies to save historical statistics, in CSV format, to a file on the controller. To access the file, use SFTP or FTP. historical Optional. Specifies to show historical statistics. If this parameter is omitted, live statistics will be shown. pools `pool` Optional. Specifies the name or serial number of the virtual pool for which to show information. If this parameter is omitted, information will be shown for both pools A and B. A name that includes a space must be enclosed in double quotes. tier performance\|standard\|archive\|readcache Optional. Specifies the tier for which to show statistics. time-range "`date/time-range`" Optional. Specifies the date/time range of historical statistics to show, in the format "start `yyyy-mm-dd` `hh`:`mm`[AM\| PM] end `yyyy-mm-dd` `hh`:`mm`[AM\|PM]". If the start date/time is specified but no end date/time is specified, the current date/time will be used as the end date/time. The system will return the oldest sample taken after the start time and the latest sample taken before the end time. If the specified start date/time is earlier than the oldest sample, that sample will be used as the start date/time. If you specify this parameter, do not specify the count parameter. If this parameter is omitted, the most recent 100 data samples will be displayed. disks Optional. Specifies a comma-separated list of disks for which to show information. If this parameter is omitted, information will be shown for all disks. For disk syntax, see Command syntax.
Output	Live Pool The name of the pool. Pages Allocated per Min The rate, in pages per minute, at which pages are allocated to volumes in the pool because they need more space to store data. Pages Deallocated per Min The rate, in pages per minute, at which pages are deallocated from volumes in the pool because they no longer need the space to store data. Pages Unmapped per Minute The number of 4 MB pages that host systems have unmapped per minute, through use of the SCSI UNMAP command, to free storage space as a result of deleting files or formatting volumes on the host. Time Since Reset The amount of time, in seconds, since these statistics were last reset, either by a user or by a controller restart. Reads The number of read operations since these statistics were last reset or since the controller was restarted. Writes The number of write operations since these statistics were last reset or since the controller was restarted. Data Read The amount of data read since these statistics were last reset or since the controller was restarted. Data Written The amount of data written since these statistics were last reset or since the controller was restarted. Bps The data transfer rate, in bytes per second, calculated over the interval since these statistics were last requested or reset. This value will be zero if it has not been requested or reset since a controller restart. IOPS The number of input/output operations per second, calculated over the interval since these statistics were last requested or reset. This value will be zero if it has not been requested or reset since a controller restart. I/O Resp Time The average response time, in microseconds, for read and write operations since the last sampling time. Read Resp Time Shown by the <codeph>all</codeph> parameter. The average response time, in microseconds, for read operations since the last sampling time. Write Resp Time Shown by the <codeph>all</codeph> parameter. The average response time, in microseconds, for write operations since the last sampling time. Historical For a pool: Pool The name of the pool. Total I/Os The total number of read and write operations since the last sampling time. Reads Shown by the <codeph>all</codeph> parameter. The number of read operations since the last sampling time. Writes Shown by the <codeph>all</codeph> parameter. The number of write operations since the last sampling time. Data Transferred The total amount of data read and written since the last sampling time. Data Read Shown by the <codeph>all</codeph> parameter. The amount of data read since the last sampling time. Data Written Shown by the <codeph>all</codeph> parameter. The amount of data written since the last sampling time. Total IOPS The total number of read and write operations per second since the last sampling time. Read IOPS Shown by the <codeph>all</codeph> parameter. The number of read operations per second since the last sampling time. Write IOPS Shown by the <codeph>all</codeph> parameter. The number of write operations per second since the last sampling time. Total B/s The total data transfer rate, in bytes per second, since the last sampling time. Read B/s Shown by the <codeph>all</codeph> parameter. The data transfer rate, in bytes per second, for read operations since the last sampling time. Write B/s Shown by the <codeph>all</codeph> parameter. The data transfer rate, in bytes per second, for write operations since the last sampling time. Allocated Pages The number of 4 MB pages allocated to volumes in the pool. Sample Time Date and time, in the format `year-month-day hour:minutes:seconds`, when the data sample was taken. For each tier in the pool: Pool The name of the pool. Tier The name of the tier. Total I/Os, Reads, Writes, Data Transferred, Data Read, Data Written, Total IOPS, Read IOPS, Write IOPS, Total B/s, Read B/s, Write B/s As described for a pool, above. Allocated Pages The number of 4 MB pages allocated to volumes in the tier. Page Moves In The number of pages moved into this tier from a different tier. Page Moves Out The number of pages moved out of this tier to other tiers. Page Rebalances The number of pages moved between disks in this tier to automatically load balance. Initial Allocations The number of 4 MB pages that are allocated as a result of host writes. This number does not include pages allocated as a result of background tiering page movement. (Tiering moves pages from one tier to another, so one tier will see a page deallocated, while another tier will show pages allocated. These background moves are not considered initial allocations.) Unmaps The number of 4 MB pages that are automatically reclaimed and deallocated because they are empty (they contain only zeroes for data). RC Copies The number of 4 MB pages copied from spinning disks to SSD read cache (read flash cache). Zero-Pages Reclaimed The number of empty (zero-filled) pages that were reclaimed during this sample period. Sample Time Date and time, in the format `year-month-day hour:minutes:seconds`, when the data sample was taken.
Examples	Show live statistics for both pools. # show pool-statistics Show historical statistics from a specified date and time range for pool A. # show pool-statistics pools A historical time-range "start 2014-06-01 4:40 PM end 2014-06-01 5:00 PM" Show all samples of historical statistics for the Standard tier in pool A. # show pool-statistics historical all pools A tier standard
Basetypes	pool-statistics (live) resettable-statistics (live) tier-statistics (live) pool-summary (historical) pool-hist-statistics (historical) tier-summary (historical) tier-hist-statistics (historical) readcache-hist-statistics (historical) status
See also	reset all-statistics reset pool-statistics show pools