Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

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(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 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


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-----------------------------------------------+
       |ATTRIBUTE TYPE |               ATTRIBUTE VALUE                 |
       +---------------+-----------------------------------------------+
       |Availability   | system/management/snmp/net-snmp/documentation |
       +---------------+-----------------------------------------------+
       |Stability      | Volatile                                      |
       +---------------+-----------------------------------------------+
SEE ALSO
       snmpcmd(1), variables(5).



NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source  was  downloaded  from   http://ftp.ntua.gr/mirror/net-snmp/net-
       snmp/5.7.3/net-snmp-5.7.3.tar.gz

       Further information about this software can be found on the open source
       community website at http://www.net-snmp.org/.



V5.7.3                            25 Jul 2003                     SNMPDELTA(1)