lsnodecanisterstats

The lsnodecanisterstats command displays the most recent values of all node canister statistics, and displays all node canister statistics for a particular canister. This command also can be used to display a history of values for a given subset of available statistics.

Syntax

lsnodecanisterstats [ -delimdelimiter ] [ -filtervalueattribute=value ] [ -filtervalue? ] [ { -history stat_list | [ ] } { node_canister_id | nodecanister_name } ]

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.
-history stat_list: (Optional) Provides the most recent node canister statistical values, specific canister statistical values, or historical data for any canister.
nodecanister_id | nodecanister_name: (Optional) Identifies the node canister for which you want to request statistics.

Description

This command returns a concise list or a detailed view of node canisters that are part of the clustered system. Table 1 provides the possible values that are applicable to the attributes that are displayed as data in the output views.

Table 1. Node canister attribute values
Attribute	Value
nodecanister_id	The ID of the node canister.
nodecanister_name	The name of the node canister.
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.

Note: Filtering is supported on nodecanister_id, nodecanister_name, and stat_name fields using the concise view.

Output from the lsnodecanisterstats example

node_id node_name stat_name      stat_current stat_peak stat_peak_time 
1       node1     cpu_pc         5            9         111123105330   
1       node1     fc_mb          218          238       111123105440   
1       node1     fc_io          1122         1501      111123105435   
1       node1     sas_mb         282          402       111123105335   
1       node1     sas_io         3129         4427      111123105335   
1       node1     iscsi_mb       0            0         111123105825   
1       node1     iscsi_io       0            0         111123105825   
1       node1     write_cache_pc 0            0         111123105825   
1       node1     total_cache_pc 0            0         111123105825   
1       node1     vdisk_mb       218          238       111123105440   
1       node1     vdisk_io       1076         1452      111123105435   
1       node1     vdisk_ms       52           60        111123105605   
1       node1     mdisk_mb       218          238       111123105435   
1       node1     mdisk_io       1874         2386      111123105435   
1       node1     mdisk_ms       15           33        111123105605   
1       node1     drive_mb       281          401       111123105335   
1       node1     drive_io       3130         4060      111123105335   
1       node1     drive_ms       13           27        111123105605   
1       node1     vdisk_r_mb     134          157       111123105440   
1       node1     vdisk_r_io     561          885       111123105430   
1       node1     vdisk_r_ms     37           45        111123105605   
1       node1     vdisk_w_mb     84           89        111123105700   
1       node1     vdisk_w_io     515          587       111123105625   
1       node1     vdisk_w_ms     67           84        111123105330   
1       node1     mdisk_r_mb     133          155       111123105510   
1       node1     mdisk_r_io     1337         1789      111123105435   
1       node1     mdisk_r_ms     15           33        111123105605   
1       node1     mdisk_w_mb     84           89        111123105700   
1       node1     mdisk_w_io     536          611       111123105625   
1       node1     mdisk_w_ms     17           32        111123105605   
1       node1     drive_r_mb     151          295       111123105335   
1       node1     drive_r_io     1700         2904      111123105335   
1       node1     drive_r_ms     14           30        111123105605   
1       node1     drive_w_mb     130          137       111123105700   
1       node1     iplink_mb      0            1         130523104536
1       node1     iplink_io      0            10        130523104536
1       node1     drive_w_io     1429         1586      111123105625   
1       node1     drive_w_ms     12           22        111123105605   
2       node2     cpu_pc         6            7         111123105624   
2       node2     fc_mb          132          145       111123105724   
2       node2     fc_io          1519         1944      111123105739   
2       node2     sas_mb         189          308       111123105619   
2       node2     sas_io         2737         4099      111123105614   
2       node2     iscsi_mb       0            0         111123105824   
2       node2     iscsi_io       0            0         111123105824   
2       node2     write_cache_pc 0            0         111123105824   
2       node2     total_cache_pc 0            0         111123105824   
2       node2     vdisk_mb       132          145       111123105724   
2       node2     vdisk_io       1459         1892      111123105739   
2       node2     vdisk_ms       47           81        111123105514   
2       node2     mdisk_mb       132          145       111123105724   
2       node2     mdisk_io       1635         2066      111123105739   
2       node2     mdisk_ms       8            18        111123105619   
2       node2     drive_mb       189          310       111123105619   
2       node2     drive_io       2735         3750      111123105619   
2       node2     drive_ms       9            20        111123105604   
2       node2     vdisk_r_mb     20           21        111123105809   
2       node2     vdisk_r_io     796          1180      111123105739   
2       node2     vdisk_r_ms     2            8         111123105529   
2       node2     vdisk_w_mb     112          134       111123105349   
2       node2     vdisk_w_io     662          805       111123105504   
2       node2     vdisk_w_ms     100          104       111123105624   
2       node2     mdisk_r_mb     20           21        111123105809   
2       node2     mdisk_r_io     951          1330      111123105739   
2       node2     mdisk_r_ms     2            7         111123105529   
2       node2     mdisk_w_mb     112          134       111123105349   
2       node2     mdisk_w_io     684          834       111123105504   
2       node2     mdisk_w_ms     16           36        111123105619   
2       node2     drive_r_mb     17           132       111123105619   
2       node2     drive_r_io     899          1920      111123105619   
2       node2     drive_r_ms     6            12        111123105344   
2       node2     drive_w_mb     171          206       111123105504   
2       node2     drive_w_io     1837         2230      111123105504   
2       node2     drive_w_ms     11           26        111123105619
2       node2     iplink_mb      0            1         130523104536
2       node2     iplink_io      0            10        130523104536

A node-based, filtered invocation example

lsnodecanisterstats -filtervalue stat_name=sas_io:stat_name=sas_mb node1

The node-based filtered example resulting output:

node_id node_name stat_name stat_current stat_peak stat_peak_time 
1       node1     sas_mb    212          421       111123105840   
1       node1     sas_io    2477         4184      111123105840

Historical view that can list multiple statistics and requires a node-based invocation

lsnodecanisterstats -history cpu_pc:fc_mb:sas_mb node1

The historical invocation resulting output:

node_id node_name sample_time  stat_name stat_value 
2       node2     111123105839 cpu_pc    6          
2       node2     111123105844 cpu_pc    5          
2       node2     111123105849 cpu_pc    5          
2       node2     111123105854 cpu_pc    5          
2       node2     111123105859 cpu_pc    6          
2       node2     111123105904 cpu_pc    5          
2       node2     111123105909 cpu_pc    5          
2       node2     111123105914 cpu_pc    5          
2       node2     111123105919 cpu_pc    5          
2       node2     111123105924 cpu_pc    5          
2       node2     111123105929 cpu_pc    5          
2       node2     111123105934 cpu_pc    5          
2       node2     111123105839 fc_mb     128        
2       node2     111123105844 fc_mb     126        
2       node2     111123105849 fc_mb     123        
2       node2     111123105854 fc_mb     142        
2       node2     111123105859 fc_mb     119        
2       node2     111123105904 fc_mb     131        
2       node2     111123105909 fc_mb     157        
2       node2     111123105914 fc_mb     177        
2       node2     111123105919 fc_mb     182        
2       node2     111123105924 fc_mb     182        
2       node2     111123105929 fc_mb     155        
2       node2     111123105934 fc_mb     177  
2       node2     111123105839 sas_mb    191        
2       node2     111123105844 sas_mb    191        
2       node2     111123105849 sas_mb    185        
2       node2     111123105854 sas_mb    216        
2       node2     111123105859 sas_mb    181        
2       node2     111123105904 sas_mb    198        
2       node2     111123105909 sas_mb    228        
2       node2     111123105914 sas_mb    243        
2       node2     111123105919 sas_mb    251        
2       node2     111123105924 sas_mb    248        
2       node2     111123105929 sas_mb    217        
2       node2     111123105934 sas_mb    242

Historical view that can list multiple statistics and requires a node-based invocation

lsnodecanisterstats -history cpu_pc:fc_mb:sas_mb node1

The historical invocation resulting output:

node_id node_name sample_time  stat_name stat_value 
2       node2     111123105839 cpu_pc    6          
2       node2     111123105844 cpu_pc    5          
2       node2     111123105849 cpu_pc    5          
2       node2     111123105854 cpu_pc    5          
2       node2     111123105859 cpu_pc    6          
2       node2     111123105904 cpu_pc    5          
2       node2     111123105909 cpu_pc    5          
2       node2     111123105914 cpu_pc    5          
2       node2     111123105919 cpu_pc    5          
2       node2     111123105924 cpu_pc    5          
2       node2     111123105929 cpu_pc    5          
2       node2     111123105934 cpu_pc    5          
2       node2     111123105839 fc_mb     128        
2       node2     111123105844 fc_mb     126        
2       node2     111123105849 fc_mb     123        
2       node2     111123105854 fc_mb     142        
2       node2     111123105859 fc_mb     119        
2       node2     111123105904 fc_mb     131        
2       node2     111123105909 fc_mb     157        
2       node2     111123105914 fc_mb     177        
2       node2     111123105919 fc_mb     182        
2       node2     111123105924 fc_mb     182        
2       node2     111123105929 fc_mb     155        
2       node2     111123105934 fc_mb     177  
2       node2     111123105839 sas_mb    191        
2       node2     111123105844 sas_mb    191        
2       node2     111123105849 sas_mb    185        
2       node2     111123105854 sas_mb    216        
2       node2     111123105859 sas_mb    181        
2       node2     111123105904 sas_mb    198        
2       node2     111123105909 sas_mb    228        
2       node2     111123105914 sas_mb    243        
2       node2     111123105919 sas_mb    251        
2       node2     111123105924 sas_mb    248        
2       node2     111123105929 sas_mb    217        
2       node2     111123105934 sas_mb    242

The following table provides the possible values that are applicable to the values that are displayed for stat_name attribute.

Table 2. Stat_name field values
Value	Description
cpu_pc	The total percentage of CPU utilization 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.
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.