perfmeter(1)

NAME

perfmeter − display system performance values in multiple dials or strip charts

SYNOPSIS

perfmeter [ −a ] [ −d ] [ −g ] [ −h h-hand-int ] [ −l ] [ −m m-hand-int ] [ −n sample-filename ]
[ −name app-name ] [ −p page-length ] [ −s sample-time ] [ −t value ] [ −v ]
[ −C chart ceiling ] [ −H ] [ −L ] [ −M chart smax minmax maxmax ] [ −S ]
[ −V ] [ −Wn ] [ +Wn ] [ hostname ]

AVAILABILITY

This command is available with the OpenWindows environment.

DESCRIPTION

perfmeter is an OpenWindows XView utility that displays performance values (statistics) for a given hostname. If no host is specified, statistics on the current host are metered. The rstatd(8C) daemon must be running on the machine being metered.

perfmeter has two display formats. You can display performance values in the form of strip charts (the default) . Alternatively, the performance information can be displayed in the form of multiple meter dials. By default, the display is updated with a sample-time of 2 seconds. The hour hand of a meter represents the average over a 20-second interval; the minute hand, the average over 2 seconds. The default value displayed is the percent of CPU being utilized.

The maximum scale value for the strip chart will automatically double or halve to accommodate increasing or decreasing values for the host machine. This scale can be restricted to a certain range with the −M option.

OPTIONS

−a Display all the performance values simultaneously.

−d Start the perfmeter display, by showing metered dials.

−g Start the perfmeter display, by showing strip charts.

−h h-hand-int
Set the hour-hand interval to h-hand-int seconds.

−l Log the perfmeter samples to a file.

−m m-hand-int
Set the minute hand interval to m-hand-int seconds.

−n sample-filename
Name of the file to use, when saving perfmeter samples.

−name app-name
This option specifies the application name under which resources are to be obtained, rather than the default executable file name. app-name should not contain “.” or “∗” characters.

−p page-length
Sets the page length for perfmeter samples written to file. The default is 60 lines per page.

−s sample-time
Set the sample time to sample-time seconds.

−t value
This option can be present multiple times, and it determines which performance value are to be monitored. The following options are available:

cpu Percent of CPU being utilized.

pkts Ethernet packets per second.

page Paging activity in pages per second.

swap Jobs swapped per second.

intr Number of device interrupts per second.

disk Disk traffic in transfers per second.

cntxt Number of context switches per second.

load Average number of runnable processes over the last minute.

colls Collisions per second detected on the ethernet.

errs Errors per second on receiving packets.

−v Show version number

−C chart ceiling
Set a ceiling value for a given strip chart. If the value goes beyond this ceiling and perfmeter is running on a color screen, then this portion of the strip chart will be displayed in red.

−H Multiple dials or strip charts will be displayed initially in a horizontal direction.

−L If the −g option is present, then initially display the strip charts in line format. direction.

−M chart smax minmax maxmax
Set a range of maximum values for the given strip chart. Values for each of the arguments should be powers of 2. smax sets the starting maximum-value. minmax sets the lowest allowed maximum-value for the scale. maxmax sets the highest allowed maximum-value.

−S If the −g option is present, then initially display the strip charts in a solid filled format.

−V Multiple dials or strip charts will be displayed initially in a vertical direction.

−Wn Start perfmeter with no title line.

+Wn Start perfmeter with a title line present.

USAGE

Commands

You can add extra values to be monitored by clicking the RIGHT mouse button, and selecting from the popup menu. Alternatively, you can select Properties from this menu, and this will bring up the property sheet for the tool. The property sheet will allow you to modify what the perfmeter is monitoring, which direction graphs or dials are displayed in, whether to display dials or graphs, if the graph is solid or lined, whether to monitor a local machine or a remote one, and how often it checks.

Note that perfmeter does not try to do a best fit, given the shape of the window and the number of graphs you wish to display. For example, if the display direction is vertical, and you are currently displaying ten graphs in a tall narrow window, then resizing the window to be short and wide will result in ten very thin wide graphs.

Most meter parameters can be modified through the use of keyboard accelerators. Move the pointer into the window and type one of the following keyboard keys:

d Toggle the direction the graphs or dials are displayed in, between horizontal and vertical.

g Toggle the display between graphs and dials.

h Decrease hourhandintv by one

H Increase hourhandintv by one

m Decrease minutehandintv by one

M Increase minutehandintv by one

q Quit the perfmeter

s If graphs are being displayed, toggle between lined and solid graphs.

S Toggle the saving of samples to file.

t Toggle between the monitoring of the local machine and a remote machine. Note that a remote machine name must have already been setup via the tools property sheet.

1−9 Set sampletime to a range from 1 to 9 seconds.

On startup, perfmeter will use the following X resources:

Resource: deskset.perfmeter.displayGraph

Values: True, False (True)

Description Indicates whether perfmeter should be started showing strip graphs or metered dials.

Resource: deskset.perfmeter.hourInterval

Values: Hour hand interval (numeric)

Description Set the hour-hand interval to this number of seconds.

Resource: deskset.perfmeter.minInterval

Values: Minute hand interval (numeric)

Description Set the minute-hand interval to this number of seconds.

Resource: deskset.perfmeter.sampleTime

Values: Sample time (numeric)

Description The interval in seconds, between which samples are taken.

Resource: deskset.perfmeter.resizeGraphView

Values: True, False (True)

Description Indicates whether changing the number of graphs being monitored, should cause the window to be resized.

Resource: deskset.perfmeter.showLocal

Values: True, False (True)

Description Indicates whether the local or the remote host should be initially displayed.

Resource: deskset.perfmeter.monitor

Values: Values to monitor (string)

Description A comma separated list of different values to monitor. These values are identical to their command line equivalents.

Resource: deskset.perfmeter.machine

Values: Machine to monitor (string)

Description The machine for which the strip graphs or metered dials will be displayed.

Resource: deskset.perfmeter.displayVertical

Values: True, False (True)

Description Indicates whether the strip graphs or metered dials will be displayed in a horizontal or vertical direction.

Resource: deskset.perfmeter.graphSolid

Values: True, False (False)

Description If the strip graphs are being displayed, this resource indicates whether lined or solid graphs are displayed.

Resource: deskset.perfmeter.cpuMaxValues

Values: Starting, lowest and highest maximum values (numeric)

Description The starting, lowest and highest maximum values for the cpu graph or dial.

Resource: deskset.perfmeter.pktsMaxValues

Values: Starting, lowest and highest maximum values (numeric)

Description The starting, lowest and highest maximum values for the pkts graph or dial.

Resource: deskset.perfmeter.pageMaxValues

Values: Starting, lowest and highest maximum values (numeric)

Description The starting, lowest and highest maximum values for the page graph or dial.

Resource: deskset.perfmeter.swapMaxValues

Values: Starting, lowest and highest maximum values (numeric)

Description The starting, lowest and highest maximum values for the swap graph or dial.

Resource: deskset.perfmeter.intrMaxValues

Values: Starting, lowest and highest maximum values (numeric)

Description The starting, lowest and highest maximum values for the intr graph or dial.

Resource: deskset.perfmeter.diskMaxValues

Values: Starting, lowest and highest maximum values (numeric)

Description The starting, lowest and highest maximum values for the disk graph or dial.

Resource: deskset.perfmeter.cntxtMaxValues

Values: Starting, lowest and highest maximum values (numeric)

Description The starting, lowest and highest maximum values for the cntxt graph or dial.

Resource: deskset.perfmeter.loadMaxValues

Values: Starting, lowest and highest maximum values (numeric)

Description The starting, lowest and highest maximum values for the load graph or dial.

Resource: deskset.perfmeter.collMaxValues

Values: Starting, lowest and highest maximum values (numeric)

Description The starting, lowest and highest maximum values for the coll graph or dial.

Resource: deskset.perfmeter.errMaxValues

Values: Starting, lowest and highest maximum values (numeric)

Description The starting, lowest and highest maximum values for the err graph or dial.

Resource: deskset.perfmeter.collectWhenObscured

Values: True, False (True)

Description Indicates whether data will be monitored and cached, when the perfmeter window is fully obscured.

Resource: deskset.perfmeter.hasTitle

Values: True, False (False)

Description Indicates whether the perfmeter window has a title line.

Resource: deskset.perfmeter.labelFont

Values: Font name string

Description The name of the font used to display all the labels for the dials and graphs.

Resource: deskset.perfmeter.saveSamples

Values: True, False (False)

Description Indicates whether perfmeter should save monitored sample values to disk.

Resource: deskset.perfmeter.sampleFilename

Values: Filename (string)

Description Name of the file to save sample in. If no filename is given, perfmeter creates a unique filename in the users home directory.

Resource: deskset.perfmeter.samplePageLength

Values: Sample file page length (numeric)

Description The page length (in lines) in the sample file. If no value is given, the default is 60.

Resource: deskset.perfmeter.cpuColor