Provided by: snmp_5.8+dfsg-2ubuntu2.9_amd64 bug

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
               because 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) manual 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).