1sag(1)                           User Commands                          sag(1)
2
3
4

NAME

6       sag - system activity graph
7

SYNOPSIS

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

DESCRIPTION

14       The sag utility graphically displays the system activity data stored in
15       a binary data file by a previous sar(1) run. Any of the sar data  items
16       may be plotted singly or in combination, as cross plots or versus time.
17       Simple arithmetic combinations of data may be  specified.  sag  invokes
18       sar  and  finds  the  desired  data  by string-matching the data column
19       header (run sar to see what is available). The sag utility  requires  a
20       graphic  terminal  to  draw the graph, and uses tplot(1) to produce its
21       output. When running Solaris 2.x and OpenWindows, perform the following
22       steps:
23
24           1.     Run an xterm as a Tektronics terminal: prompt# xterm -t
25
26           2.     In  the  xterm  window,  run  sag specifying a tek terminal:
27                  prompt# sag -T tek options
28

OPTIONS

30       The following options are supported and  passed  through  to  sar  (see
31       sar(1)):
32
33       -e time    Select data up to time. Default is 18:00.
34
35
36       -f file    Use  file as the data source for sar. Default is the current
37                  daily data file /usr/adm/sa/sadd.
38
39
40       -i sec     Select data at intervals as close as possible  to  sec  sec‐
41                  onds.
42
43
44       -s time    Select  data later than time in the form hh[:mm]. Default is
45                  08:00.
46
47
48       -T term    Produce output suitable for terminal term. See tplot(1)  for
49                  known terminals. Default for term is $TERM.
50
51
52       -x spec    x axis specification with spec in the form:
53
54                  name[op name]...[lo hi]
55
56                  name  is  either a string that will match a column header in
57                  the sar report, with  an  optional  device  name  in  square
58                  brackets, for example, r+w/s[dsk−1], or an integer value. op
59                  is + − * or / surrounded by blank spaces. Up to  five  names
60                  may  be  specified. Parentheses are not recognized. Contrary
61                  to custom, + and - have precedence over * and /.  Evaluation
62                  is   left   to   right.  Thus,  A/A+B*100  is  evaluated  as
63                  (A/(A+B))*100, and A+B/C+D is (A+B)/(C+D).  lo  and  hi  are
64                  optional  numeric  scale  limits.  If  unspecified, they are
65                  deduced from the data.
66
67                  Enclose spec in double-quotes  ("")  if  it  includes  white
68                  space.
69
70                  A  single  spec is permitted for the x axis. If unspecified,
71                  time is used.
72
73
74       -y spec    y axis specification with spec in the same form as  for  -x.
75                  Up  to 5 spec arguments separated by a semi-colon (;) may be
76                  given for -y. The -y default is:
77
78                  -y"%usr0100;%usr+%sys0100;%usr+%sys+%wio0100"
79
80

EXAMPLES

82       Example 1 Examples of the sag command.
83
84
85       To see today's CPU utilization:
86
87
88         example$ sag
89
90
91
92
93       To see activity over 15 minutes of all disk drives:
94
95
96         example$ TS=`date +%H:%M`
97         example$ sar -o /tmp/tempfile 60 15
98         example$ TE=`date +%H:%M`
99         example$ sag -f /tmp/tempfile -s $TS -e $TE -y "r+w/s[dsk]"
100
101
102

FILES

104       /usr/adm/sa/sadd    daily data file for day dd
105
106

ATTRIBUTES

108       See attributes(5) for descriptions of the following attributes:
109
110
111
112
113       ┌─────────────────────────────┬─────────────────────────────┐
114       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
115       ├─────────────────────────────┼─────────────────────────────┤
116       │Availability                 │SUNWaccu                     │
117       └─────────────────────────────┴─────────────────────────────┘
118

SEE ALSO

120       sar(1), tplot(1), attributes(5)
121
122
123       System Administration Guide: Advanced Administration
124
125
126
127SunOS 5.11                        4 Mar 1998                            sag(1)
Impressum