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 for-
mats for AGENT.
OID is an object identifier which uniquely identifies the object type within a MIB. Multi-
ple OIDs can be specified 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 monitored. 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 pe-
riod. 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. Mul-
tiple 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 be-
cause 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 out-
put 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
SEE ALSO
snmpcmd(1), variables(5).
V5.9.1 25 Jul 2003 SNMPDELTA(1)
Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2025-11-21 17:48 @216.73.216.164 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)