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

NAME

snmpgraph − a tool to plot data from snmppoll

SYNOPSIS

DESCRIPTION

snmpgraph is a tool which will produce a graph showing the activity of certain monitored variables over the course of a day, for each interface. Graphs are produced for the chosen variable for each interface. The input files are snmppoll data files, which may be in compressed format. These files are presumed to be in the current directory, unless −date is specified. Input files need not be specified with −Dailysave and −Dailyplot options. All arguments can abbreviated to one letter, except for ’no∗’ arguments, which can be abbreviated to two letters (ex. ’np’ for ’noprint’)

date with this option, the script uses the date supplied and operates on the data for that date. File names, if supplied, will be used.

xpand
with this option, the supplied list of files is expanded to ∗<arg>∗, and is used with the date option above. [Example: "snmpgraph -date 021289 -xpand nyu col-cnl alb-" would act on the following files in the .../data/021289/ directory: 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]

log graph all variables and errors on the same page, with a log scale. This is most useful for presenting information about errors, packets, and octets at the same time, as their scales differ by orders of magnitude. Each error is indicated by a single letter, as follows:

TransmitReceiveInterface
F framingf framings selftest
U underruno overrunm maintenance
C DCDc crc
T CTSa abort
S DSR

single graph each variable by itself on a page. This will produce four graphs per interface, one each for InOctets, OutOctets, InUcastPkts, OutUcastPkts.

dual graph two similar variables together on a page, (eg. In and Out Octets, or In and Out Packets). Two graphs are produced for each interface, one for octets, one for packets.

all this option is the same as specifying single, dual and log; seven graphs will be produced for each interface.

echo enables the echoing of the input file/interface name in each loop.

verbose
enables echoing, and does a csh ’set verbose’.

compress
input files will be compressed during processing.

noprint
generate the data and commands for executing the plots, but do not execute the plots, do not remove the plot data upon termination. (Abbreviation is np).

vars alter the variables which will be graphed (applicable only to single variable graphs).

Graph
enables the user to alter the command used to graph the data.

Xscale
enables the user to alter the x axis scale.

plotter
enables the user to alter the plot program used. Default is psplot.

Dailysave
with this option, the script uses the date supplied and operates on the data for that date placing a copy of the plottable output in the specified PLOTDIR. Plots are not produced. (Abbreviation is DS).

Dailyplot
After the plot data has been separated, this option, specifying the date, and optionally, specifying interfaces to be plotted, will reference the already separated plot data in the PLOTDIR, and output the specified plots to the printer. (Abbreviation is DP).

ENVIRONMENT

This script is currently set up to use the psplot output device; this may be altered within the script for those of you who do not have access to this software. As shipped this tool utilizes the following data from 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 digests the data for one interface for one day, and produces an intermediate output file which consists of each data point, labelled as to what variable it represents; this is then separated into files of graph(1g) input points, for each variable, and the errors. Note: The plot.1.awk script can be generated from its components with the makeawk script and the Begin00, End00, Var00, and Err00 components, which are located in the Report_Root/plot/bin/sedawk directory.

plot.2.awk
this awk script determines when a poll period has been missed, and alters the per variable/errors data file so that the missing period will show as a break when the line is graph. This also creates the label for the variable being graphed.

yscale.awk
this awk script will determine the range of the values, relative to the y-axis, and generate labels for both the x and y axes on the graph.

yscale.l.awk
similar to yscale, this script generates labels for a y-axis which is on a log(10) scale.

BUGS

log10: SING error from the graphing software usually indicates that there is some piece of data which contains a ’0’ coordinate. This tends to happen where there is no input data.

Museum

Related Articles