sysstat
NAME
sysstat – report filer performance statistics
SYNOPSIS
sysstat [ interval ]
sysstat [ -c count ] [ -s ] [ -u | -x | -m | -f | -i | -b ] [ interval ]
DESCRIPTION
sysstat reports aggregated filer performance statistics such as the current CPU utilization, the amount of network I/O, the amount of disk I/O, and the amount of tape I/O. When invoked with no arguments sysstat prints a new line of statistics every 15 seconds. Use control-C or set the interval count (-c count ) to stop sysstat.
OPTIONS
- -c count
- Terminate the output after count number of iterations. The count is a positive, nonzero integer, values larger than LONG_MAX will be truncated to LONG_MAX.
- -s
- Display a summary of the output columns upon termination, descriptive columns such as `CP ty’ will not have summaries printed. Note that, with the exception of `Cache hit’, the `Avg’ summary for percentage values is an average of percentages, not a true mean of the underlying data. The `Avg’ is only intended as a gross indicator of performance. For more detailed information use tools such as nfsstat, netstat, or statit.
- -f
- For the default format display FCP statistics.
- -i
- For the default format display iSCSI statistics.
- -b
- Display the SAN extended statistics instead of the default display.
- -u
- Display the extended utilization statistics instead of the default display.
- -x
- Displays the extended output format instead of the default display. This includes all available output fields. Be aware that this produces output that is longer than 80 columns and is generally intended for “offline” types of analysis and not for “realtime” viewing.
- -m
- Displays multi-processor CPU utilization statistics. In addition to the percentage of the time that one or more CPUs were busy (ANY), the average (AVG) is displayed, as well as, the individual utilization of each processor.
- interval
- A positive, non-zero integer that represents the reporting interval in seconds. If not provided, the default is 15 seconds.
DISPLAYS
The default output format is as follows:
-
CPU NFS CIFS HTTP Net kB/s Disk kB/s Tape kB/s Cache in out read write read write age ###% ##### ##### ##### ##### ##### ##### ##### ##### ##### >##
The FCP default output format is as follows:
-
CPU NFS CIFS FCP Net kB/s Disk kB/s FCP kB/s Cache in out read write in out age ###% ##### ##### ##### ##### ##### ##### ##### ##### ##### >##
The iSCSI default output format is as follows:
-
CPU NFS CIFS iSCSI Net kB/s Disk kB/s iSCSI kB/s Cache in out read write in out age ###% ##### ##### ##### ##### ##### ##### ##### ##### ##### >##
The SAN extended statistics output format is as follows:
-
CPU FCP iSCSI Partner Total FCP kB/s iSCSI kB/s Partner kB/s Disk kB/s CP CP Disk in out in out in out read write time ty util ###% ##### ##### ##### ###### ##### ##### ##### ##### ##### ##### ##### ##### ###% A ###%
The utilization output format is as follows:
-
CPU Total Net kB/s Disk kB/s Tape kB/s Cache Cache CP CP Disk ops/s in out read write read write age hit time ty util ###% ####### ##### ##### ##### ##### ##### ##### >## ###% ###% A ###%
The extended display output format is as follows:
-
CPU NFS CIFS HTTP Total Net kB/s Disk kB/s Tape kB/s Cache Cache CP CP Disk FCP iSCSI FCP kB/s in out read write read write age hit time ty util in out ###% ##### ##### ##### ####### ##### ##### ##### ##### ##### ##### >## ###% ###% A ###% ##### ##### ##### #####
The summary output format is as follows (for -u)
-
— Summary Statistics (#### samples ## secs/sample) CPU Total Net kB/s Disk kB/s Tape kB/s Cache Cache CP CP Disk ops/s in out read write read write age hit util ty util Min ###% ####### ##### ##### ##### ##### ##### ##### ##### ###% ###% * ###% Avg ###% ####### ##### ##### ##### ##### ##### ##### ##### ###% ###% * ###% Max ###% ####### ##### ##### ##### ##### ##### ##### ##### ###% ###% * ###%
The output column descriptions are:
- CPU
- The percentage of the time that one or more CPUs were busy doing useful work, during the previous interval seconds;
- NFS
- The number of NFS operations per second during that time;
- CIFS
- The number of CIFS operations per second during that time;
- HTTP
- The number of HTTP operations per second during that time;
- FCP
- The number of FCP operations per second during that time;
- iSCSI
- The number of iSCSI operations per second during that time;
- Partner
- The number of SCSI Partner operations per second during that time;
- CP ty
- Consistency Point (CP) type, the cause of the CP that was started in the interval. Multiple CPs list no cause, just the number of CPs during the measurement interval. The CP types are as follows:
- –
- No CP started during sampling interval
- number
- Number of CPs started during sampling interval, if greater than one
- B
- Back to back CPs (CP generated CP)
- b
- Deferred back to back CPs (CP generated CP)
- F
- CP caused by full NVLog
- H
- A type H CP is a CP from high watermark in modified buffers. If a CP is not in progress, and the number of buffers holding data that has been modified but not yet written to disk exceeds a threshold, then a CP from high watermark is triggered.
- L
- A type L CP is a CP from low watermark in available buffers. If a CP is not in progress, and the number of buffers available goes below a threshold, then a CP form low watermark is triggered.
- S
- CP caused by snapshot operation
- T
- CP caused by timer
- U
- CP caused by flush
- Z
- CP caused by internal sync
- V
- CP caused by low virtual buffers
- M
- CP caused by low mbufs
- D
- CP caused by low datavecs
- :
- continuation of CP from previous interval
- #
- continuation of CP from previous interval, and the NVLog for the next CP is now full, so that the next CP will be of type B.
- 0
- Initializing
- n
- Processing normal files
- s
- Processing special files
- q
- Processing quota files
- f
- Flushing modified data to disk
- v
- Flushing modified superblock to disk
Net kB/s The number of kilobytes per second of network traffic into and out of the server;
Disk kB/s The kilobytes per second of disk traffic being read and written;
Tape kB/s The number of kilobytes per second of tape traffic being read and written;
FCP kB/s The number of kilobytes per second of fcp traffic into and out of the server;
iSCSI kB/s
The number of kilobytes per second of iSCSI traffic into and out of the server;
Partner kB/s
The number of kilobytes per second of SCSI Partner traffic into and out of the server;
Cache age The age of the data most recently evicted from the buffer pool. This data is usually, but not necessarily, the least recently used. Thus, it is possible for the statistic reported by sysstat to sometimes change erratically as buffers containing data of varying age are reclaimed.
Total ops/s
The total number of operations per second (NFS + CIFS + HTTP)
Cache hit The WAFL cache hit rate percentage. This value is the percent of instances in which WAFL attempted to load a disk-block that the data was found already cached in memory. A dash in this column indicates that WAFL did not attempt to load any blocks during the measurement interval.
CP util The Consistency Point (CP) utilization, the % of time spent in a CP
The type character is followed by a second character which indicates the phase of the CP at the end of the sampling interval. If the CP completed during the sampling interval, this second character will be blank. The phases are as follows:
Disk util The disk utilization (percentage) of the busiest disk since a true aggregate value would probably not show the user that there is some type disk based bottleneck. Do not confuse this with disk space used, this is an access based value.
EXAMPLES
sysstat
Display the default output every 15 seconds, requires control-C to terminate.
sysstat 1
Display the default output every second, requires control-C to terminate.
sysstat -s 1
Display the default output every second, upon control-C termination print out the summary statistics.
sysstat -c 10
Display the default output every 15 seconds, stopping after the 10th iteration.
sysstat -c 10 -s -u 2
sysstat -u -c 10 -s 2
Display the utilization output format, every 2 seconds, stopping after the 10th iteration, upon completion print out the summary statistics.
sysstat -x -s 5
Display the extended (full) output, every 5 seconds, upon control-C termination print out the summary statistics.
CLUSTER CONSIDERATIONS
In takeover mode, the sysstat command displays the combined statistics from both the failed filer and the live filer.
The statistics diplayed by the sysstat command are cumulative; a giveback operation does not zero out the statistics. That is, after giving back its partner’s resources, the live filer does not subtract the statistics about operations it performed on behalf of the failed filer in takeover mode.