sag(1M) — ADMINISTRATOR COMMANDS

NAME

sag − system activity graph

SYNOPSIS

sag [options]

DESCRIPTION

sag graphically displays the system activity data stored in a binary data file by a previous sar(1M) run. Any of the sar data items may be plotted singly, or in combination; as cross plots, or versus time. Simple arithmetic combinations of data may be specified. sag invokes sar and finds the desired data by string-matching the data column header (run sar to see what is available). These options are passed through to sar:

-s time Select data later than time in the form hh[:mm]. The default is 08:00.

-e time Select data up to time. The default is 18:00.

-i sec Select data at intervals as close as possible to sec seconds.

-f file Use file as the data source for sar. The default value is the current daily data file (/usr/adm/sa/sadd).

Other options:

-T term Produce output suitable for terminal term. The default value is $TERM. The only terminal type that is supported for making line graphs is the Tektronix 4014 (can be emulated by xterm(1)). If any other terminal type is used, an ASCII graph is printed.

-x spec x axis specification with spec in the form:

"name[op name] . . . [lo hi]"

-y spec y axis specification with spec in the same form as above.

Name is either a string that will match a column header in the sar report, with an optional device name in square brackets, (such as r+w/s[dsk−1], or an integer value. Op is one of four characters (“+”, “-”, “∗”, or “/”), surrounded by blanks. (Parentheses are not recognized.) Up to five names may be specified. Contrary to custom, + and - have precedence over ∗ and /". Evaluation is done from left to right. Thus A / A + B ∗ 100 is evaluated (A/(A+B))∗100, and A + B / C + D is (A+B)/(C+D). Lo and hi are optional numeric scale limits. If unspecified, they are deduced from the data.

A single spec is permitted for the x axis; if unspecified, time is used. For the y axis, specify up to five specs, separated by semi-colons (;). If you specify more than one argument to -x or -y, and leave one or more blank spaces between list items, enclose the list in double quotes (""). The default value for the -y option is

-y "%usr 0 100; %usr + %sys 0 100; %usr + %sys + %wio 0 100"

EXAMPLES

For a report on today’s CPU utilization:

sag

For a report on the activity of all disk drives over a 15-minute period:

TS=date +%H:%M
sar -o tempfile 60 15
TE=date +%H:%M
sag -f tempfile -s $TS -e $TE -y "r+w/s[dsk]"

FILES

/usr/adm/sa/sadd daily data file for day dd

Museum