Manual Pages for UNIX Operating System command usage for man snmpdelta

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 tar-
     get  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  indivi-
             dual  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



V5.4.1              Last change: 25 Jul 2003                    1






Net-SNMP                                             SNMPDELTA(1)



             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 moni-
             tored.  For example, snmpdelta -Cl localhost ifInOc-
             tets.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 report-
             ing  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 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



V5.4.1              Last change: 25 Jul 2003                    2






Net-SNMP                                             SNMPDELTA(1)



     [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).

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     _______________________________________________________
    |   ATTRIBUTE TYPE   |          ATTRIBUTE VALUE        |
    |____________________|__________________________________|_
    | Availability       |  system/management/snmp/net-snmp|
    |____________________|__________________________________|_
    | Interface Stability|  Volatile                       |
    |____________________|_________________________________|

NOTES
     Source for net-snmp is available on http://opensolaris.org.
















V5.4.1              Last change: 25 Jul 2003                    3