NAME

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

SYNOPSIS

snmpxperf agent object [options]

DESCRIPTION

snmpxperf is a tool for displaying MIB variable values in graphical form.  The data is displayed as a line graph.  The agent and the MIB variable object to be monitored are specified on the command line.  snmpxperf 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, snmpxperf 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 snmpxperf 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 display mode, polling interval, display range settings. 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”. 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. “Base” sets the displayable lower limit on the Y axis. The default value for “Base” is 0. “Scope” setting specifies the displayable width on the Y axis. The default value for “Scope” is 100. However, in order to ensure that the setting is appropriate for the actual graph to be displayed, “Base” and “Scope” shown on the control panel are automatically adjusted each time the control panel is popped up.

Exit
Exits snmpxperf. 

Help

Version...
Displays version information.

Manual...
Displays the online manual.

OPTIONS

In addition to the standard X Toolkit options, snmpxperf 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 snmpxperf.  The default value for the polling interval is 60 seconds. 

−community name
−c name

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

−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”. 

−scale scalefactor
−s scalefactor

The distance between gradations on the Y axis is specified by scalefactor.  However, if 0 is specified, no gradations will be displayed.  If the display range is changed, the distance between gradations will be automatically reduced.  The default value for the distance between gradations is 100. 

−xmax xmaximum
−x xmaximum

The displayable width of the X axis is specified by xmaximum (seconds).  This setting must be a value greater than the polling value.  The default for the displayable width of the X axis is 600. 

−ymax ymaximum
−y ymaximum

The displayable width of the Y axis is specified by ymaximum.  The default for the displayable width of the Y axis is 100.  The value specified using this option becomes the initial display range value displayed by the control panel. 

−grid points
−g points
−multiple multiple
−m multiple
−Multiple Multiple
−M Multiple

These options specify the distance between the ruled lines parallel to the X axis.  There are three types of ruled lines.  The distance between the first ruled lines is set with the option −grid or −g as the value points.  The default distance for the first ruled lines is 10.  The distance between the first ruled lines becomes the basic distence used for displaying the second and the third ruled lines.  The option −multiple or −m sets the distance between the second ruled lines to a multiple of the basic distance.  Also, the option −Multiple or −M sets the distance between the third ruled lines to a multiple of the basic distance.  The default value of multiple and Multiple are 10 and 100, respectively.  If the distance multiples for the second and the third ruled lines are set to 0, those lines are not displayed.  Also, if the basic distance is set to 0, no ruled lines parallel to the X axis are displayed at all.  If the display range is changed, the ruled lines will be automatically reduced. 

−help

Displays a description of the options unique to snmpxperf. 

RESOURCES

snmpxperf 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. 

Snmpxperf.interval: 60
Snmpxperf.maxInterval: 600
Snmpxperf.community: public
Snmpxperf.mode: absolute
Snmpxperf.yscale: 100
Snmpxperf.ymax: 100
Snmpxperf.ygrid: 10
Snmpxperf.ymultiple: 10
Snmpxperf.yMultiple: 100
Snmpxperf.xscale: 0
Snmpxperf.xmax: 600
Snmpxperf.xgrid: 0
Snmpxperf.xmultiple: 10
Snmpxperf.xMultiple: 100

EXAMPLES

To monitor the number of input packets per second for interface number 1 of agent 133.138.1.1: % snmpxperf 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: % snmpxperf 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/Snmpxperf
/usr/lib/X11/ja_JP.SJIS/app-defaults/Snmpxperf
/usr/lib/X11/ja_JP.EUC/app-defaults/Snmpxperf

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