NAME

snmpxbar − SNMP application for monitoring MIB variable values and displaying them in real time as a bar graph

SYNOPSIS

snmpxbar agent object [options]

DESCRIPTION

snmpxbar is a tool for displaying MIB variable values in graphical form.  The data is displayed as a bar graph.  The agent and the MIB variable object to be monitored are specified on the command line.  snmpxbar is only capable of displaying MIB variables, such as counters, gauges, integers and times, that are returned as numeric values.  If a MIB variable that is not returned as a numeric value is specified, an error dialog box stating that the process cannot continue is displayed, forcing the user to quit the tool.  If a value exceeds the displayable range, snmpxbar automatically adjusts the range to accommodate it. 

agentThe agent should be specified as an address in dot notation, such as 133.138.1.1, or as a hostname. 

objectThe MIB variables to be displayed graphically should be specified, omitting “_iso_org_dod_internet”.  For example, the variable “_iso_org_dod_internet_mgmt_mib_system_sysUpTime_0” would be specified as “_mgmt_mib_system_sysUpTime_0”.  Menu bar in the snmpxbar window permits the user to change the operating conditions, display the online manual, etc.  The options available from the menu bar are as follows.  File

Control...
This item is used to pop up the control panel to change the polling interval, threshold value, display mode or bell settings. The polling interval specifies the number of seconds which must elapse between the sending of variable value queries to the agent. The default value for the polling interval is 60 seconds. If the MIB variable value exceeds the threshold value, the distance from the threshold value to the current value is displayed in red (on color monitors). Also, if bell is set to “on”, the bell sounds. The default threshold value is 10000. The display mode setting specifies the graph format. Three display mode options are available: “Absolute”, “Difference” and “Average”. In the “Absolute” mode, the MIB variable value is displayed as is. In the “Difference” mode, the difference between the current value and the preceding one is displayed. The “Average” mode displays the difference between the current value and the preceding one, divided by the polling interval. The default display mode is “Absolute”.

Exit
Exits snmpxbar. 

Help

Version...
Displays version information.

Manual...
Displays the online manual.

OPTIONS

In addition to the standard X Toolkit options, snmpxbar also supports the following.  −interval seconds
−i seconds

The integer value seconds is used as the polling interval.  This value specifies the number of seconds which must elapse between the sending of variable value queries to the agent by snmpxbar.  The default value for the polling interval is 60 seconds. 

−threshold value
−t value

This is an integer that specifies the threshold value when monitoring MIB variables.  If the MIB variable value exceeds the threshold value, the distance from the threshold value to the current value is displayed in red (on color monitors).  The default threshold value is 10000. 

−abs
−diff
−av

Specifies the graph format.  Three display mode options are available: “Absolute”, “Difference” and “Average”.  In the “Absolute” mode, the MIB variable value is displayed as is.  In the “Difference” mode, the difference between the current value and the preceding one is displayed.  The “Average” mode displays the difference between the current value and the preceding one, divided by the polling interval.  Specifying −abs results in the “Absolute” mode, −diff in the “Difference” mode and −av in the “Average” mode.  The default display mode is “Absolute”. 

−shift percent
−s percent

The amount of change in the graph’s display range is specified using percent as a percentage of the current display range.  This value is used when a new value to be displayed exceeds the current display range.  The default change in the display range is 20 percent. 

−xlabel string
−xl string
−l string

The character string specified using string is displayed as the label for the graph.  The character string must be enclosed in quotation marks if it contains more than one word.  The default label is the MIB variable name. 

−community name
−c name

The community name used when snmpxbar accesses the agent is specified using name.  The default community name is “public”. 

−bell on/off
−b on/off

Specifies whether or not the bell should sound when a variable value exceeds the threshold value.  The bell default is “on”. 

−help

Displays a description of the options unique to snmpxbar. 

RESOURCES

snmpxbar supports all of the standard resource names and class names included in X Toolkit.  In addition, the following application resources may be used.  The default values are shown below. 

Snmpxbar.interval: 60
Snmpxbar.maxInterval: 600
Snmpxbar.community: public
Snmpxbar.threshold: 10000
Snmpxbar.mode: absolute
Snmpxbar.shift: 20
Snmpxbar.bell: on
Snmpxbar.maxThreshold: 999999999
Snmpxbar.minThreshold: −999999999

EXAMPLES

To monitor the number of input packets per second for interface number 1 of agent 133.138.1.1: % snmpxbar 133.138.1.1 _mgmt_mib_interfaces_ifTable_ifEntry_ifInUcastPkts_1 −av To monitor the number of TCP connections to agent 133.138.1.1 under the community name pub1 every 5 seconds: % snmpxbar 133.138.1.1 _mgmt_mib_tcp_tcpCurrEstab_0 −c pub1 −i 5

BUGS

There may be cases in which changes to the display may not be clear on monochrome displays.  The use of a color display is recommended. 

FILES

/etc/snmp.variables
/usr/sony/doc/SNMP
/usr/lib/X11/app-defaults/Snmpxbar
/usr/lib/X11/ja_JP.SJIS/app-defaults/Snmpxbar
/usr/lib/X11/ja_JP.EUC/app-defaults/Snmpxbar

REFERENCES

J.D. Case, J.R. Davin, M.S. Fedor, M.L. Schoffstall, Simple Network Management Protocol, Request for Comments 1157, Network Information Center, SRI International, Menlo Park, California, May, 1990.  M.T. Rose, K. McCloghrie, Structure of Management Information, Request for Comments 1155, Network Information Center, SRI International, Menlo Park, California, May, 1990.  K. McCloghrie, M.T. Rose, Management Information Base, Request for Comments 1156, Network Information Center, SRI International, Menlo Park, California, May, 1990.  M.T. Rose, Editor Management Information Base: MIB-II, Request for Comments 1158, Network Information Center, SRI International, Menlo Park, California, May, 1990. 

NEWS-OSRelease 4.2.1R