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(1M) 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 MENU 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

Values:

Color name string or hexadecimal color specification string

Description

The color of the cpu strip chart.

Resource:

deskset.perfmeter.pktsColor

Values:

Color name string or hexadecimal color specification string

Description

The color of the pkts strip chart.

Resource:

deskset.perfmeter.pageColor

Values:

Color name string or hexadecimal color specification string

Description

The color of the page strip chart.

Resource:

deskset.perfmeter.swapColor

Values:

Color name string or hexadecimal color specification string

Description

The color of the swap strip chart.

Resource:

deskset.perfmeter.intrColor

Values:

Color name string or hexadecimal color specification string

Description

The color of the intr strip chart.

Resource:

deskset.perfmeter.diskColor

Values:

Color name string or hexadecimal color specification string

Description

The color of the disk strip chart.

Resource:

deskset.perfmeter.cntxtColor

Values:

Color name string or hexadecimal color specification string

Description

The color of the cntxt strip chart.

Resource:

deskset.perfmeter.loadColor

Values:

Color name string or hexadecimal color specification string

Description

The color of the load strip chart.

Resource:

deskset.perfmeter.collColor

Values:

Color name string or hexadecimal color specification string

Description

The color of the coll strip chart.

Resource:

deskset.perfmeter.errColor

Values:

Color name string or hexadecimal color specification string

Description

The color of the err strip chart.

Resource:

deskset.perfmeter.ceilingColor

Values:

Color name string or hexadecimal color specification string

Description

The color used when any strip chart goes above its ceiling value.

Resource:

deskset.perfmeter.ceilingStyleSolid

Values:

True, False (False)

Description

Indicates how the graph line should be drawn on solid graphs when the current value is above the ceiling value. Setting this resource true indicates that the full line will be drawn in the ceiling color; setting it false means that only the portion above the ceiling value will be drawn in the ceiling color.

Resource:

deskset.perfmeter.cpuCeiling

Values:

cpu ceiling value (numeric)

Description

The ceiling value to use when displaying the cpu strip chart. Values above this will be displayed in a different color on color screens.

Resource:

deskset.perfmeter.pktsCeiling

Values:

pkts ceiling value (numeric)

Description

The ceiling value to use when displaying the pkts strip chart. Values above this will be displayed in a different color on color screens.

Resource:

deskset.perfmeter.pageCeiling

Values:

page ceiling value (numeric)

Description

The ceiling value to use when displaying the page strip chart. Values above this will be displayed in a different color on color screens.

Resource:

deskset.perfmeter.swapCeiling

Values:

swap ceiling value (numeric)

Description

The ceiling value to use when displaying the swap strip chart. Values above this will be displayed in a different color on color screens.

Resource:

deskset.perfmeter.intrCeiling

Values:

intr ceiling value (numeric)

Description

The ceiling value to use when displaying the intr strip chart. Values

above this will be displayed in a different color on color screens.

Resource:

deskset.perfmeter.diskCeiling

Values:

disk ceiling value (numeric)

Description

The ceiling value to use when displaying the disk strip chart. Values above this will be displayed in a different color on color screens.

Resource:

deskset.perfmeter.cntxtCeiling

Values:

cntxt ceiling value (numeric)

Description

The ceiling value to use when displaying the cntxt strip chart. Values above this will be displayed in a different color on color screens.

Resource:

deskset.perfmeter.loadCeiling

Values:

load ceiling value (numeric)

Description

The ceiling value to use when displaying the load strip chart. Values above this will be displayed in a different color on color screens.

Resource:

deskset.perfmeter.collCeiling

Values:

coll ceiling value (numeric)

Description

The ceiling value to use when displaying the coll strip chart. Values above this will be displayed in a different color on color screens.

Resource:

deskset.perfmeter.errCeiling

Values:

err ceiling value (numeric)

Description

The ceiling value to use when displaying the err strip chart. Values above this will be displayed in a different color on color screens.

FILES

/etc/inetd.conf

starts statistics server

SEE ALSO

xview(7), netstat(1M), rstatd(1M), vmstat(1M)

Solaris User's Guide

"About Performance Meter" in the Help Handbook available through the Help option on the Workspace menu.