SNMPXPERFMON(1) — NEWS-OS Programmer’s Manual

NAME

snmpxperfmon - graphical SNMP performance monitor

SYNOPSIS

snmpxperfmon agent [qualifiers] [options]

DESCRIPTION

snmpxperfmon is a graphical performance monitor modeled after xperfmon(1). It is compatible with X-Windows version 11. Unlike xperfmon however, snmpxperfmon monitors net interfaces instead of systems. Specifically, snmpxperfmon monitors any or all of the input and output byte and packet counts on all net interfaces on a gateway. agent, the agent to be monitored is specified as a dot notation address such as ’128.213.1.2’.

QUALIFIERS

The qualifiers specified on a command line allows the user to restrict monitoring to a subset of the possible information. Valid qualifiers are:

-input: monitor only input information.

-output: monitor only output information.

-bytes: monitor only byte counts.

-packets: monitor only packet counts. Note that these qualifiers may be combined, so that, for example, specifying input bytes on the command line will result in snmpxperfmon monitoring only the count of bytes coming into the net interfaces on a gateway.

SNMP OPTIONS

Possible options that may be specified on the command line are:

--c community: set the name of the community for queries to agent. If this option is not used, the community name defaults to ’public’.

--f font: set the font used to font.

--i interval: set the interval for querying to interval

X-WINDOW OPTIONS

The following are the X-window options. These options follow the X-window convention as closely as possible. -display host:display

This option allows snmpxperfmon to be run on a remote X server. In specifying the display, use the standard X format. For example, rebel:0.0.

Using X Resources

Snmpxperfmon reads the command line arguments, then passes through the users $HOME/.Xdefaults file and creates a local resource database. Any command line option will take precedence over the .Xdefaults parameter. Here are a list of all settable snmpxperfmon parameters in .Xdefaults format, the values given are the default values if nothing is specified:

snmpxperfmon.display:1:0.0
snmpxperfmon.font:6x10
snmpxperfmon.geometry:NULL (as big as font dictates)
snmpxperfmon.borderwidth:2
snmpxperfmon.name:snmpxperfmon
snmpxperfmon.reverseVideo:off
snmpxperfmon.color:on
snmpxperfmon.background:NavyBlue
snmpxperfmon.foreground:white
snmpxperfmon.bordercolor:red
snmpxperfmon.graphcolor:yellow
snmpxperfmon.interval:60
snmpxperfmon.community:"public"
snmpxperfmon.graphHeight:200
snmpxperfmon.displayMax:500

BUGS

The initial 5 or 6 points upon starting this application up are skewed upward badly. There appears to be no way of correcting for this. The maximum number of bytes and packets in the graph y-axes displayed is statically defined to be MAXBYTES and MAXPKTS in the header file snmpxperfmon.h. These default definitions may not be suitable for individual sites. Due to the amount of processing that this application performs to plot a single point, it is not advisable to run it with an interval of less than five seconds.

Museum