lsnodestats

Use the lsnodestats command to display the most recent values of statistics for all nodes or node canisters, and display all statistics for a particular node or node canister. Additionally, You can use this command to display a history of values for a given subset of available statistics. This command is only applicable for IBM® SAN Volume Controller.

Syntax

Read syntax diagramSkip visual syntax diagramlsnodestats-minutes-hours-days-history stat_listnode_or_nodecanister_idnode_or_nodecanister_name

Parameters

-delim delimiter
(Optional) Specify a delimiter to separate data in the output.
-nohdr
(Optional) Suppress the headings in the output.
-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.
-filtervalue?
(Optional) Displays a list of valid filter attributes.
-minutes
(Optional) Displays stats at minutes granularity.
-hours
(Optional) Displays stats at hours granularity.
-days
(Optional) Show stats at days granularity.
Note:
  • Flags (-minutes, -hours, and -days) are mutually exclusive. When no options are selected, the real-time (5-second) samples are shown and can be utilized, with or without the inclusion of the -history parameter.
  • Each granularity will show up to 60 samples per stat when used with -history parameter.
-history stat_list
(Optional) Provides a table of statistical values for the specified node. The stat_list is a colon-delimited list of one or more statistical values. A table is generated for each entry in the stat_list.
Remember: If -history is specified, a node ID or name must be specified as well.
node_or_nodecanister_id | node_or_nodecanister_name
(Optional) Identifies the node or node canister for which you want to request statistics.

Description

This command returns a concise list or a detailed view of nodes or 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. Attribute values for lsnodestats
Attribute Value
node_id The ID of the node or node canister.
node_name The name of the node or node canister.
stat_current The current value of the statistic field.
stat_list The system history of the reported statistics. The list of statistics can contain multiple items that are separated by colons.
stat_name The name of the statistic field. See Table 2 for descriptions of available statistics.
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.

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
compression_cpu_pc (Deprecated) Displays the percentage of allocated CPU capacity that is utilized for compression.
cpu_pc Displays the percentage of allocated CPU capacity that is utilized for the system.
fc_mb Displays the total number of megabytes transferred per second 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 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 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 for read and write operations to volumes during the sample period.
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 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 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 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 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 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.
power_w Displays the power that is consumed in watts.
temp_c Displays the ambient temperature in Celsius.
temp_f Displays the ambient temperature in Fahrenheit.
vdisk_r_mb Displays the average number of megabytes transferred per second 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 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 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.
iplink_mb The total number of megabytes transferred per second for Internet Protocol (IP) replication traffic on the system. 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.
iplink_io The total input/output (I/O) operations that are 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.
cloud_up_mb Displays the average number of megabits 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.