Man Pages

snmpdelta(1) - phpMan snmpdelta(1) - phpMan

Command: man perldoc info search(apropos)  


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 speci-
       fied 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 moni-
               tored.  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 out-
               put (-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 cre-
               ated 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)