snmpdelta.1.def
上传用户:wxp200602
上传日期:2007-10-30
资源大小:4028k
文件大小:5k
源码类别:

SNMP编程

开发平台:

Unix_Linux

  1. ." Portions of this file are subject to the following copyright.  See
  2. ." the Net-SNMP's COPYING file for more details and other copyrights
  3. ." that may apply:
  4. ." /***********************************************************
  5. ." Portions of this file are copyrighted by:
  6. ." Copyright Copyright 2003 Sun Microsystems, Inc. All rights reserved.
  7. ." Use is subject to license terms specified in the COPYING file
  8. ." distributed with the Net-SNMP package.
  9. ." ******************************************************************/
  10. .TH SNMPDELTA 1 "25 Jul 2003" VVERSIONINFO "Net-SNMP"
  11. .UC 4
  12. .SH NAME
  13. snmpdelta - Monitor delta differences in SNMP Counter values
  14. .SH SYNOPSIS
  15. .B snmpdelta
  16. [ common options ] [-Cf] [ -Ct ] [ -Cs ] [ -CS ] [ -Cm ] [ -CF configfile ] [ -Cl ] [ -Cp period ] [ -CP Peaks ] [ -Ck ] [ -CT ] AGENT OID [ OID ... ]
  17. .SH "DESCRIPTION"
  18. .B snmpdelta
  19. will monitor the specified integer valued OIDs, and report changes
  20. over time.
  21. .PP
  22. AGENT identifies a target SNMP agent, which is instrumented
  23. to monitor the given objects.  At its simplest, the AGENT
  24. specification will consist of a hostname or an IPv4
  25. address.  In this situation, the command will attempt
  26. communication with the agent, using UDP/IPv4 to port 161
  27. of the given target host. See snmpcmd(1) for a full list of
  28. the possible formats for AGENT.
  29. .PP
  30. OID is an object identifier which uniquely
  31. identifies the object type within a MIB. Multiple
  32. OIDs can be specified on a single snmpdelta command.
  33. .PP
  34. .SH OPTIONS
  35. .TP 8
  36. .B COMMON OPTIONS
  37. Please see
  38. .I snmpcmd(1)
  39. for a list of possible values for COMMON OPTIONS
  40. as well as their descriptions.
  41. .TP
  42. .B -Cf
  43. Don't fix errors and retry the request.
  44. Without this option, if multiple oids have been specified for
  45. a single request and if the request for one or more of the
  46. oids fails, snmpdelta will retry the request so that data for
  47. oids apart from the ones that failed will still be returned. 
  48. Specifying -Cf tells
  49. .I  snmpdelta
  50. not to retry a request, even
  51. if there are multiple oids specified.
  52. .TP
  53. .B -Ct
  54. Flag will determine time interval from the monitored entity.
  55. .TP
  56. .B -Cs
  57. Flag will display a timestamp.
  58. .TP
  59. .B -CS
  60. Generates a "sum count" in addition to the individual instance
  61. counts.  The "sum count" is the total of all the individual
  62. deltas for each time period.
  63. .TP
  64. .B -Cm
  65. Prints the max value ever attained.
  66. .TP
  67. .B -CF configfile
  68. Tells
  69. .B snmpdelta
  70. to read it's configuration from the specified file.
  71. This options allows the input to be set up in advance rather
  72. than having to be specified on the command line.
  73. .TP
  74. .B -Cl
  75. Tells
  76. .B snmpdelta
  77. to write it's configuration to files whose names correspond to the MIB
  78. instances monitored.  For example, snmpdelta -Cl localhost ifInOctets.1
  79. will create a file "localhost-ifInOctets.1".
  80. .TP
  81. .B -Cp
  82. Specifies the number of seconds between polling periods.
  83. Polling constitutes sending a request to the agent. The
  84. default polling period is one second.
  85. .TP
  86. .B -CP peaks
  87. Specifies the reporting period in number of polling periods.
  88. If this option is specified, snmpdelta polls the agent
  89. .I peaks
  90. number of times before reporting the results.
  91. The result reported includes the average value over
  92. the reporting period. In addition, the highest polled
  93. value within the reporting period is shown.
  94. .TP
  95. .B -Ck
  96. When the polling period (-Cp) is an increment of 60 seconds
  97. and the timestamp is displayed in the output (-Cs), then
  98. the default display shows the timestamp in the format
  99. hh:mm mm/dd. This option causes the timestamp format
  100. to be hh:mm:ss mm/dd.
  101. .TP
  102. .B -CT
  103. Makes 
  104. .B snmpdelta
  105. print its output in tabular form.
  106. .TP
  107. .B -Cv vars/pkt
  108. Specifies the maximum number of oids allowed to be packaged
  109. in a single PDU. Multiple PDUs can be created in a single
  110. request. The default value of variables per packet is 60.
  111. This option is useful if a request response results in an
  112. error becaues the packet is too big.
  113. .SH EXAMPLES
  114. .nf
  115. $ snmpdelta -c public -v 1 -Cs localhost IF-MIB::ifInUcastPkts.3 IF-MIB::ifOutUcastPkts.3
  116. [20:15:43 6/14] ifInUcastPkts.3 /1 sec: 158
  117. [20:15:43 6/14] ifOutUcastPkts.3 /1 sec: 158
  118. [20:15:44 6/14] ifInUcastPkts.3 /1 sec: 184
  119. [20:15:44 6/14] ifOutUcastPkts.3 /1 sec: 184
  120. [20:15:45 6/14] ifInUcastPkts.3 /1 sec: 184
  121. [20:15:45 6/14] ifOutUcastPkts.3 /1 sec: 184
  122. [20:15:46 6/14] ifInUcastPkts.3 /1 sec: 158
  123. [20:15:46 6/14] ifOutUcastPkts.3 /1 sec: 158
  124. [20:15:47 6/14] ifInUcastPkts.3 /1 sec: 184
  125. [20:15:47 6/14] ifOutUcastPkts.3 /1 sec: 184
  126. [20:15:48 6/14] ifInUcastPkts.3 /1 sec: 184
  127. [20:15:48 6/14] ifOutUcastPkts.3 /1 sec: 184
  128. [20:15:49 6/14] ifInUcastPkts.3 /1 sec: 158
  129. [20:15:49 6/14] ifOutUcastPkts.3 /1 sec: 158
  130. ^C
  131. $ snmpdelta -c public -v 1 -Cs -CT localhost IF-MIB:ifInUcastPkts.3 IF-MIB:ifOutcastPkts.3
  132. localhost ifInUcastPkts.3 ifOutUcastPkts.3
  133. [20:15:59 6/14] 184.00 184.00
  134. [20:16:00 6/14] 158.00 158.00
  135. [20:16:01 6/14] 184.00 184.00
  136. [20:16:02 6/14] 184.00 184.00
  137. [20:16:03 6/14] 158.00 158.00
  138. [20:16:04 6/14] 184.00 184.00
  139. [20:16:05 6/14] 184.00 184.00
  140. [20:16:06 6/14] 158.00 158.00
  141. ^C
  142. .fi
  143. .PP
  144. The following example uses a number of options. Since the 
  145. .I Cl 
  146. option is specified, the output is sent to a file and not to the
  147. screen.
  148. .PP
  149. .nf
  150. $ snmpdelta -c public -v 1 -Ct -Cs -CS -Cm -Cl -Cp 60 -CP 60
  151.   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
  152. fi
  153. .SH "SEE ALSO"
  154. snmpcmd(1), variables(5).