phpman > man > snmpdelta(1)

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 al‐
               lows the input to be set up in advance rather than having to be specified on the com‐
               mand 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 cre‐
               ate 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 spec‐
               ified, snmpdelta polls the agent peaks number of times before reporting the  results.
               The  result  reported  includes the average value over the reporting period. In addi‐
               tion, 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 dis‐
               played  in the output (-Cs), then the default display shows the timestamp in the for‐
               mat 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).



V5.9.1                                       25 Jul 2003                                SNMPDELTA(1)