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

lssystemstats [ -nohdr ] [ -delim delimiter ] [ -filtervalue attribute=value ] [ -filtervalue? ] [ { -history stat_list } ]

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.
-delimdelimiter
(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.
-filtervalueattribute=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 -filtervalueattribute=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.
Table 1. lssystemstats attribute values
Attribute Value
stat_current The current value of the statistic field.
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.
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.

Table 2. Stat_name field values
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 milliseconds 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 milliseconds 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 milliseconds 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 milliseconds 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 milliseconds 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 milliseconds 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 milliseconds 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 milliseconds 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 milliseconds that the system takes to respond to read requests to drives over the sample period.
power_w Displays the power that is used 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_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 milliseconds) 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 milliseconds) it takes for the system to respond to download requests to a cloud account during the sample period.

A system summary invocation example

lssystemstats

The resulting output:

stat_name      stat_current stat_peak stat_peak_time 
cpu_pc         5            6         111123104304   
fc_mb          321          327       111123104129   
fc_io          2167         2368      111123103904   
sas_mb         438          534       111123104104   
sas_io         5784         7738      111123104314   
iscsi_mb       0            0         111123104359   
iscsi_io       0            0         111123104359   
write_cache_pc 0            0         111123104359   
total_cache_pc 0            0         111123104359   
vdisk_mb       321          326       111123104129   
vdisk_io       2070         2276      111123103904   
vdisk_ms       34           52        111123103954   
mdisk_mb       320          329       111123104029   
mdisk_io       3135         3340      111123103904   
mdisk_ms       15           24        111123104314   
drive_mb       440          534       111123104104   
drive_io       5765         6572      111123104104   
drive_ms       14           21        111123104314   
vdisk_r_mb     174          178       111123104324   
vdisk_r_io     1064         1180      111123103904   
vdisk_r_ms     31           53        111123103954   
vdisk_w_mb     146          159       111123104129   
vdisk_w_io     1006         1160      111123104129   
vdisk_w_ms     38           54        111123104314   
mdisk_r_mb     172          177       111123104259   
mdisk_r_io     2054         2184      111123103904   
mdisk_r_ms     11           18        111123103954   
mdisk_w_mb     146          160       111123104129   
mdisk_w_io     1081         1229      111123104129   
mdisk_w_ms     25           38        111123104314   
drive_r_mb     207          356       111123104329   
drive_r_io     2940         3952      111123104104   
drive_r_ms     11           18        111123104314   
drive_w_mb     231          250       111123104129   
drive_w_io     2825         3156      111123104129   
drive_w_ms     16           24        111123104314  
iplink_mb      0            1         130711190446
iplink_io      0            10        130711190446
iplink_comp_mb      0           250        151014133723 
power_w        12300        12354     120402111338
temp_c         33           35        120402111333
temp_f         97           95        120402111333cloud_up_mb    0            0         161118051715
cloud_up_ms    0            0         161118051715
cloud_down_mb  0            0         161118051715
cloud_down_ms  0            0         161118051715

A filtered system summary invocation example

lssystemstats -filtervalue stat_name=cpu_pc:stat_name=fc_mb -delim :

The resulting output:

The filtered system summary output:
stat_name:stat_current:stat_peak:stat_peak_time
cpu_pc:5:7:111123104547
fc_mb:319:339:111123104517

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 
111123104224 fc_io     2120       
111123104229 fc_io     2102       
111123104234 fc_io     2041       
111123104239 fc_io     2211       
111123104244 fc_io     2204       
111123104249 fc_io     2046       
111123104254 fc_io     1997       
111123104259 fc_io     2081       
111123104304 fc_io     2123       
111123104309 fc_io     2030       
111123104314 fc_io     1754       
111123104319 fc_io     1640       
111123104324 fc_io     1759       
111123104329 fc_io     1638       
111123104334 fc_io     1804       
111123104339 fc_io     2011       
111123104344 fc_io     2028       
111123104349 fc_io     2171       
111123104354 fc_io     2055       
111123104359 fc_io     2167       
111123104404 fc_io     2140       
111123104409 fc_io     2111