lssystemstats

Use the lssystemstats command to display the most recent values of all node canister statistics in a clustered system (system), or to display a history of values for a given subset of available statistics across all node canisters in a system. This command also can be used to display a history of values for a given subset of available statistics.

Syntax

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

Parameters

-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 possible 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 one-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 canister statistical values, specific node canister statistical values, or historical data for any node canister.

Description

This command returns one set of statistics for all the node canisters in the system. The statistical values are determined using samples received from each canister.

Note: Values are rounded to the nearest integer when appropriate (for example, between one and ninety-nine when considering percentages).

Table 1 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 five 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 using the concise view.

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

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

Table 2 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 utilized for compression.
cpu_pc	Displays the percentage of allocated CPU capacity utilized 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 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 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 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 amount of I/O operations 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 amount of I/O operations 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 amount of I/O operations 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 amount of I/O operations 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 amount of I/O operations 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 amount of I/O operations 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 amount of I/O operations 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 amount of I/O operations 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 amount of I/O operations 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.
iplink_mb	The total number of megabytes transferred per second (MBps) for Internet Protocol (IP) replication traffic on the system. This value does not include iSCSI host input/output (I/O) operations.
iplink_io	The total input/output (I/O) operations transferred per second for IP partnership traffic on the system. This value does not include Internet Small Computer System Interface (iSCSI) host I/O operations.