sa2(1M)
NAME
sar, sa1, sa2, sadc - system activity report package
SYNOPSIS
/usr/lib/sa/sadc [ t n] [ofile]
/usr/lib/sa/sa1 [ t n]
/usr/lib/sa/sa2 [-aAbcdgkmpqruvwy] [-e time] [-f filename]
[-i sec] [-s time]
DESCRIPTION
System activity data can be accessed at the special request
of a user (see sar(1)) and automatically, on a routine
basis, as described here. The operating system contains
several counters that are incremented as various system
actions occur. These include counters for CPU utilization,
buffer usage, disk and tape I/O activity, TTY device
activity, switching and system-call activity, file-access,
queue activity, inter-process communications, and paging.
For more general system statistics, use iostat (1M),
sar(1), or vmstat(1M).
sadc and two shell procedures, sa1 and sa2, are used to sam-
ple, save, and process this data.
sadc, the data collector, samples system data n times, with
an interval of t seconds between samples, and writes in
binary format to ofile or to standard output. The sampling
interval t should be greater than 5 seconds; otherwise, the
activity of sadc itself may affect the sample. If t and n
are omitted, a special record is written. This facility can
be used at system boot time, when booting to a
multi-user state, to mark the time at which the counters
restart from zero. For example, when accounting is enabled,
the /etc/init.d/perf file writes the restart mark to the
daily data file using the command entry:
su sys -c "/usr/lib/sa/sadc /var/adm/sa/sa`date +%d`"
The shell script sa1, a variant of sadc, is used to collect
and store data in the binary file /var/adm/sa/sadd, where dd
is the current day. The arguments t and n cause records to
be written n times at an interval of t seconds, or once if
omitted. The following entries in
/var/spool/cron/crontabs/sys will produce records every 20
minutes during working hours and hourly otherwise:
0 * * * 0-6 /usr/lib/sa/sa1
20,40 8-17 * * 1-5 /usr/lib/sa/sa1
See crontab(1) for details.
The shell script sa2, a variant of sar, writes a daily
report in the file /var/adm/sa/sardd. See the OPTIONS sec-
tion in sar(1) for an explanation of the various options.
The following entry in /var/spool/cron/crontabs/sys will
report important activities hourly during the working day:
5 18 * * 1-5 /usr/lib/sa/sa2 -s 8:00 -e 18:01 -i 1200
-A
FILES
/etc/init.d/perf
/tmp/sa.adrfl
address file
/var/adm/sa/sadd
daily data file
/var/adm/sa/sardd
daily report file
/var/spool/cron/crontabs/sys
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWaccu |
|_____________________________|_____________________________|
SEE ALSO
crontab(1), sag(1), sar(1), timex(1), iostat(1M),
vmstat(1M), attributes(5)
System Administration Guide: Basic Administration
Man(1) output converted with
man2html