User Commands sar(1)
NAME
sar - system activity reporter
SYNOPSIS
sar [-aAbcdgkmpqruvwy] [-o filename] t [n]
sar [-aAbcdgkmpqruvwy] [-e time] [-f filename] [-i sec]
[-s time]
DESCRIPTION
In the first instance, the sar utility samples cumulative
activity counters in the operating system at n intervals of t seconds, where t should be 5 or greater. If t is specified with more than one option, all headers are printed together and the output can be difficult to read. (If the samplinginterval is less than 5, the activity of sar itself can
affect the sample.) If the -o option is specified, it saves
the samples in filename in binary format. The default value of n is 1. In the second instance, no sampling interval is specified.sar extracts data from a previously recorded filename,
either the one specified by the -f option or, by default,
the standard system activity daily data file /var/adm/sa/sadd for the current day dd. The starting andending times of the report can be bounded using the -e and
-s arguments with time specified in the form hh[:mm[:ss]].
The -i option selects records at sec second intervals. Oth-
erwise, all intervals found in the data file are reported. OPTIONS The following options modify the subsets of informationreported by sar.
-a Reports use of file access system routines:
iget/s, namei/s, dirblk/s-A Reports all data. Equivalent to
-abcdgkmpqruvwy.
-b Reports buffer activity:
bread/s, bwrit/s transfers per second of data between system buffers and disk or other block devices.SunOS 5.11 Last change: 1 Dec 2009 1
User Commands sar(1)
lread/s, lwrit/s accesses of system buffers.%rcache, %wcache cache hit ratios, that
is, (1-bread/lread) as a
percentage.pread/s, pwrit/s transfers using raw (phy-
sical) device mechanism.If run in a non-global zone and the pools
facility is active, these values reflect activity on the processors of the processor set of the pool to which the zone is bound.-c Reports system calls:
scall/s system calls of all types. sread/s, swrit/s, fork/s, exec/s specific system calls. rchar/s, wchar/s characters transferred by read and write system calls. No incoming or outgoing exec(2) and fork(2) calls are reported.If run in a non-global zone and the pools
facility is active, these values reflect activity on the processors of the processor set of the pool to which the zone is bound.-d Reports activity for each block device (for
example, disk or tape drive) with the excep-
tion of XDC disks and tape drives. When datais displayed, the device specification dsk-
is generally used to represent a disk drive. The device specification used to represent a tape drive is machine dependent. The activity data reported is:SunOS 5.11 Last change: 1 Dec 2009 2
User Commands sar(1)
%busy, avque portion of time
device was busy servicing a transfer request, average number ofrequests outstand-
ing during that time. read/s, write/s, blks/s number of read/write transfers from or to device, number of bytes transferred in512-byte units.
avwait average wait time in milliseconds. avserv average servicetime in mil-
liseconds. For more general system statistics, useiostat(1M), sar(1M), or vmstat(1M).
See System Administration Guide: Advanced Administration for naming conventions for disks.-e time Selects data up to time. Default is 18:00.
-f filename Uses filename as the data source for sar.
Default is the current daily data file /var/adm/sa/sadd.-g Reports paging activities:
pgout/s page-out requests per second.
ppgout/s pages paged-out per second.
SunOS 5.11 Last change: 1 Dec 2009 3
User Commands sar(1)
pgfree/s pages per second placed on the free list by the page stealing daemon. pgscan/s pages per second scanned by the page stealing daemon.%ufs_ipf the percentage of UFS inodes
taken off the freelist by igetwhich had reusable pages associ-
ated with them. These pages are flushed and cannot be reclaimed by processes. Thus, this is the percentage of igets with page flushes.If run in a non-global zone and the pools
facility is active, these values reflect activity on the processors of the processor set of the pool to which the zone is bound.-i sec Selects data at intervals as close as possi-
ble to sec seconds.-k Reports kernel memory allocation (KMA)
activities:sml_mem, alloc, fail information about the
memory pool reserving and allocating space for small requests: the amount of memory in bytes KMA has for the small pool, thenumber of bytes allo-
cated to satisfy requests for small amounts of memory, and the number of requests for small amounts of memorythat were not satis-
fied (failed).lg_mem, alloc, fail information for the
large memory pool (analogous to theSunOS 5.11 Last change: 1 Dec 2009 4
User Commands sar(1)
information for the small memory pool).ovsz_alloc, fail the amount of memory
allocated for over-
size requests and the number of oversize requests which could not be satisfied (because oversized memory is allocated dynamically, there is not a pool).-m Reports message and semaphore activities:
msg/s, sema/s primitives per second.If run in a non-global zone and the pools
facility is active, these values reflect activity on the processors of the processor set of the pool to which the zone is bound.-o filename Saves samples in file, filename, in binary
format.-p Reports paging activities:
atch/s page faults per second that are satisfied by reclaiming a page currently in memory (attaches per second).pgin/s page-in requests per second.
ppgin/s pages paged-in per second.
pflt/s page faults from protection errors per second (illegal access topage) or "copy-on-writes".
vflt/s address translation page faults per second (valid page not inSunOS 5.11 Last change: 1 Dec 2009 5
User Commands sar(1)
memory). slock/s faults per second caused by software lock requests requiringphysical I/O.
If run in a non-global zone and the pools
facility is active, these values reflect activity on the processors of the processor set of the pool to which the zone is bound.-q Reports average queue length while occupied,
and percent of time occupied:runq-sz, %runocc Run queue of kernel
threads in memory and runnableswpq-sz, %swpocc Swap queue of processes
-r Reports unused memory pages and disk blocks:
freemem average pages available to user processes. freeswap disk blocks available for page swapping.-s time Selects data later than time in the form
hh[:mm]. Default is 08:00.-u Reports CPU utilization (the default):
%usr, %sys, %wio, %idle portion of time
running in user mode, running in system mode, idle with some process waiting for blockI/O, and otherwise idle.
If run in a non-global zone and the pools
SunOS 5.11 Last change: 1 Dec 2009 6
User Commands sar(1)
facility is active, these values reflect activity on the processors of the processor set of the pool to which the zone is bound.-v Reports status of process, i-node, file
tables:proc-sz, inod-sz, file-sz, lock-sz
entries/size for each table, evaluated once at sampling point. ov overflows that occur between sampling points for each table.-w Reports system swapping and switching
activity: swpin/s, swpot/s, bswin/s, bswot/snumber of transfers and number of 512-
byte units transferred for swapins and swapouts (including initial loading of some programs). pswch/s process switches.If run in a non-global zone and the pools
facility is active, these values reflect activity on the processors of the processor set of the pool to which the zone is bound.-y Reports TTY device activity:
rawch/s, canch/s, outch/s input character rate, input character rate processed by canon, output character rate.SunOS 5.11 Last change: 1 Dec 2009 7
User Commands sar(1)
rcvin/s, xmtin/s, mdmin/s receive, transmit and modem interrupt rates.If run in a non-global zone and the pools
facility is active, these values reflect activity on the processors of the processor set of the pool to which the zone is bound.EXAMPLES
Example 1 Viewing System Activity The following example displays today's CPU activity so far:example% sar
Example 2 Watching System Activity Evolve To watch CPU activity evolve for 10 minutes and save data:example% sar -o temp 60 10
Example 3 Reviewing Disk and Tape Activity To later review disk and tape activity from that period:example% sar -d -f temp
FILES /var/adm/sa/sadd daily data file, where dd are digits representing the day of the monthATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:SunOS 5.11 Last change: 1 Dec 2009 8
User Commands sar(1)
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | system/accounting/legacy ||_____________________________|_____________________________|
SEE ALSO
iostat(1M), sar(1M), vmstat(1M), exec(2), fork(2), attri-
butes(5) System Administration Guide: Advanced Administration NOTES The sum of CPU utilization might vary slightly from 100 because of rounding errors in the production of a percentage figure.SunOS 5.11 Last change: 1 Dec 2009 9