SAR(1M) SAR(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 [-ubdDycwaqvmprtghIA] [-s time] [-e time] [-i sec]
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 a number of counters that are incremented as
various system actions occur. These include counters for CPU
utilization, buffer usage, disk I/O activity, TTY device activity,
switching and system-call activity, file-access, queue activity, inter-
process communications, paging and graphics.
sadc and shell procedures, sa1 and sa2, are used to sample, save, and
process this data.
sadc, the data collector, samples system data n times every t seconds and
writes in binary format to ofile or to standard output. If t and n are
omitted, a special record is written. This facility is used at system
boot time, when booting to a multiuser state, to mark the time at which
the counters restart from zero. For example, the /etc/init.d/perf file
writes the restart mark to the daily data by 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 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 entries in /usr/spool/cron/crontabs/sys
(see cron(1M)):
0 * * * 0-6 /usr/lib/sa/sa1
20,40 8-17 * * 1-5 /usr/lib/sa/sa1
will produce records every 20 minutes during working hours and hourly
otherwise.
The shell script sa2, a variant of sar(1), writes a daily report in file
/var/adm/sa/sardd. The options are explained in sar(1). The
/usr/spool/cron/crontabs/sys entry:
5 18 * * 1-5 /usr/lib/sa/sa2 -s 8:00 -e 18:01 -i 1200 -A
Page 1
SAR(1M) SAR(1M)
will report important activities hourly during the working day.
The structure of the binary daily data file is:
struct sa {
struct sysinfo si; /* see /usr/include/sys/sysinfo.h */
struct minfo mi; /* defined in sys/sysinfo.h */
struck dinfo di; /* RFS info defined in sys/sysinfo.h */
int minserve, maxserve; /* RFS server low and high water marks */
int szinode; /* current size of inode table */
int szfile; /* current size of file table */
int szproc; /* current size of proc table */
int szlckf; /* current size of file record header table */
int szlckr; /* current size of file record lock table */
int mszinode; /* size of inode table */
int mszfile; /* size of file table */
int mszproc; /* size of proc table */
int mszlckf; /* maximum size of file record header table */
int mszlckr; /* maximum size of file record lock table */
long inodeovf; /* cumulative overflows of inode table */
long fileovf; /* cumulative overflows of file table */
long procovf; /* cumulative overflows of proc table */
long lckovf; /* cumulative overflows of record lock table */
time_t ts; /* time stamp, seconds */
int apstate; /* number of processors */
struct sgidio devio[NDEVS];/* device unit information */
#define IO_OPS 0 /* cumulative I/O requests */
#define IO_BCNT 1 /* cumulative blocks transferred */
#define IO_ACT 2 /* cumulative drive busy time in ticks */
#define IO_RESP 3 /* cumulative I/O resp time in ticks */
};
FILES
/var/adm/sa/sadd daily data file
/var/adm/sa/sardd daily report file
/tmp/sa.adrfl address file
SEE ALSO
sar(1), timex(1), cron(1M)
Page 2