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
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 tar-
get host. See snmpcmd(1) for a full list of the possible
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 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 individ-
ual 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
V5.4.1 Last change: 25 Jul 2003 1
Net-SNMP SNMPDELTA(1)
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 moni-
tored. 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 report-
ing the results. The result reported includes the
average value over the reporting period. In addi-
tion, 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 cre-
ated in a single request. The default value of vari-
ables per packet is 60. This option is useful if a
request response results in an error becaues the
packet is too big.
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
V5.4.1 Last change: 25 Jul 2003 2
Net-SNMP SNMPDELTA(1)
[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
fi
ATTRIBUTES
See attributes(5) 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://java.net/projects/solaris-userland. The original
community source was downloaded from
http://ftp.ntua.gr/mirror/net-snmp/OldFiles/net-
snmp-5.4.x/5.4.1/net-snmp-5.4.1.tar.gz
Further information about this software can be found on the
open source community website at http://www.net-snmp.org/.
V5.4.1 Last change: 25 Jul 2003 3