SNMPDELTA(1)							     Net-SNMP							      SNMPDELTA(1)

NAME

       snmpdelta - Monitor delta differences in SNMP Counter values

SYNOPSIS

       snmpdelta  [ COMMON OPTIONS ] [-Cf] [ -Ct ] [ -Cs ] [ -CS ] [ -Cm ] [ -CF configfile ] [ -Cl ] [ -Cp period ] [ -CP Peaks ] [ -Ck ] [ -CT ]
       AGENT OID [ OID ... ]

DESCRIPTION

       snmpdelta will monitor the specified integer valued OIDs, and report changes over time.

       AGENT identifies a target SNMP agent, which is instrumented to monitor the given objects.  At its simplest, the	AGENT  specification  will
       consist of a hostname or an IPv4 address.  In this situation, the command will attempt communication with the agent, using UDP/IPv4 to port
       161 of the given target host. See snmpcmd(1) for a full list of the possible formats for AGENT.

       OID is an object identifier which uniquely identifies the object type within a MIB. Multiple OIDs can be specified on  a  single  snmpdelta
       command.

OPTIONS

       COMMON OPTIONS
	       Please see snmpcmd(1) for a list of possible values for COMMON OPTIONS as well as their descriptions.

       -Cf     Don't  fix errors and retry the request.  Without this option, if multiple oids have been specified for a single request and if the
	       request for one or more of the oids fails, snmpdelta will retry the request so that data for oids apart from the ones  that  failed
	       will still be returned.	Specifying -Cf tells snmpdelta not to retry a request, even if there are multiple oids specified.

       -Ct     Flag will determine time interval from the monitored entity.

       -Cs     Flag will display a timestamp.

       -CS     Generates  a  "sum count" in addition to the individual instance counts.  The "sum count" is the total of all the individual deltas
	       for each time period.

       -Cm     Prints the max value ever attained.

       -CF configfile
	       Tells snmpdelta to read it's configuration from the specified file.  This options allows the input to be set up in  advance  rather
	       than having to be specified on the command line.

       -Cl     Tells snmpdelta to write it's configuration to files whose names correspond to the MIB instances monitored.  For example, snmpdelta
	       -Cl localhost ifInOctets.1 will create a file "localhost-ifInOctets.1".

       -Cp     Specifies the number of seconds between polling periods.  Polling constitutes sending a request to the agent. The  default  polling
	       period is one second.

       -CP peaks
	       Specifies  the  reporting period in number of polling periods.  If this option is specified, snmpdelta polls the agent peaks number
	       of times before reporting the results.  The result reported includes the average value over the reporting period. In addition,  the
	       highest polled value within the reporting period is shown.

       -Ck     When  the  polling  period (-Cp) is an increment of 60 seconds and the timestamp is displayed in the output (-Cs), then the default
	       display shows the timestamp in the format hh:mm mm/dd. This option causes the timestamp format to be hh:mm:ss mm/dd.

       -CT     Makes snmpdelta print its output in tabular form.

       -Cv vars/pkt
	       Specifies the maximum number of oids allowed to be packaged in a single PDU. Multiple PDUs can be created in a single request.  The
	       default value of variables per packet is 60.  This option is useful if a request response results in an error becaues the packet is
	       too big.

       Note that snmpdelta REQUIRES  an argument specifying the agent to query and at least one OID argument, as described in the snmpcmd(1)  man-
       ual page.

EXAMPLES

       $ snmpdelta -c public -v 1 -Cs localhost IF-MIB::ifInUcastPkts.3 IF-MIB::ifOutUcastPkts.3
       [20:15:43 6/14] ifInUcastPkts.3 /1 sec: 158
       [20:15:43 6/14] ifOutUcastPkts.3 /1 sec: 158
       [20:15:44 6/14] ifInUcastPkts.3 /1 sec: 184
       [20:15:44 6/14] ifOutUcastPkts.3 /1 sec: 184
       [20:15:45 6/14] ifInUcastPkts.3 /1 sec: 184
       [20:15:45 6/14] ifOutUcastPkts.3 /1 sec: 184
       [20:15:46 6/14] ifInUcastPkts.3 /1 sec: 158
       [20:15:46 6/14] ifOutUcastPkts.3 /1 sec: 158
       [20:15:47 6/14] ifInUcastPkts.3 /1 sec: 184
       [20:15:47 6/14] ifOutUcastPkts.3 /1 sec: 184
       [20:15:48 6/14] ifInUcastPkts.3 /1 sec: 184
       [20:15:48 6/14] ifOutUcastPkts.3 /1 sec: 184
       [20:15:49 6/14] ifInUcastPkts.3 /1 sec: 158
       [20:15:49 6/14] ifOutUcastPkts.3 /1 sec: 158
       ^C
       $ snmpdelta -c public -v 1 -Cs -CT localhost IF-MIB:ifInUcastPkts.3 IF-MIB:ifOutcastPkts.3
       localhost ifInUcastPkts.3     ifOutUcastPkts.3
       [20:15:59 6/14]	   184.00    184.00
       [20:16:00 6/14]	   158.00    158.00
       [20:16:01 6/14]	   184.00    184.00
       [20:16:02 6/14]	   184.00    184.00
       [20:16:03 6/14]	   158.00    158.00
       [20:16:04 6/14]	   184.00    184.00
       [20:16:05 6/14]	   184.00    184.00
       [20:16:06 6/14]	   158.00    158.00
       ^C

       The following example uses a number of options. Since the Cl option is specified, the output is sent to a file and not to the screen.

       $ snmpdelta -c public -v 1 -Ct -Cs -CS -Cm -Cl -Cp 60 -CP 60
	 interlink.sw.net.cmu.edu .1.3.6.1.2.1.2.2.1.16.3 .1.3.6.1.2.1.2.2.1.16.4

SEE ALSO

       snmpcmd(1), variables(5).

V5.6.2.1							    25 Jul 2003 						      SNMPDELTA(1)