ndmpstat(1M) (man pages section 1M: System Administration Commands)

man pages section 1M: System Administration Commands

ndmpstat(1M)

Name

ndmpstat– show NDMP backup progress statistics

Synopsis

ndmpstat  [tapes] [interval [count]]

Description

The ndmpstat utility reports Network Data Management Protocol (NDMP) statistics, among which are NDMP worker threads, disk IO, tape IO, files operation, performance, and backup activity.

ndmpstat reports the aggregate statistics for all tapes and disks. In order to obtain statistics for specific tape devices, the tape device name should be passed as argument to the utility.

When invoked, ndmpstat begins its display with a one-line summary of the NDMP daemon activity since the NDMP service was invoked.

Display Fields

The fields in ndmpstat output are described as follows:

wthr

Report the number of worker threads in each of the four following states:

r: the number of worker threads running
w: the number of blocked worker threads that are waiting for resources such as I/O and paging
b: the number of backup operations currently running
r: the number of restore operations currently running

file

Report on usage of filesystem.

rd: the number of files being read
wr: the number of files being written

disk

Report the number of disk operations per interval.

rd: the number of disk blocks being read
wr: the number of disk blocks being written

tape

Report the number of tape operations per interval. There are slots for up to four tapes, labeled with a single number. The number indicates the name of the device under /dev/rmt.

rd: the number of tape blocks being read
wr: the number of tape blocks being written

bytes

Report the number of bytes transferred. This is the aggregate value of both tape and disk devices. The number is in kilobytes.

rd: the number of kilobytes being read
wr: the number of kilobytes being written

perf

Displays a rough estimate of performance of the backup/restore operation in megabytes per second.

bk: backup performance
rs: restore performance

prcnt

Display the comparative usage of resources, in percent.

dsk: disk I/O time
tpe: tape I/O time
otr: other time (memory or idle)

See EXAMPLES.

Operands

The following operands are supported:

count: Specifies the number of times that the statistics display is repeated.
tape: Specifies which tapes are to be given priority in the output. A command line is limited to a maximum of four tape devices. A common tape name is /dev/rmt/n, where n is an integer.
interval: Specifies the number of seconds over which ndmpstat summarizes activity. The specified interval remains in effect till the command is terminated.

Examples

Example 1 Using `ndmpstat`

The following command displays a summary of NDMP daemon activity at five-second intervals.

example% ndmpstat 5
wthr     file      disk      tape        bytes      perf       prcnt
r w b r rd  wr    rd  wr   rd    wr     rd    wr   bk  rs  dsk  tpe  otr
1 0 3 6 50   9   1250  0  32544 4455   42335 3234   5  4   20   40   40
1 0 0 1  1   0    128  0    0   128     64    64    1  0    0   80   20
1 0 0 1  2   0    128  0    0     0     64     0    1  0   80    0   20
1 0 0 1  1   0    128  0    0     0     64     0    1  0   80    0   20
1 0 0 1  3   0    128  0    0     0     64     0    0  0   80    0   20
1 0 0 1  1   0    128  0    0   128     64    64    1  0    0   80   20
^C
example%

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWndmpu
Interface Stability	See below

Invocation is evolving. Human readable output is unstable.

Notes

Performance numbers are not accurate and are rounded up at the MB/sec. boundary.

SunOS 5.11 Last Revised 21 Jun 2007