sys/man/8/stats

   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 "d draw
  43 draw memory allocation size in bytes.
  44 .TP
  45 .B
  46 .B "e ether
  47 total number of packets sent and received per second.
  48 .TP
  49 .B
  50 .B "E etherin,out
  51 number of packets sent and received per second, displayed as separate graphs.
  52 .TP
  53 .B "f fault
  54 number of page faults per second.
  55 .TP
  56 .B "i intr
  57 number of interrupts per second.
  58 .TP
  59 .B "I idle
  60 system load, % time in idle, and % time in interrupts.
  61 The last two are averaged over all processors on a
  62 multiprocessor.
  63 .TP
  64 .B "k kern
  65 kernel memory allocation size in bytes.
  66 .TP
  67 .B "l load
  68 (default) system load average.
  69 The load is computed as a running average of
  70 the number of processes ready to run, multiplied by 1000.
  71 .TP
  72 .B "m mem
  73 total pages of active memory.
  74 The graph displays the fraction
  75 of the machine's total memory in use.
  76 .TP
  77 .B "n etherin,out,err
  78 number of packets sent and received per second, and total number of errors, displayed as separate graphs.
  79 .TP
  80 .B "p tlbpurge
  81 number of translation lookaside buffer flushes per second.
  82 .TP
  83 .B "r reclaim
  84 total pages of reclaimable memory.
  85 The graph displays the fraction
  86 of the machine's total memory in use.
  87 .TP
  88 .B "s syscall
  89 number of system calls per second.
  90 .TP
  91 .B "t tlbmiss
  92 number of translation lookaside buffer misses per second.
  93 .TP
  94 .B "w swap
  95 number of valid pages on the swap device.
  96 The swap is displayed as a
  97 fraction of the number of swap pages configured by the machine.
  98 .TP
  99 .B "8 802.11b
 100 display the signal strength detected by the 802.11b wireless ether card; the value
 101 is usually below 50% unless the receiver is in the same room as the transmitter, so
 102 a midrange value represents a strong signal.
 103 .TP
 104 .B "z temp
 105 current temperature reported by the cpu.
 106 .PD
 107 .PP
 108 The graphs are plotted with time on the horizontal axis.
 109 The vertical axes range from 0 to 1000*sleepsecs,
 110 multiplied by the number of processors on the machine
 111 when appropriate.
 112 The only exceptions are
 113 memory,
 114 and swap space,
 115 which display fractions of the total available,
 116 system load, which displays a number between 0 and 1000,
 117 idle and intr, which display percentages and the Ethernet error count,
 118 which goes from 0 to 10..
 119 If the value of the parameter is too large for the visible range, its value is shown
 120 in decimal in the upper left corner of the graph.
 121 .PP
 122 Upper-case options control details of the display.
 123 All graphs are affected; there is no mechanism to
 124 affect only one graph.
 125 .TP
 126 .BI -T " sleepsecs
 127 Set the number of seconds between samples to
 128 .I sleepsecs
 129 (default one second).
 130 .I Sleepsecs
 131 may be a floating-point number.
 132 .TP
 133 .BI -S " scale
 134 Sets a scale factor for the displays.  A value of 2, for example,
 135 means that the highest value plotted will be twice as large as the default.
 136 .TP
 137 .B -L
 138 Plot all graphs with logarithmic
 139 .I y
 140 axes.
 141 The graph is plotted so the maximum value that would be displayed on
 142 a linear graph is 2/3 of the way up the
 143 .I y
 144 axis and the total range of the graph is a factor of 1000; thus the
 145 .I y
 146 origin is 1/100 of the default maximum value and the top of the graph is
 147 10 times the default maximum.
 148 .TP
 149 .B -Y
 150 If the display is large enough to show them,
 151 place value markers along the
 152 .I y
 153 axes of the graphs.
 154 Since one set of markers serves for all machines across the display,
 155 the values in the markers disregard scaling factors due to multiple processors
 156 on the machines. On a graph for a multiprocessor,
 157 the displayed values will be larger
 158 than the markers indicate.
 159 The markers appear along the right, and the markers
 160 show values appropriate to the rightmost machine; this only
 161 matters for graphs such as memory that have machine-specific
 162 maxima.
 163 .PD
 164 .SH FILES
 165 .B /net/ether0/0/stats
 166 .br
 167 .B #c/swap
 168 .br
 169 .B #c/sysstat
 170 .SH SOURCE
 171 .B /sys/src/cmd/stats.c
 172 .SH BUGS
 173 Some machines do not have TLB hardware.