WatcherDoc.tioga
Hal Murray, December 3, 1986 11:06:38 am PST
Russ Atkinson (RRA) May 23, 1986 3:08:52 pm PDT
WATCHER
CEDAR 6.1 — FOR INTERNAL XEROX USE ONLY
Watcher
Hal Murray
© Copyright 1986 Xerox Corporation. All rights reserved.
Abstract: Yet another toy to Watch things
Created by: Hal Murray
Maintained by: Hal Murray <Murray.PA>
Keywords: Watch, CPU, Disk, Ethernet
XEROX  Xerox Corporation
   Palo Alto Research Center
   3333 Coyote Hill Road
   Palo Alto, California 94304

For Internal Xerox Use Only
Watcher displays bar graphs (supported by the Histograph class) for CPU usage, words allocated, disk activity, and ethernet activity. The default is 1 second per pixel. That makes the screen about 8 minutes wide. You can use the Interpreter to change Watcher.milliSecondsPerPixel. It takes 50% of a Dorado CPU to paint the Watcher's picture at 80 milliseconds/pixel (Heisenburg strikes again).
The Cpu graph is linear. The others are logarithmic. It is very hard to read off accurate numbers, but that's the cost of being able to distinguish such a wide range of values.
If you want to see a lot of activity, run Walnut or MakeBoot.
When you first run it, Watcher registers a Watcher command so you can easily create another one. If the command line contains a "-", Watcher makes separate graphs for the sending and receive sides.
There are two numbers displayed at the far left of each bar graph. The upper number reports the instantaneous figure displayed on the bar graph, and it is recalculated at every sample. The lower number is an exponentially decreasing average, with the factor being given by Watcher.averageFactor (default 0.9).
The average calculation is performed by
avg ← avg*averageFactor+sample*(1-averageFactor)
The sampling process runs at an elevated priority to get accurate figures, although display is performed at normal priority. The bar graph will adapt its size to the given column.