| 2 |
- |
1 |
.TH STATS 8
|
|
|
2 |
.SH NAME
|
|
|
3 |
stats \- display graphs of system activity
|
|
|
4 |
.SH SYNOPSIS
|
|
|
5 |
.B stats
|
|
|
6 |
[
|
|
|
7 |
.BI - option
|
|
|
8 |
]
|
|
|
9 |
[
|
|
|
10 |
.I machine
|
|
|
11 |
\&...
|
|
|
12 |
]
|
|
|
13 |
.SH DESCRIPTION
|
|
|
14 |
.I Stats
|
|
|
15 |
displays a rolling graph of various statistics collected by the operating
|
|
|
16 |
system and updated once per second.
|
|
|
17 |
The statistics may be from a remote
|
|
|
18 |
.I machine
|
|
|
19 |
or multiple
|
|
|
20 |
.IR machines ,
|
|
|
21 |
whose graphs will appear in adjacent columns.
|
|
|
22 |
The columns are labeled by the machine names and the number
|
|
|
23 |
of processors on the machine if it is a multiprocessor.
|
|
|
24 |
.PP
|
|
|
25 |
The right mouse button presents a menu to enable and disable the display
|
|
|
26 |
of various statistics; by default,
|
|
|
27 |
.I stats
|
|
|
28 |
begins by showing the load average on the executing machine.
|
|
|
29 |
.PP
|
|
|
30 |
The
|
|
|
31 |
lower-case
|
|
|
32 |
.I options
|
|
|
33 |
choose the initial set to display:
|
|
|
34 |
.TF [t]tlbpurge
|
|
|
35 |
.TP
|
|
|
36 |
.B "b battery
|
|
|
37 |
percentage battery life remaining.
|
|
|
38 |
.TP
|
|
|
39 |
.B "c context
|
|
|
40 |
number of process context switches per second.
|
|
|
41 |
.TP
|
|
|
42 |
.B
|
|
|
43 |
.B "e ether
|
|
|
44 |
total number of packets sent and received per second.
|
|
|
45 |
.TP
|
|
|
46 |
.B
|
|
|
47 |
.B "E etherin,out
|
|
|
48 |
number of packets sent and received per second, displayed as separate graphs.
|
|
|
49 |
.TP
|
|
|
50 |
.B "f fault
|
|
|
51 |
number of page faults per second.
|
|
|
52 |
.TP
|
|
|
53 |
.B "i intr
|
|
|
54 |
number of interrupts per second.
|
|
|
55 |
.TP
|
|
|
56 |
.B "I idle
|
|
|
57 |
system load, % time in idle, and % time in interrupts.
|
|
|
58 |
The last two are averaged over all processors on a
|
|
|
59 |
multiprocessor.
|
|
|
60 |
.TP
|
|
|
61 |
.B "l load
|
|
|
62 |
(default) system load average.
|
|
|
63 |
The load is computed as a running average of
|
|
|
64 |
the number of processes ready to run, multiplied by 1000.
|
|
|
65 |
.TP
|
|
|
66 |
.B "m mem
|
|
|
67 |
total pages of active memory.
|
|
|
68 |
The graph displays the fraction
|
|
|
69 |
of the machine's total memory in use.
|
|
|
70 |
.TP
|
|
|
71 |
.B
|
|
|
72 |
.B "n etherin,out,err
|
|
|
73 |
number of packets sent and received per second, and total number of errors, displayed as separate graphs.
|
|
|
74 |
.TP
|
|
|
75 |
.B "p tlbpurge
|
|
|
76 |
number of translation lookaside buffer flushes per second.
|
|
|
77 |
.TP
|
|
|
78 |
.B "s syscall
|
|
|
79 |
number of system calls per second.
|
|
|
80 |
.TP
|
|
|
81 |
.B "t tlbmiss
|
|
|
82 |
number of translation lookaside buffer misses per second.
|
|
|
83 |
.TP
|
|
|
84 |
.B "w swap
|
|
|
85 |
number of valid pages on the swap device.
|
|
|
86 |
The swap is displayed as a
|
|
|
87 |
fraction of the number of swap pages configured by the machine.
|
|
|
88 |
.TP
|
|
|
89 |
.B "8 802.11b
|
|
|
90 |
display the signal strength detected by the 802.11b wireless ether card; the value
|
|
|
91 |
is usually below 50% unless the receiver is in the same room as the transmitter, so
|
|
|
92 |
a midrange value represents a strong signal.
|
|
|
93 |
.PD
|
|
|
94 |
.PP
|
|
|
95 |
The graphs are plotted with time on the horizontal axis.
|
|
|
96 |
The vertical axes range from 0 to 1000*sleepsecs,
|
|
|
97 |
multiplied by the number of processors on the machine
|
|
|
98 |
when appropriate.
|
|
|
99 |
The only exceptions are
|
|
|
100 |
memory,
|
|
|
101 |
and swap space,
|
|
|
102 |
which display fractions of the total available,
|
|
|
103 |
system load, which displays a number between 0 and 1000,
|
|
|
104 |
idle and intr, which display percentages and the Ethernet error count,
|
|
|
105 |
which goes from 0 to 10..
|
|
|
106 |
If the value of the parameter is too large for the visible range, its value is shown
|
|
|
107 |
in decimal in the upper left corner of the graph.
|
|
|
108 |
.PP
|
|
|
109 |
Upper-case options control details of the display.
|
|
|
110 |
All graphs are affected; there is no mechanism to
|
|
|
111 |
affect only one graph.
|
|
|
112 |
.TP
|
|
|
113 |
.BI -T " sleepsecs
|
|
|
114 |
Set the number of seconds between samples to
|
|
|
115 |
.I sleepsecs
|
|
|
116 |
(default one second).
|
|
|
117 |
.I Sleepsecs
|
|
|
118 |
may be a floating-point number.
|
|
|
119 |
.TP
|
|
|
120 |
.BI -S " scale
|
|
|
121 |
Sets a scale factor for the displays. A value of 2, for example,
|
|
|
122 |
means that the highest value plotted will be twice as large as the default.
|
|
|
123 |
.TP
|
|
|
124 |
.B -L
|
|
|
125 |
Plot all graphs with logarithmic
|
|
|
126 |
.I y
|
|
|
127 |
axes.
|
|
|
128 |
The graph is plotted so the maximum value that would be displayed on
|
|
|
129 |
a linear graph is 2/3 of the way up the
|
|
|
130 |
.I y
|
|
|
131 |
axis and the total range of the graph is a factor of 1000; thus the
|
|
|
132 |
.I y
|
|
|
133 |
origin is 1/100 of the default maximum value and the top of the graph is
|
|
|
134 |
10 times the default maximum.
|
|
|
135 |
.TP
|
|
|
136 |
.B -Y
|
|
|
137 |
If the display is large enough to show them,
|
|
|
138 |
place value markers along the
|
|
|
139 |
.I y
|
|
|
140 |
axes of the graphs.
|
|
|
141 |
Since one set of markers serves for all machines across the display,
|
|
|
142 |
the values in the markers disregard scaling factors due to multiple processors
|
|
|
143 |
on the machines. On a graph for a multiprocessor,
|
|
|
144 |
the displayed values will be larger
|
|
|
145 |
than the markers indicate.
|
|
|
146 |
The markers appear along the right, and the markers
|
|
|
147 |
show values appropriate to the rightmost machine; this only
|
|
|
148 |
matters for graphs such as memory that have machine-specific
|
|
|
149 |
maxima.
|
|
|
150 |
.PD
|
|
|
151 |
.SH FILES
|
|
|
152 |
.B /net/ether0/0/stats
|
|
|
153 |
.br
|
|
|
154 |
.B #c/swap
|
|
|
155 |
.br
|
|
|
156 |
.B #c/sysstat
|
|
|
157 |
.SH SOURCE
|
|
|
158 |
.B /sys/src/cmd/stats.c
|
|
|
159 |
.SH BUGS
|
|
|
160 |
Some machines do not have TLB hardware.
|