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

NAME

snmpxperf - plot of the value of an MIB object in real-time

SYNOPSIS

snmpxperf agent object [options]

DESCRIPTION

Snmpxperf is a graphical tool which displays the value of an MIB object over time. Snmpxperf also has the ability to display the change in an MIB object over time. The Internet address of the agent and the MIB object must be specified on the command line. Snmpxperf is only able to graph MIB objects with numeric values. This includes Counters, Gauges, Integers, and TimeTicks. If a non-numeric object is specified, an error message will be printed to standard error and no values will be plotted. Snmpxperf is compatible with X-Windows version 11, including the full color set.

agent:
the SNMP agent to be monitored; can be specified as a dot notation address such as 192.33.4.44 or as a hostname.

object:
the MIB variable which you will be plotting on the graph.

SNMP OPTIONS

These options give the user the ability to tailor the SNMP environment. Additionally, described below, there are options which control the graph display. -rate

If specified, snmpxperf will plot the change in an object’s value over time, rather than the raw value.

-xlabel ’label string’
-xl ’label string’

The string after these flags will be used in the display under the X-axis of the graph. Multiple word strings should be enclosed in quotes.

-interval pollint
-i pollint

The integer after these flags specifies the polling interval in seconds. This interval specifies how often snmpxperf will request the object value from the agent.

-community communityid
-c communityid

The name specified after these flags is the community ID that snmpxperf will use to access the agent.

-scale scalefactor
-s scalefactor

The integer found after this option is used as the initial scale for the Y-axis. Snmpxperf will automatically rescale itself up or down if the values retrieved from the agent are out of the current bounds.

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 snmpxperf to be run on a remote X server. In specifying the display, use the standard X format. For example, rebel:0.0.

-font fontname
-fn fontname

Specifies the font to use. snmpxperf will auto-size itself to use any font.

-geometry [=]{width}x{height}[+x+y]

Specify the window geometry in standard X format. The application will check the command line dimensions to make sure they are appropriate. If not, snmpxperf will use its own dimensions calculated from the font information. For example, to specify a window of 100 characters by 66 lines with an upper left hand corner coordinate of (50, 75), you would specify, =100x66+50+75.

-borderwidth bwidthnum
-bw bwidthnum

The integer following these options specifies the width of the border around the window in pixels.

-name iconname
-title iconname

The string that follows these options specifies the string that the window manager will use to label the snmpxperf window when it is iconified.

-reverse
-rv

When specified, the snmpxperf display will have a reverse video effect.

-color

When specified, snmpxperf will use color.

-background bgcolor
-bg bgcolor

Specifies the background color.

-foreground fgcolor
-fg fgcolor

"fgcolor" is a string representing the foreground color.

-border bordercolor
-bd bordercolor

"bordercolor" is a string representing the border color.

-graph ekgcolor
-gc ekgcolor

"ekgcolor" is a string representing the EKG graph color.

Using X Resources

Snmpxperf 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 snmpxperf parameters in .Xdefaults format, the values given are the default values if nothing is specified:

snmpxperf.display:unix:0.0
snmpxperf.font:6x10
snmpxperf.geometry:NULL (as big as font dictates)
snmpxperf.borderwidth:2
snmpxperf.name:snmpxperf
snmpxperf.reverseVideo:off
snmpxperf.color:off
snmpxperf.background:SteelBlue
snmpxperf.foreground:white
snmpxperf.bordercolor:red
snmpxperf.graphcolor:yellow
snmpxperf.rate:off
snmpxperf.xlabel:"Time"
snmpxperf.interval:60
snmpxperf.community:"public"
snmpxperf.yscale:10

EXAMPLES

To monitor the packets per second for interface 1 on agent 192.33.4.20: snmpxperf 192.33.4.20 _mgmt_mib_interfaces_ifTable_ifEntry_ifInUcastPkts_1 -rate To monitor the TCP connections to agent 128.145.44.44 in color with a community name of "pub1" every 5 seconds: snmpxperf 128.145.44.44 _mgmt_mib_tcp_tcpCurrEstabs_0 -color -c pub1 -i 5

BUGS

When creating the resource database, snmpxperf does not look at the XENVIRONMENT variable in the users environment. Snmpxperf is still using X10 style resource management. It does not use the RESOURCE_MANAGER property defined in the X server to look up user specified options. When using large fonts, the snmpxperf window may be too large for the standard display. In this case, the window will be clipped accordingly.

FILES

/etc/snmp.variablesto perform the variable conversion

Museum