Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1m‎ > ‎

snmpdelta


NAME
     snmpdelta - monitor deltas of integer valued SNMP variables

SYNOPSIS
     /usr/sfw/bin/snmpdelta [common options]  [-Cf]  [-Ct]  [-Cs]
     [-CS]  [-Cm] [-CF configfile] [-Cl] [-Cp period] [-CP peaks]
     [-Ck] [-CT] [-Cv vars/pkt] agent OID [OID...]

DESCRIPTION
     The snmpdelta command monitors the specified  integer-valued
     OIDs and reports changes over time.

     The operand agent identifies a target SNMP agent,  which  is
     instrumented  to monitor a given set of objects. At its sim-
     plest, the agent specification will consist of a hostname or
     an  IPv4 address. With such an operand, the command attempts
     communication with the agent, using UDP/IPv4 to port 161  of
     the  given  target  host. See snmpcmd(1M) for a full list of
     the possible formats for agent.

     The operand OID is an object identifier that uniquely  iden-
     tifies  the  object  type within a MIB. Multiple OIDs can be
     specified in a single snmpdelta command.

OPTIONS
     See snmpcmd(1M) for a list of common options. In addition to
     the common options, snmpdelta supports the options described
     below.

     -Cf

         Do not fix errors and then 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

         Determines time interval from the monitored entity.



     -Cs

         Displays 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

         Displays the maximum value ever attained.



     -CF configfile

         Tells snmpdelta  to  read  its  configuration  from  the
         specified  file.  This option allows the input to be set
         up in advance rather than having to be specified on  the
         command line.



     -Cl

         Tells snmpdelta to  write  its  configuration  to  files
         whose  names  correspond to the MIB instances monitored.
         For example:


         % snmpdelta -c public -v 1 -Cl localhost ifInOctets.1

         ...will create a file localhost-ifInOctets.1.



     -Cp

         Specifies the number of seconds between polling periods.
         Polling  involves  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 (adding seconds).



     -CT

         Display output in tabular form.



     -Cv vars/pkt

         Specifies the maximum number of OIDs allowed to be pack-
         aged  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 request  packet
         is too big.



EXAMPLES
     Example 1: Obtaining Timestamped Output

     The following command uses the -Cs option to timestamp  out-
     put.  This  example  assumes  that  there are at least three
     entries in your ifTable.

     % 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
     Example 2: Displaying Output in Tabular Form

     The following command uses the -CT option to  format  output
     as  a  table.  This  example assumes that there are at least
     three entries in your ifTable.

     % 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


     Example 3: Sending Output to a File

     The following example uses a number of options. This example
     assumes  that  there  are at least four entries in your ifT-
     able. Because 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


EXIT STATUS
     0        Successful completion.



     1        A usage syntax error. A usage message is displayed.
              Also used for timeout errors and for cases where an
              SNMP client session could not be opened.



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




     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWsmcmd                   |
    |_____________________________|_____________________________|
    | Interface Stability         | External                    |
    |_____________________________|_____________________________|


SEE ALSO
     snmpcmd(1M), snmp_variables(4), attributes(5)










Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments