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 con-
       sist 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	possi-
       ble 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 com-
       mand.

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 "local-
	       host-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.

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
       fi

SEE ALSO
       snmpcmd(1), variables(5).



4th Berkeley Distribution	  25 Jul 2003			  SNMPDELTA(1)