lssystemstats
Use the lssystemstats command to display the most recent values of all node statistics in a system, or to display a history of values for a specified subset of available statistics across all nodes in a system. This command also can be used to display a history of values for a specified subset of available statistics.
Syntax
Parameters
- -nohdr
- (Optional) By default, headings are displayed for each column of
data in a concise style view, and for each item of data in a
detailed style view. The -nohdr parameter
suppresses the display of these headings.Note: If there is no data to be displayed, headings are not displayed.
- -delim delimiter
- (Optional) By default in a concise view, all columns of data are
space-separated. The width of each column is set to the maximum
width of each item of data. In a detailed view, each item of data
has its own row, and if the headers are displayed, the data is
separated from the header by a space. The
-delim parameter overrides this behavior.
Valid input for the -delim parameter is a
1-byte character. If you enter
-delim :on the command line, the colon character (:) separates all items of data in a concise view; for example, the spacing of columns does not occur. In a detailed view, the data is separated from its header by the specified delimiter. - -filtervalue attribute=value
- (Optional) Specifies a list of one or more filters. Only objects
with a value that matches the filter attribute value are displayed.
Note: Some filters allow the use of a wildcard when you enter the command. The following rules apply to the use of wildcards:
- The wildcard character is the asterisk (*).
- The command can contain a maximum of one wildcard.
- When you use a wildcard, enclose the filter entry within
double quotation marks (""):
lssystemstats -filtervalue stat_name="io*"
- -filtervalue?
- (Optional) Displays the valid filter attributes for the
-filtervalue
attribute=value parameter:
- stat_name
- -history stat_list
- Provides the most recent node statistical values, specific node statistical values, or historical data for any node.
Description
This
command returns one set of statistics for all the nodes in the system.
The statistical values are determined by using samples that are received
from each node.
Note: Values are rounded to the nearest integer when
appropriate (for example, between one and ninety-nine for
percentages).
This table provides the attribute values
that can be displayed as output view data.
| Attribute | Value |
|---|---|
| stat_current | The current value of the statistic field. The value is accurate up to 3 decimal places (microseconds). |
| stat_list | The system history of the reported statistics. |
| stat_name | The name of the statistic field. |
| stat_peak | The peak value of the statistic field in the last 5 minutes. The value is accurate up to 3 decimal places (microseconds). |
| stat_peak_time | The time that the peak occurred. |
| sample_time | The time of the sample occurrence. |
| stat_value | The statistical value at the epoch interval. |
Remember: Filtering is supported on the
stat_name field by using the concise
view.This table provides the possible values that are applicable to the values that are displayed for the stat_name attribute.
| Value | Description |
|---|---|
| compression_cpu_pc | Displays the percentage of allocated CPU capacity that is used for compression. |
| cpu_pc | Displays the percentage of allocated CPU capacity that is used for the system. |
| fc_mb | Displays the total number of megabytes transferred per second (MBps) for Fibre Channel traffic on the system. This value includes host I/O and any bandwidth that is used for communication within the system. |
| fc_io | Displays the total input/output (I/O) operations that are transferred per seconds for Fibre Channel traffic on the system. This value includes host I/O and any bandwidth that is used for communication within the system. |
| sas_mb | Displays the total number of megabytes transferred per second (MBps) for serial-attached SCSI (SAS) traffic on the system. This value includes host I/O and bandwidth that is used for background RAID activity. |
| sas_io | Displays the total I/O operations that are transferred per second for SAS traffic on the system. This value includes host I/O and bandwidth that is used for background RAID activity. |
| iscsi_mb | Displays the total number of megabytes transferred per second (MBps) for iSCSI traffic on the system. |
| iscsi_io | Displays the total I/O operations that are transferred per second for iSCSI traffic on the system. |
| write_cache_pc | Displays the percentage of the write cache usage for the node. |
| total_cache_pc | Displays the total percentage for both the write and read cache usage for the node. |
| vdisk_mb | Displays the average number of megabytes
transferred per second (MBps) for read and write operations to
volumes during the sample period. Note: Only the write
operation value is displayed.
|
| vdisk_io | Displays the average number of I/O operations that are transferred per second for read and write operations to volumes during the sample period. |
| vdisk_ms | Displays the average amount of time in microseconds that the system takes to respond to read and write requests to volumes over the sample period. |
| mdisk_mb | Displays the average number of megabytes transferred per second (MBps) for read and write operations to MDisks during the sample period. |
| mdisk_io | Displays the average number of I/O operations that are transferred per second for read and write operations to MDisks during the sample period. |
| mdisk_ms | Displays the average amount of time in microseconds that the system takes to respond to read and write requests to MDisks over the sample period. |
| drive_mb | Displays the average number of megabytes transferred per second (MBps) for read and write operations to drives during the sample period. |
| drive_io | Displays the average number of I/O operations that are transferred per second for read and write operations to drives during the sample period. |
| drive_ms | Displays the average amount of time in microseconds that the system takes to respond to read and write requests to drives over the sample period. |
| vdisk_w_mb | Displays the average number of megabytes transferred per second (MBps) for read and write operations to volumes during the sample period. |
| vdisk_w_io | Displays the average number of I/O operations that are transferred per second for write operations to volumes during the sample period. |
| vdisk_w_ms | Displays the average amount of time in microseconds that the system takes to respond to write requests to volumes over the sample period. |
| mdisk_w_mb | Displays the average number of megabytes transferred per second (MBps) for write operations to MDisks during the sample period. |
| mdisk_w_io | Displays the average number of I/O operations that are transferred per second for write operations to MDisks during the sample period. |
| mdisk_w_ms | Displays the average amount of time in microseconds that the system takes to respond to write requests to MDisks over the sample period. |
| drive_w_mb | Displays the average number of megabytes transferred per second (MBps) for write operations to drives during the sample period. |
| drive_w_io | Displays the average number of I/O operations that are transferred per second for write operations to drives during the sample period. |
| drive_w_ms | Displays the average amount of time in microseconds that the system takes to respond write requests to drives over the sample period. |
| vdisk_r_mb | Displays the average number of megabytes transferred per second (MBps) for read operations to volumes during the sample period. |
| vdisk_r_io | Displays the average number of I/O operations that are transferred per second for read operations to volumes during the sample period. |
| vdisk_r_ms | Displays the average amount of time in microseconds that the system takes to respond to read requests to volumes over the sample period. |
| mdisk_r_mb | Displays the average number of megabytes transferred per second (MBps) for read operations to MDisks during the sample period. |
| mdisk_r_io | Displays the average number of I/O operations that are transferred per second for read operations to MDisks during the sample period. |
| mdisk_r_ms | Displays the average amount of time in microseconds that the system takes to respond to read requests to MDisks over the sample period. |
| drive_r_mb | Displays the average number of megabytes transferred per second (MBps) for read operations to drives during the sample period |
| drive_r_io | Displays the average number of I/O operations that are transferred per second for read operations to drives during the sample period. |
| drive_r_ms | Displays the average amount of time in microseconds that the system takes to respond to read requests to drives over the sample period. |
| power_w | Displays the total system power in watts. |
| temp_c | Displays the ambient temperature in Celsius. |
| temp_f | Displays the ambient temperature in Fahrenheit. |
| iplink_mb | Displays the average number of megabytes requested to be transferred per second (MBps) over the IP partnership link during the sample period. This value is calculated before any compression of the data takes place. This value does not include iSCSI host input/output (I/O) operations. |
| iplink_io | Displays the total input or output (I/O) operations transferred per second for IP Replication traffic on the system. This value does not include iSCSI host I/O. |
| iplink_comp_mb | Displays the average number of compressed
megabytes transferred per second (MBps) over the IP
Replication link during the sample period. This value is
calculated after any compression of |the data takes place.
This value does not include iSCSI host I/O operations.
Note: If compression is disabled, the
iplink_mb
stats ID value is displayed
instead. |
| cloud_up_mb | Displays the average number of megabytes transferred per second (Mbps) for upload operations to a cloud account during the sample period. |
| cloud_up_ms | Displays the average amount of time (in microseconds) it takes for the system to respond to upload requests to a cloud account during the sample period. |
| cloud_down_mb | Displays the average number of Mbps for download operations to a cloud account during the sample period. |
| cloud_down_ms | Displays the average amount of time (in microseconds) it takes for the system to respond to download requests to a cloud account during the sample period. |
| iser_io | Displays the total I/O operations that are transferred per second for iSER traffic on the system. |
| iser_mb | Displays the total number of megabytes transferred per second (MBps) for iSER traffic on the system. |
A system summary invocation example
lssystemstats
The resulting output:
stat_name stat_current stat_peak stat_peak_time
compression_cpu_pc 0 0 230221121606
cpu_pc 5 5 230221121606
fc_mb 0 0 230221121606
fc_io 0 0 230221121606
sas_mb 0 0 230221121606
sas_io 0 0 230221121606
iscsi_mb 0 0 230221121606
iscsi_io 0 0 230221121606
write_cache_pc 0 0 230221121606
total_cache_pc 79 79 230221121606
vdisk_mb 0 0 230221121606
vdisk_io 0 0 230221121606
vdisk_ms 0.000 0.000 230221121606
mdisk_mb 0 0 230221121606
mdisk_io 0 0 230221121606
mdisk_ms 0.000 0.000 230221121606
drive_mb 56 101 230221121221
drive_io 225 409 230221121221
drive_ms 0.507 0.690 230221121546
vdisk_r_mb 0 0 230221121606
vdisk_r_io 0 0 230221121606
vdisk_r_ms 0.000 0.000 230221121606
vdisk_w_mb 0 0 230221121606
vdisk_w_io 0 0 230221121606
vdisk_w_ms 0.000 0.000 230221121606
mdisk_r_mb 0 0 230221121606
mdisk_r_io 0 0 230221121606
mdisk_r_ms 0.000 0.000 230221121606
mdisk_w_mb 0 0 230221121606
mdisk_w_io 0 0 230221121606
mdisk_w_ms 0.000 0.000 230221121606
drive_r_mb 56 101 230221121221
drive_r_io 225 409 230221121221
drive_r_ms 0.507 0.690 230221121546
drive_w_mb 0 0 230221121606
drive_w_io 0 5 230221121511
drive_w_ms 0.000 0.035 230221121211
power_w 1004 1031 230221121241
temp_c 19 21 230221121206
temp_f 66 69 230221121206
iplink_mb 0 0 230221121606
iplink_io 0 0 230221121606
iplink_comp_mb 0 0 230221121606
cloud_up_mb 0 0 230221121606
cloud_up_ms 0 0 230221121606
cloud_down_mb 0 0 230221121606
cloud_down_ms 0 0 230221121606
iser_mb 0 0 230221121606
iser_io 0 0 230221121606
A filtered system summary invocation example
lssystemstats -filtervalue stat_name=cpu_pc:stat_name=fc_mb -delim :
The resulting output:
stat_name:stat_current:stat_peak:stat_peak_time
cpu_pc:3:16:211021143723
fc_mb:167:367:211021143628
A historical view-based system summary invocation example
lssystemstats -history fc_io
The resulting partial output for the historical system summary example:
sample_time stat_name stat_value
211021143413 fc_io 10020
211021143418 fc_io 9007
211021143423 fc_io 8586
211021143428 fc_io 11240
211021143433 fc_io 10831
211021143438 fc_io 9106
211021143443 fc_io 7477
211021143448 fc_io 6805
211021143453 fc_io 7069
211021143458 fc_io 6253
211021143503 fc_io 5261
211021143508 fc_io 6289
211021143513 fc_io 8390
211021143518 fc_io 8951
211021143523 fc_io 9215
211021143528 fc_io 7570
211021143533 fc_io 7355
211021143538 fc_io 7626
211021143543 fc_io 6511
211021143548 fc_io 6989
211021143553 fc_io 7142
211021143558 fc_io 7186
211021143603 fc_io 7221
211021143608 fc_io 8720
211021143613 fc_io 10240
211021143618 fc_io 10297
211021143623 fc_io 10420
211021143628 fc_io 11930
211021143633 fc_io 10365
211021143638 fc_io 8272
211021143643 fc_io 7221
211021143648 fc_io 9124
211021143653 fc_io 6860
211021143658 fc_io 20907
211021143703 fc_io 17215
211021143708 fc_io 19740
211021143713 fc_io 21027
211021143718 fc_io 22432
211021143723 fc_io 24119
211021143728 fc_io 37802
211021143733 fc_io 40617
211021143738 fc_io 43118
211021143743 fc_io 42626
211021143748 fc_io 32575
211021143753 fc_io 725
211021143758 fc_io 722
211021143803 fc_io 724
211021143809 fc_io 716
211021143814 fc_io 719
211021143819 fc_io 726
211021143824 fc_io 705
211021143829 fc_io 706
211021143834 fc_io 720
211021143839 fc_io 717
211021143844 fc_io 707
211021143849 fc_io 710
211021143854 fc_io 711
211021143859 fc_io 707
211021143904 fc_io 712
211021143909 fc_io 710
A filtered system summary invocation example
lssystemstats -filtervalue stat_name=iser_io:stat_name=iser_mb -delim :
The resulting output:
stat_name:stat_current:stat_peak:stat_peak_time
iser_mb:0:0:211022114545
iser_io:0:0:211022114545