NAME

snmpxgraph − Tool for plotting data gathered with snmppoll on X11

SYNOPSIS

snmpxgraph [−[all|dual|single|log]] [−compress] [−xscale xl,xh] [−vars "v1 v2 ... vn"] [−date mmddyy] file(s)

DESCRIPTION

snmpxgraph uses xgraph to plot data gathered with snmppoll and display the results onscreen.  Files which can be used as input are compressed data files made by snmppoll.  Input files are assumed to be in the current directory unless the −date option is used.  The following options are available for this command.  Parentheses indicate abbreviated forms of the options. 

-date <date> (-d)
Specifies that all files in the directory (named by date) corresponding to this specification be converted.

-xpand <arg> (-x)
Specifies that all files matching the pattern ∗<arg>∗ (where ∗ is the standard wildcard) be used for input. This option can be used together with the date option. 
For example, the command,
"snmpxgraph -date 021289 -xpand nyu col-cnl alb-"
will use the files,
col-nyu.t1.Z nyu-blan.eth.Z nyu-col.t1.Z nyu-lan.eth.Z nyu-rock.t1.Z nyu-rpi.t.Z rock-nyu.t1.Z rpi-nyu.t1.Z col-cnl.t1.Z alb-lan.eth.Z alb-rpi.ds0.Z
found in the directory .../data/021289/ as input.

-log (-l)
Graphs all variables and errors using log coordinates. Using this option for simultaneously graphing information of different units of measurement such as errors, number of packets and number of octets is useful for finding the relative importance of each type of information.

-single (-s)
Makes graphs for each variable. Specifying this option will make graphs of the four variables: InOctets (number of input octets), OutOctets (number of output octets), InUcastPkts (number of input packets), and OutUcastPkts (number of output packets), for each interface.

-dual (-d)
Graphs two variables together on one page. (e.g. In and Out Octets, or In and Out Packets). Two pages: one for number of octects the other for number of packets, are made for each interface.

-all (-a)
This option is the same as specifying all the options: single, dual and log.  A total of seven graphs are made for each interface. 

-compress (-Z)
Compresses while processing the input file.

-vars <"VAR1, VAR2... VARn">
Specifies the group of variables to be graphed. This option can only be used in single mode.

-xscale <min_val, max_val>
Specifies the range for the x-coordinates.

ENVIRONMENT

This tool operates on values of MIB variables obtained using snmppoll. 

_mgmt_mib_interfaces_ifTable_ifEntry_ifInOctets_
_mgmt_mib_interfaces_ifTable_ifEntry_ifOutOctets_
_mgmt_mib_interfaces_ifTable_ifEntry_ifInUcastPkts_
_mgmt_mib_interfaces_ifTable_ifEntry_ifOutUcastPkts_
_private_enterprise_proteon_xface_comsl_recv-overruns_
_private_enterprise_proteon_xface_comsl_recv-aborts_
_private_enterprise_proteon_xface_comsl_recv-crc-errors_
_private_enterprise_proteon_xface_comsl_recv-framing-errors_
_private_enterprise_proteon_xface_comsl_xmit-underruns_
_private_enterprise_proteon_xface_comsl_xmit-framing-errors_
_private_enterprise_proteon_xface_comsl_xmit-no-dcd-errors_
_private_enterprise_proteon_xface_comsl_xmit-no-cts-errors_
_private_enterprise_proteon_xface_comsl_xmit-no-dsr-errors_
_private_enterprise_proteon_xface_generic_maint-failed_
_private_enterprise_proteon_xface_generic_selftest-failed_

FILES

plot.1.awk
This awk script summarizes the day’s data and makes intermediate files of the input format used by graph(1g) for variables and errors.  Labels indicates each data point and variable name are included in this intermediate file. 
Note: the script plot.1.awk can be made using the makeawk script on each of the parts Begin00, End00, Var00, and Err00.  These are placed in the directory Report_Root/plot/bin/sedawk. 

BUGS

Errors are sometimes returned when xgraph cannot plot non-positive Y values when the logarithmic option is selected.  This occurs when input data contains ’0’ or when there is not input data at all.  The process number is displayed when the command starts and ends.

FILES

snmppoll(1) xgraph(1) snmpgraph(1)

SEE ALSO

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.1C