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

NAME

snmpxbar - bar chart of the value of an MIB object in real-time

SYNOPSIS

snmpxbar agent object [options]

DESCRIPTION

Snmpxbar is a graphical tool which displays the value of an MIB object at a given instance. The graph is in the form of a bar chart. The Internet address of the agent and the MIB object must be specified on the command line. Snmpxbar 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. If a value is retrieved which is larger than the current graph maximum value, snmpxbar will rescale itself. Snmpxbar is compatible with X-Windows version 11. Snmpxbar supports color, but must be compiled in.

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. The display contains button boxes which control certain functions of snmpxbar. They are as follows: QUIT:

Exit the snmpxbar program.

Interval xxxxs:

Specifies the current polling interval in seconds. This is only a display button box.

+1:

When any mouse button is clicked in this button box, the polling interval will increase by one second. The maximum polling interval is 9999 seconds. The "Interval" display button box will change to reflect the new polling interval.

-1:

When any mouse button is clicked in this button box, the polling interval will decrease by one second. The minimum polling interval is 1 second. The "Interval" display button box will change to reflect the new polling interval.

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. -t threshhold

The number after this flag specifies the threshold value for the MIB object being monitored. When a value is returned for the MIB object which is greater than or equal to the threshold, the graph bar will be plotted in red on a color workstation from the threshold point to the returned value. On a monochrome workstation, the graph bar will be dashed. The default threshold is infinity. -l ’label string’

The string after these flags will be used in the display to label the graph bar. Multiple word strings should be enclosed in quotes. The default label is the last portion of the MIB object name.

-i pollint

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

-c communityid

The name specified after these flags is the community ID that snmpxbar will use to access the agent. The default community name is "public"

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 snmpxbar 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

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

snmpxbar.display:1:0.0
snmpxbar.font:6x10
snmpxbar.geometry:NULL (as big as font dictates)
snmpxbar.borderwidth:2
snmpxbar.name:snmpxbar
snmpxbar.reverseVideo:off
snmpxbar.color:on
snmpxbar.background:NavyBlue
snmpxbar.foreground:white
snmpxbar.bordercolor:red
snmpxbar.alarmcolor:red
snmpxbar.xlabel:NULL
snmpxbar.interval:60
snmpxbar.community:"public"
snmpxbar.threshhold:0
snmpxbar.bell:on

EXAMPLES

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

BUGS

Snmpxbar does not perform any user X resource functions. Many of the X parameters are hard coded into the program. Only font supported is 6x10. Plans call for this functionality to be added in the future. Need two separate binaries to run monochrome and color.

FILES

/etc/snmp.variablesto perform the variable conversion

Museum