1SNMPDELTA(1) Net-SNMP SNMPDELTA(1)
2
3
4
6 snmpdelta - Monitor delta differences in SNMP Counter values
7
9 snmpdelta [ COMMON OPTIONS ] [-Cf] [ -Ct ] [ -Cs ] [ -CS ] [ -Cm ] [
10 -CF configfile ] [ -Cl ] [ -Cp period ] [ -CP Peaks ] [ -Ck ] [ -CT ]
11 AGENT OID [ OID ... ]
12
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
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 re‐
69 ported includes the average value over the reporting period. In
70 addition, the highest polled value within the reporting period
71 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 de‐
75 fault 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
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
127 snmpcmd(1), variables(5).
128
129
130
131V5.9.1 25 Jul 2003 SNMPDELTA(1)