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

NAME

snmpstat − SNMP querying application for multiple agents with database support

SYNOPSIS

snmpstat configfile

DESCRIPTION

snmpstat is a generic querying application designed to execute on a host and query any number of monitoring agents for information over an extended period of time. What information is requested, from which gateway, and how often the information is requested are all dictated by the snmpstat configuration file configfile (described below). snmpstat is an application process, that allows the querying granularity at the level of both agents and variables by means of specifying multipliers to a (user configurable base interval). (See configuration file description below). So, for example, with a base interval of X seconds, querying of a given agent with interval multiplier Y for a variable with interval multiplier Z will occur every X ∗ Y ∗ Z seconds. Currently, snmpstat output can be logged into an INGRES database, a UNIX flat file or both.

SNMPSTAT CONFIGURATION FILE

The snmpstat configuration file is consulted upon startup of an snmpstat process. Fields in the configuration file are used to determine the base interval for querying, monitoring agents to be queried, how often each agent is to be queried, how often each variable should be queried for, and what is to be done with the variable values returned. The general format of the configuration file is an AGENT line (see below) followed by a list of LOG lines (each corresponding to a variable to be queried for at the monitoring agent specified by the AGENT line), with this grouping of AGENT, and LOG lines repeated for each monitoring agent. Options in the configuration file are:

-BASE interval: set the base querying interval for this invocation of the application to interval seconds. The interval must be specified in seconds, and a line of this form must occur at least once in the configuration file. In the event that multiple lines of this form are found in a single configuration file, the last one will be taken.

-AGENT ipadd name community-name agent-multiplier timeout retries: query the monitoring agent at ip address ipadd using community name community-name. Perform querying of this agent every agent-multiplier base intervals. During queries, set the query timeout interval (after which retransmission occurs) to timeout seconds, and retry query transmissions retries times. agent-multiplier, timeout and retries are all integers, and are constrained to be less than 2∗∗31 - 1. ipadd should be a dot notation IP address such as 128.111.222.222. Finally, name is used to identify this agent in all output.

-LOG variable interval-multiplier: Query for the variable variable every interval-multiplier’th time the agent to which the LOG line corresponds is queried. For example, if the interval multiplier is 2 and the agent is queried every 3 base intervals, the value of this variable will be queried for every 6 base intervals. Note that an AGENT line must precede a LOG line. Names of variables to be logged should be specified beginning after ’_iso_org_dod_internet’: that is, generic MIB variables should be specified beginning with _mib_mgmt, whereas enterprise specific variables should be specified beginning with _private.

-LOGFILE logfile: log output from snmpstat into the UNIX flat file named logfile. All output from snmpstat will be logged into this logfile if it is specified. If no LOGFILE line occurs in the snmpstat configuration file, output will not be logged to a UNIX flat file.

-INGRES database: log output from snmpstat into the INGRES database database. All output from snmpstat will be logged into this database if it is specified. If no INGRES line occurs in the snmpstat configuration file, output will not be logged into a database. Note that the INGRES database has to contain a table of suitable format. Please refer to the README file in the snmp/ directory of the distribution for more details

FILES

/etc/snmp.variablesThe variable initfile
configfileThe snmpstat configfile
fileFiles to log/watch variable values