mirror of
https://github.com/9fans/plan9port.git
synced 2025-01-12 11:10:07 +00:00
205 lines
5 KiB
Groff
205 lines
5 KiB
Groff
.TH STATS 1
|
|
.SH NAME
|
|
stats, auxstats \- display graphs of system activity
|
|
.SH SYNOPSIS
|
|
.B stats
|
|
[
|
|
.BI - option
|
|
]
|
|
[
|
|
.IB machine\fR[ : path\fR]
|
|
\&...
|
|
]
|
|
.PP
|
|
.B auxstats
|
|
[
|
|
.I machine
|
|
[
|
|
.I path
|
|
] ]
|
|
.SH DESCRIPTION
|
|
.I Stats
|
|
displays a rolling graph of various statistics collected by the operating
|
|
system and updated once per second.
|
|
The statistics may be from a remote
|
|
.I machine
|
|
or multiple
|
|
.IR machines ,
|
|
whose graphs will appear in adjacent columns.
|
|
The columns are labeled by the machine names and the number
|
|
of processors on the machine if it is a multiprocessor.
|
|
.PP
|
|
.I Auxstats
|
|
collects the machine statistics for display by
|
|
.IR stats .
|
|
With no arguments, it collects statistics from the local machine.
|
|
If
|
|
.I machine
|
|
is named, it executes
|
|
.B ssh
|
|
.I machine
|
|
.IR path ;
|
|
when
|
|
.I ssh
|
|
finishes,
|
|
.I auxstats
|
|
sleeps for one minute and runs it again.
|
|
The default
|
|
.I path
|
|
is simply
|
|
.BR auxstats ,
|
|
but since some shells do not execute any sort of user profile
|
|
when run as a non-login shell, it is often necessary to specify
|
|
an exact path.
|
|
.PP
|
|
The right mouse button presents a menu to enable and disable the display
|
|
of various statistics; by default,
|
|
.I stats
|
|
begins by showing the load average on the executing machine.
|
|
.PP
|
|
The
|
|
lower-case
|
|
.I options
|
|
choose the initial set to display:
|
|
.TF [t]tlbpurge
|
|
.TP
|
|
.B "b battery
|
|
percentage battery life remaining.
|
|
.TP
|
|
.B "c context
|
|
number of process context switches per second.
|
|
.TP
|
|
.B
|
|
.B "e ether
|
|
total number of packets sent and received per second.
|
|
.TP
|
|
.B
|
|
.B "E etherin,out
|
|
number of packets sent and received per second, displayed as separate graphs.
|
|
.TP
|
|
.B "f fault
|
|
number of page faults per second.
|
|
.TP
|
|
.B "i intr
|
|
number of interrupts per second.
|
|
.TP
|
|
.B "l load
|
|
(default) system load average.
|
|
The load is computed as a running average of
|
|
the number of processes ready to run, multiplied by 1000.
|
|
On most systems, it changes only every five seconds and has limited accuracy.
|
|
.TP
|
|
.B "m mem
|
|
total pages of active memory.
|
|
The graph displays the fraction
|
|
of the machine's total memory in use.
|
|
.TP
|
|
.B
|
|
.B "n etherin,out,err
|
|
number of packets sent and received per second, and total number of errors, displayed as separate graphs.
|
|
.TP
|
|
.B "s syscall
|
|
number of system calls per second.
|
|
.TP
|
|
.B "w swap
|
|
number of valid pages on the swap device.
|
|
The swap is displayed as a
|
|
fraction of the number of swap pages configured by the machine.
|
|
.TP
|
|
.B "8 802.11b
|
|
display the signal strength detected by the 802.11b wireless ether card; the value
|
|
is usually below 50% unless the receiver is in the same room as the transmitter, so
|
|
a midrange value represents a strong signal.
|
|
.PD
|
|
.PP
|
|
The graphs are plotted with time on the horizontal axis.
|
|
The vertical axes range from 0 to 1000*sleepsecs,
|
|
multiplied by the number of processors on the machine
|
|
when appropriate.
|
|
The only exceptions are
|
|
memory,
|
|
and swap space,
|
|
which display fractions of the total available,
|
|
system load, which displays a number between 0 and 1000,
|
|
idle and intr, which display percentages and the Ethernet error count,
|
|
which goes from 0 to 10..
|
|
If the value of the parameter is too large for the visible range, its value is shown
|
|
in decimal in the upper left corner of the graph.
|
|
.PP
|
|
Upper-case options control details of the display.
|
|
All graphs are affected; there is no mechanism to
|
|
affect only one graph.
|
|
.TP
|
|
.BI -T " sleepsecs
|
|
Set the number of seconds between samples to
|
|
.I sleepsecs
|
|
(default one second).
|
|
.TP
|
|
.BI -S " scale
|
|
Sets a scale factor for the displays. A value of 2, for example,
|
|
means that the highest value plotted will be twice as large as the default.
|
|
.TP
|
|
.B -L
|
|
Plot all graphs with logarithmic
|
|
.I y
|
|
axes.
|
|
The graph is plotted so the maximum value that would be displayed on
|
|
a linear graph is 2/3 of the way up the
|
|
.I y
|
|
axis and the total range of the graph is a factor of 1000; thus the
|
|
.I y
|
|
origin is 1/100 of the default maximum value and the top of the graph is
|
|
10 times the default maximum.
|
|
.TP
|
|
.B -Y
|
|
If the display is large enough to show them,
|
|
place value markers along the
|
|
.I y
|
|
axes of the graphs.
|
|
Since one set of markers serves for all machines across the display,
|
|
the values in the markers disregard scaling factors due to multiple processors
|
|
on the machines. On a graph for a multiprocessor,
|
|
the displayed values will be larger
|
|
than the markers indicate.
|
|
The markers appear along the right, and the markers
|
|
show values appropriate to the rightmost machine; this only
|
|
matters for graphs such as memory that have machine-specific
|
|
maxima.
|
|
.PP
|
|
Typing `q' or DEL causes
|
|
.I stats
|
|
to exit.
|
|
.PD
|
|
.SH EXAMPLE
|
|
Show the load, memory, interrupts, system calls, context switches,
|
|
and ethernet packets for the local machine,
|
|
a remote BSD machine
|
|
.IR daemon ,
|
|
and
|
|
a remote Linux machine
|
|
.IR tux .
|
|
.I Auxstats
|
|
is not in
|
|
.IR tux 's
|
|
path, so the full path must be given.
|
|
.IP
|
|
.EX
|
|
stats -lmisce `hostname` daemon \e
|
|
tux:\*9/bin/auxstats
|
|
.EE
|
|
.SH SOURCE
|
|
.B \*9/src/cmd/draw/stats.c
|
|
.PP
|
|
.B \*9/src/cmd/auxstats
|
|
.SH BUGS
|
|
The
|
|
.I auxstats
|
|
binary needs read access to
|
|
.B /dev/kmem
|
|
in order to collect network statistics on non-Linux systems.
|
|
Typically this can be arranged by setting the
|
|
.I auxstat
|
|
binary's
|
|
group to
|
|
.B kmem
|
|
and then turning on its set-gid bit.
|