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 subset of available statistics.

Syntax

Read syntax diagramSkip visual syntax diagram lsnodecanisterstats -delimdelimiter-filtervalueattribute=value-filtervalue?-history stat_listnode_canister_idnodecanister_name

Parameters

-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.
-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. This table 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. 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 five 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.
Note: Filtering is supported on nodecanister_id, nodecanister_name, and stat_name fields by using the concise view.
The following 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
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 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.
vdisk_io Displays the average amount 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 amount 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 amount 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 amount 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 amount 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 amount 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 amount 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 amount 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 amount 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.

Output from the lsnodecanisterstats example

node_id node_name stat_name          stat_current stat_peak stat_peak_time
1       node1     compression_cpu_pc 0            0         211026055620
1       node1     cpu_pc             1            1         211026055620
1       node1     fc_mb              0            0         211026055620
1       node1     fc_io              5            5         211026055620
1       node1     sas_mb             0            0         211026055620
1       node1     sas_io             0            0         211026055620
1       node1     iscsi_mb           0            0         211026055620
1       node1     iscsi_io           0            0         211026055620
1       node1     write_cache_pc     0            0         211026055620
1       node1     total_cache_pc     0            0         211026055620
1       node1     vdisk_mb           0            0         211026055620
1       node1     vdisk_io           0            0         211026055620
1       node1     vdisk_ms           0.000        0.000     211026055620
1       node1     mdisk_mb           0            0         211026055620
1       node1     mdisk_io           0            0         211026055620
1       node1     mdisk_ms           0.000        0.000     211026055620
1       node1     drive_mb           0            0         211026055620
1       node1     drive_io           0            0         211026055620
1       node1     drive_ms           0.000        0.000     211026055620
1       node1     vdisk_r_mb         0            0         211026055620
1       node1     vdisk_r_io         0            0         211026055620
1       node1     vdisk_r_ms         0.000        0.000     211026055620
1       node1     vdisk_w_mb         0            0         211026055620
1       node1     vdisk_w_io         0            0         211026055620
1       node1     vdisk_w_ms         0.000        0.000     211026055620
1       node1     mdisk_r_mb         0            0         211026055620
1       node1     mdisk_r_io         0            0         211026055620
1       node1     mdisk_r_ms         0.000        0.000     211026055620
1       node1     mdisk_w_mb         0            0         211026055620
1       node1     mdisk_w_io         0            0         211026055620
1       node1     mdisk_w_ms         0.000        0.000     211026055620
1       node1     drive_r_mb         0            0         211026055620
1       node1     drive_r_io         0            0         211026055620
1       node1     drive_r_ms         0.000        0.000     211026055620
1       node1     drive_w_mb         0            0         211026055620
1       node1     drive_w_io         0            0         211026055620
1       node1     drive_w_ms         0.000        0.000     211026055620
1       node1     iplink_mb          0            0         211026055620
1       node1     iplink_io          0            0         211026055620
1       node1     iplink_comp_mb     0            0         211026055620
1       node1     cloud_up_mb        0            0         211026055620
1       node1     cloud_up_ms        0            0         211026055620
1       node1     cloud_down_mb      0            0         211026055620
1       node1     cloud_down_ms      0            0         211026055620
1       node1     iser_mb            0            0         211026055620
1       node1     iser_io            0            0         211026055620
2       node2     compression_cpu_pc 0            0         211026055618
2       node2     cpu_pc             1            1         211026055618
2       node2     fc_mb              0            0         211026055618
2       node2     fc_io              5            5         211026055618
2       node2     sas_mb             0            0         211026055618
2       node2     sas_io             0            0         211026055618
2       node2     iscsi_mb           0            0         211026055618
2       node2     iscsi_io           0            0         211026055618
2       node2     write_cache_pc     0            0         211026055618
2       node2     total_cache_pc     0            0         211026055618
2       node2     vdisk_mb           0            0         211026055618
2       node2     vdisk_io           0            0         211026055618
2       node2     vdisk_ms           0.000        0.000     211026055618
2       node2     mdisk_mb           0            0         211026055618
2       node2     mdisk_io           0            0         211026055618
2       node2     mdisk_ms           0.000        0.000     211026055618
2       node2     drive_mb           0            0         211026055618
2       node2     drive_io           0            0         211026055618
2       node2     drive_ms           0.000        0.000     211026055618
2       node2     vdisk_r_mb         0            0         211026055618
2       node2     vdisk_r_io         0            0         211026055618
2       node2     vdisk_r_ms         0.000        0.000     211026055618
2       node2     vdisk_w_mb         0            0         211026055618
2       node2     vdisk_w_io         0            0         211026055618
2       node2     vdisk_w_ms         0.000        0.000     211026055618
2       node2     mdisk_r_mb         0            0         211026055618
2       node2     mdisk_r_io         0            0         211026055618
2       node2     mdisk_r_ms         0.000        0.000     211026055618
2       node2     mdisk_w_mb         0            0         211026055618
2       node2     mdisk_w_io         0            0         211026055618
2       node2     mdisk_w_ms         0.000        0.000     211026055618
2       node2     drive_r_mb         0            0         211026055618
2       node2     drive_r_io         0            0         211026055618
2       node2     drive_r_ms         0.000        0.000     211026055618
2       node2     drive_w_mb         0            0         211026055618
2       node2     drive_w_io         0            0         211026055618
2       node2     drive_w_ms         0.000        0.000     211026055618
2       node2     iplink_mb          0            0         211026055618
2       node2     iplink_io          0            0         211026055618
2       node2     iplink_comp_mb     0            0         211026055618
2       node2     cloud_up_mb        0            0         211026055618
2       node2     cloud_up_ms        0            0         211026055618
2       node2     cloud_down_mb      0            0         211026055618
2       node2     cloud_down_ms      0            0         211026055618
2       node2     iser_mb            0            0         211026055618
2       node2     iser_io            0            0         211026055618

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    0            0         211026055735
1       node1     sas_io    0            0         211026055735

A node-based, filtered invocation example

lsnodecanisterstats -filtervalue stat_name=iser_io:stat_name=iser_mb node1

The node-based filtered example resulting output:

node_id node_name stat_name stat_current stat_peak stat_peak_time
1       node1     iser_mb   0            0         211026055800
1       node1     iser_io   0            0         211026055800

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
1       node1     211026055345 cpu_pc    1
1       node1     211026055350 cpu_pc    1
1       node1     211026055355 cpu_pc    1
1       node1     211026055400 cpu_pc    1
1       node1     211026055405 cpu_pc    1
1       node1     211026055410 cpu_pc    1
1       node1     211026055415 cpu_pc    1
1       node1     211026055420 cpu_pc    1
1       node1     211026055425 cpu_pc    1
1       node1     211026055430 cpu_pc    1
1       node1     211026055435 cpu_pc    1
1       node1     211026055440 cpu_pc    1
1       node1     211026055445 cpu_pc    1
1       node1     211026055450 cpu_pc    1
1       node1     211026055455 cpu_pc    1
1       node1     211026055500 cpu_pc    1
1       node1     211026055505 cpu_pc    1
1       node1     211026055510 cpu_pc    1
1       node1     211026055515 cpu_pc    1
1       node1     211026055520 cpu_pc    1
1       node1     211026055525 cpu_pc    1
1       node1     211026055530 cpu_pc    1
1       node1     211026055535 cpu_pc    1
1       node1     211026055540 cpu_pc    1
1       node1     211026055545 cpu_pc    1
1       node1     211026055550 cpu_pc    1
1       node1     211026055555 cpu_pc    1
1       node1     211026055600 cpu_pc    1
1       node1     211026055605 cpu_pc    1
1       node1     211026055610 cpu_pc    1
1       node1     211026055615 cpu_pc    1
1       node1     211026055620 cpu_pc    1
1       node1     211026055625 cpu_pc    1
1       node1     211026055630 cpu_pc    1
1       node1     211026055635 cpu_pc    1
1       node1     211026055640 cpu_pc    1
1       node1     211026055645 cpu_pc    1
1       node1     211026055650 cpu_pc    1
1       node1     211026055655 cpu_pc    1
1       node1     211026055700 cpu_pc    1
1       node1     211026055705 cpu_pc    1
1       node1     211026055710 cpu_pc    1
1       node1     211026055715 cpu_pc    1
1       node1     211026055720 cpu_pc    1
1       node1     211026055725 cpu_pc    1
1       node1     211026055730 cpu_pc    1
1       node1     211026055735 cpu_pc    1
1       node1     211026055740 cpu_pc    1
1       node1     211026055745 cpu_pc    1
1       node1     211026055750 cpu_pc    1
1       node1     211026055755 cpu_pc    1
1       node1     211026055800 cpu_pc    1
1       node1     211026055805 cpu_pc    1
1       node1     211026055810 cpu_pc    1
1       node1     211026055815 cpu_pc    1
1       node1     211026055820 cpu_pc    1
1       node1     211026055825 cpu_pc    1
1       node1     211026055830 cpu_pc    1
1       node1     211026055835 cpu_pc    1
1       node1     211026055840 cpu_pc    1
1       node1     211026055345 fc_mb     0
1       node1     211026055350 fc_mb     0
1       node1     211026055355 fc_mb     0
1       node1     211026055400 fc_mb     0
1       node1     211026055405 fc_mb     0
1       node1     211026055410 fc_mb     0
1       node1     211026055415 fc_mb     0
1       node1     211026055420 fc_mb     0
1       node1     211026055425 fc_mb     0
1       node1     211026055430 fc_mb     0
1       node1     211026055435 fc_mb     0
1       node1     211026055440 fc_mb     0
1       node1     211026055445 fc_mb     0
1       node1     211026055450 fc_mb     0
1       node1     211026055455 fc_mb     0
1       node1     211026055500 fc_mb     0
1       node1     211026055505 fc_mb     0
1       node1     211026055510 fc_mb     0
1       node1     211026055515 fc_mb     0
1       node1     211026055520 fc_mb     0
1       node1     211026055525 fc_mb     0
1       node1     211026055530 fc_mb     0
1       node1     211026055535 fc_mb     0
1       node1     211026055540 fc_mb     0
1       node1     211026055545 fc_mb     0
1       node1     211026055550 fc_mb     0
1       node1     211026055555 fc_mb     0
1       node1     211026055600 fc_mb     0
1       node1     211026055605 fc_mb     0
1       node1     211026055610 fc_mb     0
1       node1     211026055615 fc_mb     0
1       node1     211026055620 fc_mb     0
1       node1     211026055625 fc_mb     0
1       node1     211026055630 fc_mb     0
1       node1     211026055635 fc_mb     0
1       node1     211026055640 fc_mb     0
1       node1     211026055645 fc_mb     0
1       node1     211026055650 fc_mb     0
1       node1     211026055655 fc_mb     0
1       node1     211026055700 fc_mb     0
1       node1     211026055705 fc_mb     0
1       node1     211026055710 fc_mb     0
1       node1     211026055715 fc_mb     0
1       node1     211026055720 fc_mb     0
1       node1     211026055725 fc_mb     0
1       node1     211026055730 fc_mb     0
1       node1     211026055735 fc_mb     0
1       node1     211026055740 fc_mb     0
1       node1     211026055745 fc_mb     0
1       node1     211026055750 fc_mb     0
1       node1     211026055755 fc_mb     0
1       node1     211026055800 fc_mb     0
1       node1     211026055805 fc_mb     0
1       node1     211026055810 fc_mb     0
1       node1     211026055815 fc_mb     0
1       node1     211026055820 fc_mb     0
1       node1     211026055825 fc_mb     0
1       node1     211026055830 fc_mb     0
1       node1     211026055835 fc_mb     0
1       node1     211026055840 fc_mb     0
1       node1     211026055345 sas_mb    0
1       node1     211026055350 sas_mb    0
1       node1     211026055355 sas_mb    0
1       node1     211026055400 sas_mb    0
1       node1     211026055405 sas_mb    0
1       node1     211026055410 sas_mb    0
1       node1     211026055415 sas_mb    0
1       node1     211026055420 sas_mb    0
1       node1     211026055425 sas_mb    0
1       node1     211026055430 sas_mb    0
1       node1     211026055435 sas_mb    0
1       node1     211026055440 sas_mb    0
1       node1     211026055445 sas_mb    0
1       node1     211026055450 sas_mb    0
1       node1     211026055455 sas_mb    0
1       node1     211026055500 sas_mb    0
1       node1     211026055505 sas_mb    0
1       node1     211026055510 sas_mb    0
1       node1     211026055515 sas_mb    0
1       node1     211026055520 sas_mb    0
1       node1     211026055525 sas_mb    0
1       node1     211026055530 sas_mb    0
1       node1     211026055535 sas_mb    0
1       node1     211026055540 sas_mb    0
1       node1     211026055545 sas_mb    0
1       node1     211026055550 sas_mb    0
1       node1     211026055555 sas_mb    0
1       node1     211026055600 sas_mb    0
1       node1     211026055605 sas_mb    0
1       node1     211026055610 sas_mb    0
1       node1     211026055615 sas_mb    0
1       node1     211026055620 sas_mb    0
1       node1     211026055625 sas_mb    0
1       node1     211026055630 sas_mb    0
1       node1     211026055635 sas_mb    0
1       node1     211026055640 sas_mb    0
1       node1     211026055645 sas_mb    0
1       node1     211026055650 sas_mb    0
1       node1     211026055655 sas_mb    0
1       node1     211026055700 sas_mb    0
1       node1     211026055705 sas_mb    0
1       node1     211026055710 sas_mb    0
1       node1     211026055715 sas_mb    0
1       node1     211026055720 sas_mb    0
1       node1     211026055725 sas_mb    0
1       node1     211026055730 sas_mb    0
1       node1     211026055735 sas_mb    0
1       node1     211026055740 sas_mb    0
1       node1     211026055745 sas_mb    0
1       node1     211026055750 sas_mb    0
1       node1     211026055755 sas_mb    0
1       node1     211026055800 sas_mb    0
1       node1     211026055805 sas_mb    0
1       node1     211026055810 sas_mb    0
1       node1     211026055815 sas_mb    0
1       node1     211026055820 sas_mb    0
1       node1     211026055825 sas_mb    0
1       node1     211026055830 sas_mb    0
1       node1     211026055835 sas_mb    0
1       node1     211026055840 sas_mb    0