Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
User Commandssag(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 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). 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 terminal: 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]

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 unspecified, 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 attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWaccu

SEE ALSO

 

sar(1), tplot(1), attributes(5)


SunOS 5.9Go To TopLast Changed 4 Mar 1998

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.