snmpdelta.1.def
上传用户:wxp200602
上传日期:2007-10-30
资源大小:4028k
文件大小:5k
- ." Portions of this file are subject to the following copyright. See
- ." the Net-SNMP's COPYING file for more details and other copyrights
- ." that may apply:
- ." /***********************************************************
- ." Portions of this file are copyrighted by:
- ." Copyright Copyright 2003 Sun Microsystems, Inc. All rights reserved.
- ." Use is subject to license terms specified in the COPYING file
- ." distributed with the Net-SNMP package.
- ." ******************************************************************/
- .TH SNMPDELTA 1 "25 Jul 2003" VVERSIONINFO "Net-SNMP"
- .UC 4
- .SH NAME
- snmpdelta - Monitor delta differences in SNMP Counter values
- .SH SYNOPSIS
- .B snmpdelta
- [ common options ] [-Cf] [ -Ct ] [ -Cs ] [ -CS ] [ -Cm ] [ -CF configfile ] [ -Cl ] [ -Cp period ] [ -CP Peaks ] [ -Ck ] [ -CT ] AGENT OID [ OID ... ]
- .SH "DESCRIPTION"
- .B snmpdelta
- will monitor the specified integer valued OIDs, and report changes
- over time.
- .PP
- 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 formats for AGENT.
- .PP
- OID is an object identifier which uniquely
- identifies the object type within a MIB. Multiple
- OIDs can be specified on a single snmpdelta command.
- .PP
- .SH OPTIONS
- .TP 8
- .B COMMON OPTIONS
- Please see
- .I snmpcmd(1)
- for a list of possible values for COMMON OPTIONS
- as well as their descriptions.
- .TP
- .B -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
- .I snmpdelta
- not to retry a request, even
- if there are multiple oids specified.
- .TP
- .B -Ct
- Flag will determine time interval from the monitored entity.
- .TP
- .B -Cs
- Flag will display a timestamp.
- .TP
- .B -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.
- .TP
- .B -Cm
- Prints the max value ever attained.
- .TP
- .B -CF configfile
- Tells
- .B 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.
- .TP
- .B -Cl
- Tells
- .B 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".
- .TP
- .B -Cp
- Specifies the number of seconds between polling periods.
- Polling constitutes sending a request to the agent. The
- default polling period is one second.
- .TP
- .B -CP peaks
- Specifies the reporting period in number of polling periods.
- If this option is specified, snmpdelta polls the agent
- .I 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.
- .TP
- .B -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.
- .TP
- .B -CT
- Makes
- .B snmpdelta
- print its output in tabular form.
- .TP
- .B -Cv vars/pkt
- 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.
- .SH EXAMPLES
- .nf
- $ 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
- .fi
- .PP
- The following example uses a number of options. Since the
- .I Cl
- option is specified, the output is sent to a file and not to the
- screen.
- .PP
- .nf
- $ 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
- .SH "SEE ALSO"
- snmpcmd(1), variables(5).