1SNMPDELTA(1)                       Net-SNMP                       SNMPDELTA(1)
2
3
4

NAME

6       snmpdelta - Monitor delta differences in SNMP Counter values
7

SYNOPSIS

9       snmpdelta  [  COMMON  OPTIONS ] [-Cf] [ -Ct ] [ -Cs ] [ -CS ] [ -Cm ] [
10       -CF configfile ] [ -Cl ] [ -Cp period ] [ -CP Peaks ] [ -Ck ] [  -CT  ]
11       AGENT OID [ OID ... ]
12

DESCRIPTION

14       snmpdelta  will  monitor  the specified integer valued OIDs, and report
15       changes over time.
16
17       AGENT identifies a target SNMP agent, which is instrumented to  monitor
18       the  given objects.  At its simplest, the AGENT specification will con‐
19       sist of a hostname or an IPv4 address.  In this situation, the  command
20       will  attempt  communication with the agent, using UDP/IPv4 to port 161
21       of the given target host. See snmpcmd(1) for a full list of the  possi‐
22       ble formats for AGENT.
23
24       OID  is  an object identifier which uniquely identifies the object type
25       within a MIB. Multiple OIDs can be specified on a single snmpdelta com‐
26       mand.
27

OPTIONS

29       COMMON OPTIONS
30               Please  see snmpcmd(1) for a list of possible values for COMMON
31               OPTIONS as well as their descriptions.
32
33       -Cf     Don't fix errors and retry the request.  Without  this  option,
34               if  multiple  oids have been specified for a single request and
35               if the request for one or more of  the  oids  fails,  snmpdelta
36               will  retry  the  request  so that data for oids apart from the
37               ones that failed will still be returned.  Specifying -Cf  tells
38               snmpdelta  not  to  retry a request, even if there are multiple
39               oids specified.
40
41       -Ct     Flag will determine time interval from the monitored entity.
42
43       -Cs     Flag will display a timestamp.
44
45       -CS     Generates a "sum count" in addition to the individual  instance
46               counts.   The  "sum  count"  is the total of all the individual
47               deltas for each time period.
48
49       -Cm     Prints the max value ever attained.
50
51       -CF configfile
52               Tells snmpdelta to read it's configuration from  the  specified
53               file.   This  options  allows the input to be set up in advance
54               rather than having to be specified on the command line.
55
56       -Cl     Tells snmpdelta to write  it's  configuration  to  files  whose
57               names  correspond to the MIB instances monitored.  For example,
58               snmpdelta -Cl localhost ifInOctets.1 will create a file "local‐
59               host-ifInOctets.1".
60
61       -Cp     Specifies  the  number  of  seconds  between  polling  periods.
62               Polling constitutes sending a request to the agent. The default
63               polling period is one second.
64
65       -CP peaks
66               Specifies  the  reporting  period in number of polling periods.
67               If this option is specified, snmpdelta polls  the  agent  peaks
68               number  of  times  before  reporting  the  results.  The result
69               reported includes the average value over the reporting  period.
70               In  addition,  the  highest  polled  value within the reporting
71               period is shown.
72
73       -Ck     When the polling period (-Cp) is an increment of 60 seconds and
74               the  timestamp  is  displayed  in  the  output  (-Cs), then the
75               default display shows the timestamp in the format hh:mm  mm/dd.
76               This option causes the timestamp format to be hh:mm:ss mm/dd.
77
78       -CT     Makes snmpdelta print its output in tabular form.
79
80       -Cv vars/pkt
81               Specifies  the maximum number of oids allowed to be packaged in
82               a single PDU. Multiple PDUs can be created in a single request.
83               The  default  value of variables per packet is 60.  This option
84               is useful if a request response results in an error because the
85               packet is too big.
86
87       Note that snmpdelta REQUIRES  an argument specifying the agent to query
88       and at least one OID argument, as described in  the  snmpcmd(1)  manual
89       page.
90

EXAMPLES

92       $ snmpdelta -c public -v 1 -Cs localhost IF-MIB::ifInUcastPkts.3 IF-MIB::ifOutUcastPkts.3
93       [20:15:43 6/14] ifInUcastPkts.3 /1 sec: 158
94       [20:15:43 6/14] ifOutUcastPkts.3 /1 sec: 158
95       [20:15:44 6/14] ifInUcastPkts.3 /1 sec: 184
96       [20:15:44 6/14] ifOutUcastPkts.3 /1 sec: 184
97       [20:15:45 6/14] ifInUcastPkts.3 /1 sec: 184
98       [20:15:45 6/14] ifOutUcastPkts.3 /1 sec: 184
99       [20:15:46 6/14] ifInUcastPkts.3 /1 sec: 158
100       [20:15:46 6/14] ifOutUcastPkts.3 /1 sec: 158
101       [20:15:47 6/14] ifInUcastPkts.3 /1 sec: 184
102       [20:15:47 6/14] ifOutUcastPkts.3 /1 sec: 184
103       [20:15:48 6/14] ifInUcastPkts.3 /1 sec: 184
104       [20:15:48 6/14] ifOutUcastPkts.3 /1 sec: 184
105       [20:15:49 6/14] ifInUcastPkts.3 /1 sec: 158
106       [20:15:49 6/14] ifOutUcastPkts.3 /1 sec: 158
107       ^C
108       $ snmpdelta -c public -v 1 -Cs -CT localhost IF-MIB:ifInUcastPkts.3 IF-MIB:ifOutcastPkts.3
109       localhost ifInUcastPkts.3     ifOutUcastPkts.3
110       [20:15:59 6/14]     184.00    184.00
111       [20:16:00 6/14]     158.00    158.00
112       [20:16:01 6/14]     184.00    184.00
113       [20:16:02 6/14]     184.00    184.00
114       [20:16:03 6/14]     158.00    158.00
115       [20:16:04 6/14]     184.00    184.00
116       [20:16:05 6/14]     184.00    184.00
117       [20:16:06 6/14]     158.00    158.00
118       ^C
119
120       The  following example uses a number of options. Since the Cl option is
121       specified, the output is sent to a file and not to the screen.
122
123       $ snmpdelta -c public -v 1 -Ct -Cs -CS -Cm -Cl -Cp 60 -CP 60
124         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
125

SEE ALSO

127       snmpcmd(1), variables(5).
128
129
130
131V5.8                              25 Jul 2003                     SNMPDELTA(1)
Impressum