Manual Pages for UNIX Darwin command on man snmpdelta

SNMPDELTA(1) Net-SNMP SNMPDELTA(1)

NAME

snmpdelta - Monitor delta differences in SNMP Counter values

SYNOPSIS

ssnnmmppddeellttaa [ common options ] [-Cf] [ -Ct ] [ -Cs ] [ -CS ] [ -Cm ] [

-CF configfile ] [ -Cl ] [ -Cp period ] [ -CP Peaks ] [ -Ck ] [ -CT ]

AGENT OID [ OID ... ]

DESCRIPTION

ssnnmmppddeellttaa will monitor the specified integer valued OIDs, and report changes over time. AGENT identifies a target SNMP agent, which is instrumented to monitor

the gievn objects. At its simplest, the AGENT specification will con-

sist 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 possi-

ble 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 com-

mand. OOPPTTIIOONNSS CCOOMMMMOONN OOPPTTIIOONNSS Please see snmpcmd(1) for a list of possible values for COMMON

OPTIONS as well as their descriptions.

-CCff 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.

-CCtt Flag will determine time interval from the monitored entity.

-CCss Flag will display a timestamp.

-CCSS 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.

-CCmm Prints the max value ever attained.

-CCFF ccoonnffiiggffiillee

Tells ssnnmmppddeellttaa 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.

-CCll Tells ssnnmmppddeellttaa 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 "local-

host-ifInOctets.1".

-CCpp Specifies the number of seconds between polling periods.

Polling constitutes sending a request to the agent. The default polling period is one second.

-CCPP ppeeaakkss

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.

-CCkk 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.

-CCTT Makes ssnnmmppddeellttaa print its output in tabular form.

-CCvv vvaarrss//ppkktt

Specifies the maximum number of oids allowed to be packaged 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 becaues the packet is too big. EEXXAAMMPPLLEESS

$ 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 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