manpages.info - online man pages   

SunOS man pages : sag (1)

User Commands                                              sag(1)

NAME

sag - system activity graph

SYNOPSIS

sag [ -e time ] [ -f file ] [ -i sec ] [ -s time ] [ -T term ] [ -x spec ] [ -y spec ]

DESCRIPTION

The sag utility graphically displays the system activity data stored in a binary data file by a previous sar(1) run. Any of the sar data items may be plotted singly or in combi- nation, 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). The sag utility requires a graphic terminal to draw the graph, and uses tplot(1) to produce its output. When running Solaris 2.x and OpenWindows, perform the following steps: 1. Run an "xterm" as a Tektronics terminal: prompt# xterm -t 2. In the "xterm" window, run sag specifying a tek termi- nal: prompt# sag -T tek options

OPTIONS

The following options are supported and passed through to sar (see sar(1)): -e time Select data up to time. Default is 18:00. -f file Use file as the data source for sar. Default is the current daily data file /usr/adm/sa/sadd. -i sec Select data at intervals as close as possible to sec seconds. -s time Select data later than time in the form hh[:mm]. Default is 08:00. -T term Produce output suitable for terminal term. See tplot(1) for known terminals. Default for term is $TERM. -x spec x axis specification with spec in the form: name[op name]...[lo hi] SunOS 5.8 Last change: 4 Mar 1998 1 User Commands sag(1) name is either a string that will match a column header in the sar report, with an optional device name in square brackets, for example, r+w/s[dsk-1], or an integer value. op is + - * or / surrounded by blank spaces. Up to five names may be specified. Parentheses are not recognized. Contrary to custom, + and - have precedence over * and /. Evaluation is left to right. Thus, A/A+B*100 is evaluated as (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. Enclose spec in double-quotes ("") if it includes white space. A single spec is permitted for the x axis. If unspeci- fied, time is used. -y spec y axis specification with spec in the same form as for -x. Up to 5 spec arguments separated by a semi-colon (;) may be given for -y. The -y default is: -y"%usr0100;%usr+%sys0100;%usr+%sys+%wio0100"

EXAMPLES

Example 1: Examples of the sag command. To see today's CPU utilization: example$ sag To see activity over 15 minutes of all disk drives: example$ TS=`date +%H:%M` example$ sar -o /tmp/tempfile 60 15 example$ TE=`date +%H:%M` example$ sag -f /tmp/tempfile -s $TS -e $TE -y "r+w/s[dsk]"

FILES

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

ATTRIBUTES

See attributes(5) for descriptions of the following attri- butes: SunOS 5.8 Last change: 4 Mar 1998 2 User Commands sag(1) ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWaccu | |_____________________________|_____________________________|

SEE ALSO

sar(1), tplot(1), attributes(5) SunOS 5.8 Last change: 4 Mar 1998 3