test veritas logo


vxstat(1M)

NAME

vxstat - Veritas Volume Manager statistics management utility

SYNOPSIS

vxstat [-g diskgroup | -o alldgs] [-CdpPsTvX ] [-u unit] [-f fields ]
       [-i interval [-S] [ -c count ]] [-n node [,node...]]
       [-r ] [object...] vxstat [-g diskgroup] -G [groupname] [-i interval] [-r]

DESCRIPTION

The vxstat utility prints and resets statistics information on one or more volumes, plexes, subdisks, disks, or cache objects.

Only root users can reset statistics with the -r option of the vxstat utility. You do not need root access to execute the vxstat utility with other options to print statistics information.

The vxstat utility reads statistics from the volume device files in the directory /dev/vx/rdsk and prints them to standard output. These statistics represent volume, plex, subdisk, and disk activity since boot time. If no object operands are given, then statistics from all volumes in the configuration database are reported. object can be the name of a volume, plex, subdisk, disk, or cache object.

In a Veritas Volume Manager (VxVM) cluster environment, vxstat gathers the requested statistics from all nodes in the cluster, and reports the aggregate totals. You can specify a node list to indicate a subset of nodes from which to gather statistics.

The -G option prints and resets maximum IOPS statistics information for application volume groups.

OPTIONS

-c count Stops after printing interval statistics count times.
-C Displays I/O statistics for the named cache objects (used by space-optimized instant snapshots) including:
RD Percentage of reads in the total I/O.
WR Non-first (non-allocating) writes in the total I/O.
FW First (allocating) writes in the total I/O.
RDTIME Moving average of time taken by reads in milliseconds.
WRTIME Moving average of time taken by non-first writes in milliseconds.
FWTIME Moving average of time taken by first writes in milliseconds.
-d Displays statistics for disks on which the object specified on the command line is fully or partially located.
-f fields Selects the display of statistics collected. The following options are available:
0 | O Statistics for the VOL_R5_ZERO operation. Each operation represents one call to the VOL_R5_ZERO ioctl. The number of blocks is based on the number of zeroed blocks written to the array. The average time is the time taken to complete the entire ioctl operation.
a Statistics on atomic copies performed (has meaning only for mirrored volumes). Displays the number of operations, number of blocks, and the average time spent per operation.
b Displays the statistics on read-writeback mirror consistency recovery operations (has meaning only for mirrored volumes). Displays three fields: the number of read-writeback operations, the number of blocks involved in read-writeback operations, and the average time for completing a read-writeback operation. While in recovery mode, most read operations to a mirrored volume invoke read-writeback consistency recovery.
c Statistics on corrected (fixed) read operations (has meaning only for mirrored or RAID-5 volumes). Displays the number of fixed read and write operations.
Note: Currently, only read operations are ever corrected, so the number of fixed writes will always be zero.
C Statistics for the VOL_R5_RECOVER operation. Each operation count represents one call to the VOL_R5_RECOVER ioctl. The number of blocks represents the resulting number of blocks that were written to the missing column region as part of the data recovery. The read operations are not counted towards the total.
e Displays statistics for extended copy operations on volumes including:
OPS The number of extended copy operations performed.
BLOCKS The number of blocks copied.
AVG The average time taken per operation in milliseconds.
f The number of failed read and write operations.
F Statistics for full-stripe writes on RAID-5 volumes. The number of operations represents the number of write operations within a stripe that were conducted as a full-stripe write optimization. Full-stripe writes represent considerably less overhead than read-modify-writes in terms of overall I/O time, latency and CPU overhead. The total number of blocks represents the total size of the written data and the average time is the time taken for a full-stripe write operation. Since the I/O may be larger then a single stripe, more than one stripe operation may be seen for a single logical I/O request.
i Statistics for remote I/O on the initiator, or source, of the I/O. The source is the node that initiated the I/O request that is sent to another node for processing. If no initiator I/O exists, no information displays.
m Statistics for writes generated by reclamation requests. Applies only when Thin-capable arrays are present. When Storage Foundation reclaims space, the reclamation process results in writes at the volume level. If you do not specify the m argument, the I/O statistics do not include these reclamation writes.
M Read-modify-write statistics for RAID-5 volumes. Each operation represents a read-modify write operation performed within a stripe. I/O crossing a stripe boundary will be represented by more than a single read-modify write operation. The number of blocks counted represents only the size of the requested write. The read portion of the I/O can be derived.
o Reads from source volumes that satisfy attempted reads from incomplete instant snapshots.
p Pushed writes of original data to incomplete instant snapshots. These writes are caused by attempted writes to the source volumes.
r Resync writes of original data to incomplete instant snapshots. These writes are caused by background synchronization operations rather than by pushed writes.
R Reconstruct read operations for RAID-5 volumes. Each operation is a separate reconstruct read operation. A single stripe read or write operation can lead to numerous reconstruct read operations.
s Statistics on read and write operations. Displays six fields: the number of read operations, the number of write operations, the number of blocks read, the number of blocks written, the average time spent on read operations in the interval, and the average time spent on write operations in the interval. These statistics are displayed as the default output format.
S Statistics for the VOL_R5_RESYNC operation. Each operation count represents one call to the VOL_R5_RESYNC ioctl. The number of blocks represents the resulting number of blocks that were written to the parity regions as part of the resynchronization of parity. The read operations are not counted towards the total.
t Statistics for remote I/O on the target. The target is the node that is processing the I/O on behave of the initiator. If no target I/O exists, no information displays.
v Statistics on verified reads and writes (has meaning only for mirrored volumes). Displays six fields: the number of verified read operations, the number of verified write operations, the number of blocks read, the number of blocks written, the average time spent on verified read operations in the interval, and the average time spent on verified write operations in the interval.
V Statistics for the VOL_R5_VERIFY operation. Each operation count represents one call to the VOL_R5_VERIFY ioctl. The number of blocks represents the resulting number of blocks that were read as part of the RAID-5 stripes consistency verification.
W Reconstruct write statistics for RAID-5 volumes. Each operation counted is for a reconstruct write operation performed as an optimization of a write operation within a stripe. The number of blocks counted represents the count of data blocks written not including parity or read operations.
-g diskgroup Selects records from the specified disk group. The diskgroup option argument can be either a disk group name or disk group ID.
-G Displays a statistical view of the maximum I/O operations per second (IOPS) for an application volume group. You can obtain a detailed view of the maximum IOPS statistics per second, or an average of the accumulated statistics per second over a specified time interval. You can view IOPS statistics for a specific application volume group or statistics for all application volume groups.
The -G provides the following information:
MaxIOPS Displays the maximum IOPS threshold set for an application volume group. ServicedIOPS Displays the number of IOPS undertaken for processing for an application volume group. QueuedIOPS(Transient) Displays the number of IOPS throttled for an application volume group.
Specify the –i option with required interval to get a statistical view of the maximum
  IOPS statistics per second, or an average of the accumulated statistics per second over a specified time interval Displays a statistical view of the maximum IOPS or an average of the accumulated statistics per second over a specified time interval.
Specify the –r option to reset the maximum IOPS statistics for application volume groups.
  Note: Only –i and –r options are supported with [-G].
-i interval [-S]
  Prints the change in volume statistics that occurs after every interval seconds. The first interval is assumed to encompass the entire previous history of objects. Subsequent displays will show statistics with a zero value if there has been no change since the previous interval.
Specify the -S option to display statistics for each interval grouped per second. Otherwise, the command displays the accumulated statistics for the entire time interval. With the -S option, the command generates scaled statistics outputs. The unit of the scaled output depends on how large the statistics value being printed is.
-n node[,node...]
  Gathers and displays statistics for the nodes specified in node, where node is a comma separated list of integer node numbers.
-o alldgs Displays statistics for all of the diskgroups. This option cannot be used if a disk group is specified with the -g option. If neither -o or the -g option is specified, the command displays statistics for the defaultdg.
-p Displays statistics for plexes on the object specified on the command line. For subdisk objects, displays information about a plex with which it is associated.
-P Displays statistics for the paging module that is used by the instant snapshot feature:
INVALIDATIONS
  Number of pages whose contents have been invalidated for some reason.
REPLACEMENTS
  Number of pages stolen to satisfy a new request.
HITS Number of client requests that were satisfied from in-core pages.
MISSES Number of client requests that could not be satisfied from the in-core pages, and which required the contents to be read from disk.
-r Resets statistics instead of printing them. This option follows the same selection rules as printing for any type selection arguments or for any named objects. If an interval was specified on the command line, then the first set of statistics will not be printed since they will have been reset to zero. Subsequent activity will cause printing of statistics as normal.
-s Displays statistics for subdisks on the objects specified on the command line.
-T Displays statistics in microseconds. If -T is not specified, the statistics display in milliseconds.
-u unit Displays the data rates in scaled numbers in the specified units.
Units can be one of the following:
 
h|H The largest possible unit.
b|B Bytes
k|K Kilobytes
m|M Megabytes
g|G Gigabytes
-v Displays statistics for volumes on the objects specified on the command line. For an object that is a plex or a subdisk, displays information about the volume with which the object is associated. If an object supplied is a disk, then any volumes that occupy any part of the disk will be selected.
-l Displays statistics for RVG objects.
-X Displays additional statistics for remote I/Os on the target or on the source. The additional statistics are only collected if the I/O ship statistics are enabled with the tunable parameter vol_ioship_stats_enable. The vol_ioship_stats_enable tunable parameter is disabled by default. See the vxtune manual page for details.
When enabled, the following statistics are displayed for the source:
SOURCE_START_LLT
  Displays the amount of time between when the I/O shipping request starts and when the request is sent to LLT.
SOURCE_UPCALL_IOD
  Displays the amount of time between when the LLT calls the client callback routine and when the I/O is sent to the VxVM done queue.
SOURCE_IOD_APP
  Displays the amount of time between when the I/O is in the VxVM done queue and when the application completes the I/O.
The following statistics are displayed for the target:
TARGET_UP_START
  Displays the amount of time between when the LLT calls the client callback routine and when the io daemon (iod) begins processing the I/O.
TARGET_START_DEV
  Displays the amount of time between when io daemon (iod) begins processing the I/O and when the I/O is sent to the device.
TARGET_DEV_INTR
  Displays the amount of time for the device to complete the I/O.
TARGET_INTR_LLT
  Displays the amount of time between a device interrupt and when a response is sent to LLT.
-G Displays a statistical view of the maximum I/O operations per second on application volume groups.
-G \volgrp fB-i Displays an average of the maximum I/O operations per second on the specified application volume group for the specified time interval.
-G -i Displays an average of the maximum I/O operations per second on all application volume groups for the specified time interval.
-G [<grpnames>...] -r
  Resets the application volume group level statistics.

OUTPUT FORMAT

Summary statistics for each object are printed in one-line output records, preceded by two header lines. The output line consists of blank-separated fields for the object type, object name (standard), and the fields requested by the -f switch in the order they are specified on the command line.

If the -i interval option was supplied, then statistics will be prefaced with a time-stamp showing the current local time on the system.

EXIT CODES

The vxstat utility exits with a non-zero status if the attempted operation fails. A non-zero exit code is not a complete indicator of the problems encountered, but rather denotes the first condition that prevented further execution of the utility.

See vxintro(1M) for a list of standard exit codes.

EXAMPLES

To display statistics for all subdisks associated with all volumes, use the command:

vxstat -s

To display statistics for the plexes and subdisks of a volume named blop, use the following:


vxstat -ps blop

To reset all statistics for a disk group named mydg, type the following command:


vxstat -g mydg -r

To display 5 sets of disk statistics at 10 second intervals, use the following:


vxstat -i 10 -c 5 -d

To display the volume statistics in disk group named mydg in microseconds use the following:


vxstat -g mydg -v -T

To display the per second disk statistics in disk group named mydg at 10 second intervals, use the following:


vxstat -g mydg -i 10 -S -d

To display the disk group statistics for all the disk groups on your system, use the following:


vxstat -o alldgs

To display the volume statistics in disk group named mydg in terms of megabytes, use the following:


vxstat -g mydg -v -u m

To display extended statistics for remote I/Os for the source in the disk group stripedg, use the following:


vxstat -g stripedg -T -X -fi -i5 SRC OPERATIONS BLOCKS AVG TIME(ms) TYP NAME READ WRITE READ WRITE READ WRITE vmdellr710-1(src) Wed 21 May 2014 07:33:00 AM PDT dm h1_fusionio0_0 0 297638 0 0 0.00 4272.16 SOURCE_START_LLT 0 297637 0 0 0.00 7.15 SOURCE_UPCALL_IOD 0 297637 0 0 0.00 10.58 SOURCE_IOD_APP 0 297637 0 0 0.00 4.38

To display extended statistics for remote I/Os for the target in the disk group stripedg, use the following:


vxstat -g stripedg -T -X -ft -i5 TGT OPERATIONS BLOCKS AVG TIME(ms) TYP NAME READ WRITE READ WRITE READ WRITE vmdellr710-1(dst) Wed 21 May 2014 07:30:10 AM PDT dm h1_fusionio0_0 0 10270 0 164305 0.00 32.04 TARGET_UP_START 0 10267 0 164257 0.00 0.80 TARGET_START_DEV 0 10267 0 164257 0.00 1.42 TARGET_DEV_INTR 0 10269 0 164289 0.00 32.49 TARGET_INTR_LLT 0 10270 0 164305 0.00 6.84

To view the average per second statistics for application volume groups in the disk group oradg, use the following:


AVG PER SECOND VOLUMEGROUP STATISTICS TYP NAME MaxIOPS ServicedIOPS QueuedIOPS(Transient) grp datavol_grp 1000 893 56 grp logvol_grp 600 598 404

To view the per second statistics for application volume groups in the disk group oradg, use the following:
AVG PER SECOND VOLUMEGROUP STATISTICS TYP NAME MaxIOPS ServicedIOPS QueuedIOPS(Transient) vmdell900-4-vm2 Wed 31 Dec 2014 06:14:04 PM UTC grp datavol_grp 1000 932 47 grp logvol_grp 600 598 393 vmdell900-4-vm2 Wed 31 Dec 2014 06:14:05 PM UTC grp datavol_grp 1000 1000 32 grp logvol_grp 600 600 32 vmdell900-4-vm2 Wed 31 Dec 2014 06:14:06 PM UTC grp datavol_grp 1000 1000 32 grp logvol_grp 600 600 32

SEE ALSO

vxintro(1M), vxtrace(1M) vxvolgrp(1M)


VxVM 7.3.1 vxstat(1M)