← Back to branch summary

~ubuntu-branches/ubuntu/precise/nagios-snmp-plugins/precise

« back to all changes in this revision

Viewing changes to doc/snmp_load.html

  • Committer: Bazaar Package Importer
  • Author(s): Jan Wagner
  • Date: 2007-04-25 22:00:50 UTC
  • Revision ID: james.westby@ubuntu.com-20070425220050-tesozvdx9rwgo0j4
Tags: upstream-1.1.1
Import upstream version 1.1.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/snmp_load.html
 
1
<HTML>
 
2
 
 
3
<HEAD>
 
4
 
 
5
<TITLE>Nagios plugins</TITLE>
 
6
 
 
7
<META NAME="Keywords" CONTENT="nagios,plugins,perl,snmp,proy">
 
8
 
 
9
<STYLE type="text/css">
 
10
 
 
11
<!--
 
12
 
 
13
        .Default { font-family: verdana,arial,serif; font-size: 10pt; }
 
14
 
 
15
        .ProgramTitle { font-family: verdana,arial,serif; font-size: 18pt; font-weight: bold;}
 
16
 
 
17
        .Copyright { font-family: verdana,arial,serif; font-size: 10pt;}
 
18
 
 
19
        .Email { font-family: verdana,arial,serif; font-size: 10pt;}
 
20
 
 
21
        .NewsItem { font-family: verdana,arial,serif; font-size: 8pt; }
 
22
 
 
23
        .NewsItemOdd { font-family: verdana,arial,serif; font-size: 8pt; background-color: #DBDBDB;}
 
24
 
 
25
        .NewsItemEven { font-family: verdana,arial,serif; font-size: 8pt; background-color: #C4C2C2;}
 
26
 
 
27
        .NewsItemUrgent { font-family: verdana,arial,serif; font-size: 8pt; background-color: #ccff99;}
 
28
 
 
29
        .NewsItemDate { font-family: verdana,arial,serif; font-size: 8pt; font-weight: bold; }
 
30
 
 
31
        .SectionTitle { font-family: verdana,arial,serif; font-size: 9pt; font-weight: bold; text-decoration: underline;}
 
32
 
 
33
        .SectionBody { font-family: verdana,arial,serif; font-size: 8pt; }
 
34
 
 
35
        .ModificationDate { font-family: verdana,arial,serif; font-size: 7pt; }
 
36
 
 
37
        .Disclaimer { font-family: verdana,arial,serif; font-size: 8pt; }
 
38
 
 
39
                A.SideNavBarItem { font-family: verdana,arial,serif; background-color : black; color: #e7e7e7; font-size: 9pt; font-weight: bold; text-decoration: none; }
 
40
 
 
41
                A.SideNavBarItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
 
42
 
 
43
                A.SideNavBarHotItem { font-family: verdana,arial,serif; background-color : black; color: #ffcc66; font-size: 9pt; font-weight: bold; text-decoration: none; }
 
44
 
 
45
                A.SideNavBarHotItem:Hover { font-family: verdana,arial,serif; background-color : black; color: #ccff33; font-size: 9pt; font-weight: bold; text-decoration: none; }
 
46
 
 
47
-->      
 
48
 
 
49
</STYLE>
 
50
 
 
51
</HEAD>
 
52
 
 
53
<body  background="img/sideback.jpg" bgcolor="#FFFFFF" text="black" class="Default">
 
54
 
 
55
<table border="0">
 
56
 
 
57
  <tr> 
 
58
 
 
59
    <td valign=top> 
 
60
 
 
61
      <!-- Begin Side Bar -->
 
62
 
 
63
      <table border="0" width="125" valign=top>
 
64
 
 
65
        <tr> 
 
66
 
 
67
          <td><a href="http://nagios.manubulon.com/" class="SideNavBarItem" >Home</a></td>
 
68
 
 
69
        </tr>
 
70
 
 
71
        <tr> 
 
72
 
 
73
          <td></td>
 
74
 
 
75
        </tr>
 
76
 
 
77
        <tr> 
 
78
 
 
79
          <td><BR>
 
80
 
 
81
          </td>
 
82
 
 
83
        </tr>
 
84
 
 
85
        <tr> 
 
86
 
 
87
          <td> </td>
 
88
 
 
89
        </tr>
 
90
 
 
91
      </table>
 
92
 
 
93
      <!-- End Side Bar -->
 
94
 
 
95
    </td>
 
96
 
 
97
    <td valign=top> 
 
98
 
 
99
      <table border="0" valign=top>
 
100
 
 
101
        <tr> 
 
102
 
 
103
          <td class="ProgramTitle"> Snmp load check</td>
 
104
 
 
105
        </tr>
 
106
 
 
107
        <tr> 
 
108
 
 
109
          <td> 
 
110
 
 
111
            <p class="NewsItemDate">Script : check_snmp_load.pl</p>
 
112
 
 
113
            <p class="SectionTitle"> Last update : Sept 5 2006</p>
 
114
 
 
115
          </td>
 
116
 
 
117
        </tr>
 
118
 
 
119
        <tr> 
 
120
 
 
121
          <td valign="top"> 
 
122
 
 
123
            <p class="SectionTitle">Description : </p>
 
124
 
 
125
            <p class="SectionBody">Checks by snmp v1, v2c or v3 cpu or average 
 
126
 
 
127
              load. <br>
 
128
 
 
129
              Works on Windows, Linux/Unix, AS400, Cisco, Cisco catalyst,  HP Procurve, LinkProof, 
 
130
 
 
131
              Blucoat, Nokia, Fortinet, Netscreen.</p>
 
132
 
 
133
            <p class="SectionBody">Check types are selected by the -T option : 
 
134
 
 
135
            </p>
 
136
 
 
137
            <table border="1">
 
138
              <tr> 
 
139
                <td class="SectionTitle"> 
 
140
                  <div align="center">-T value</div>
 
141
                </td>
 
142
                <td class="SectionTitle"> 
 
143
                  <div align="center">System </div>
 
144
                </td>
 
145
                <td class="SectionTitle"> 
 
146
                  <div align="center">-w &amp; -c values</div>
 
147
                </td>
 
148
              </tr>
 
149
              <tr> 
 
150
                <td class="SectionBody"><b>netsl</b></td>
 
151
                <td class="SectionBody">Linux : load provided by Net SNMP</td>
 
152
                <td class="SectionBody">3 values : load average on 1 min, 5 min, 
 
153
                  15 min (absolute)</td>
 
154
              </tr>
 
155
              <tr> 
 
156
                <td class="SectionBody"><b>netsc</b></td>
 
157
                <td class="SectionBody">Linux : CPU usage given by net-snmp</td>
 
158
                <td class="SectionBody">1 value in %</td>
 
159
              </tr>
 
160
              <tr> 
 
161
                <td class="SectionBody"><b>as400</b></td>
 
162
                <td class="SectionBody">as400 CPU usage</td>
 
163
                <td class="SectionBody">1 value in %</td>
 
164
              </tr>
 
165
              <tr> 
 
166
                <td class="SectionBody"><b>cisco</b></td>
 
167
                <td class="SectionBody">cisco CPU usage</td>
 
168
                <td class="SectionBody">3 values : CPU average on 5sec, 1 min 
 
169
                  &amp; 5 min (%)</td>
 
170
              </tr>
 
171
              <tr> 
 
172
                <td class="SectionBody"><b>cata</b></td>
 
173
                <td class="SectionBody">cisco catalyst CPU usage</td>
 
174
                <td class="SectionBody">3 values : CPU average on 5sec, 1 min 
 
175
                  &amp; 5 min (%)</td>
 
176
              </tr>
 
177
              <tr> 
 
178
                <td class="SectionBody"><b>nsc</b></td>
 
179
                <td class="SectionBody">Netscreen CPU usage</td>
 
180
                <td class="SectionBody">3 values : CPU average on 5sec, 1 min 
 
181
                  &amp; 5 min (%)</td>
 
182
              </tr>
 
183
              <tr> 
 
184
                <td class="SectionBody"><b>fg</b></td>
 
185
                <td class="SectionBody">Fortigate CPU usage</td>
 
186
                <td class="SectionBody">1 value in %</td>
 
187
              </tr>
 
188
              <tr> 
 
189
                <td class="SectionBody"><b>bc</b></td>
 
190
                <td class="SectionBody">bluecoat CPU usage</td>
 
191
                <td class="SectionBody">1 value in %</td>
 
192
              </tr>
 
193
              <tr> 
 
194
                <td class="SectionBody"><b>nokia</b></td>
 
195
                <td class="SectionBody">nokia CPU usage</td>
 
196
                <td class="SectionBody">1 value in %</td>
 
197
              </tr>
 
198
              <tr> 
 
199
                <td class="SectionBody"><b>hp</b></td>
 
200
                <td class="SectionBody">HP procurve switch CPU usage</td>
 
201
                <td class="SectionBody">1 value in %</td>
 
202
              </tr>
 
203
              <tr> 
 
204
                <td class="SectionBody"><b>lp</b></td>
 
205
                <td class="SectionBody">Linkproof CPU usage</td>
 
206
                <td class="SectionBody">1 value in %</td>
 
207
              </tr>
 
208
              <tr>
 
209
                <td class="SectionBody"><b>hpux</b></td>
 
210
                <td class="SectionBody">HP-UX load</td>
 
211
                <td class="SectionBody">3 values : load average on 1 min, 5 min, 
 
212
                  15 min</td>
 
213
              </tr>
 
214
            </table>
 
215
 
 
216
            <p class="SectionBody"> V&eacute;rifie par snmp v1,v2c ou v3 la charge 
 
217
 
 
218
              ou l'ocupation CPU.</p>
 
219
 
 
220
            <p class="SectionBody"><span class="SectionTitle">SNMP Login</span><br>
 
221
 
 
222
            </p>
 
223
 
 
224
            <p class="SectionBody">See <a href="index_info.html">snmp info page</a></p>
 
225
 
 
226
            <p class="SectionTitle">Requirements :</p>
 
227
 
 
228
            <p class="SectionBody"> - Perl in /usr/bin/perl - or just run 'perl 
 
229
 
 
230
              script' <br>
 
231
 
 
232
              - Net::SNMP<br>
 
233
 
 
234
              - file 'utils.pm' in plugin diretory<br>
 
235
 
 
236
            </p>
 
237
 
 
238
            <p class="SectionBody"><a href="check_snmp_load.pl" class="SectionTitle">Dowload 
 
239
              lastest version : 1.3.1</a> </p>
 
240
 
 
241
            <p class="SectionBody"><a href="index_commands.html" class="SectionTitle">Configurations 
 
242
 
 
243
              examples</a></p>
 
244
 
 
245
            <p class="SectionTitle"><span class="SectionTitle">Changelog</span> 
 
246
              : On CVS repository on sourceforge : <a href="http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/">http://nagios-snmp.cvs.sourceforge.net/nagios-snmp/plugins/</a>.</p>
 
247
            <p class="SectionTitle">Examples :</p>
 
248
 
 
249
            <p class="SectionBody"><br>
 
250
 
 
251
              All examples below are considering the script is local directory. 
 
252
 
 
253
              Host to be checked is 127.0.0.1 with snmp community &quot;public&quot;.</p>
 
254
 
 
255
            <p class="SectionBody">If multiple interfaces are selected, all must 
 
256
 
 
257
              be up to get an OK result</p>
 
258
 
 
259
            <table border="1" cellspacing="5">
 
260
              <tr> 
 
261
                <td class="NewsItemDate" valign = top width="282"> 
 
262
                  <p>Get help 
 
263
                </td>
 
264
                <td class="SectionBody"> 
 
265
                  <p>./check_snmp_load.pl <b>-h</b></p>
 
266
                </td>
 
267
              </tr>
 
268
              <tr> 
 
269
                <td class="NewsItemDate" valign = top width="282"> 
 
270
                  <p>Check loads on linux with Net-SNMP : checks the 1, 5 and 
 
271
                    15 minutes load average. 
 
272
                </td>
 
273
                <td class="SectionBody"> 
 
274
                  <p>./check_snmp_load.pl -H 127.0.0.1 -C public <b>-w 3,3,2 -c 
 
275
                    4,4,3 -T netsl</b></p>
 
276
                </td>
 
277
              </tr>
 
278
              <tr> 
 
279
                <td class="NewsItemDate" valign = top width="282"> 
 
280
                  <p>Check cpu load (generic) : checks the %used CPU for the last 
 
281
                    minute 
 
282
                </td>
 
283
                <td class="SectionBody"> 
 
284
                  <p>./check_snmp_load.pl -H 127.0.0.1 -C public <b>-w 98% -c 
 
285
                    99%</b></p>
 
286
                </td>
 
287
              </tr>
 
288
              <tr> 
 
289
                <td class="NewsItemDate" valign = top width="282"> 
 
290
                  <p>Check cpu load on AS/400 
 
291
                </td>
 
292
                <td class="SectionBody"> 
 
293
                  <p>./check_snmp_load.pl -H 127.0.0.1 -C public <b>-w 98% -c 
 
294
                    99% -T as400</b></p>
 
295
                </td>
 
296
              </tr>
 
297
            </table>
 
298
 
 
299
            <p class="NewsItemDate">Output of check_snmp_load.pl -h</p>
 
300
 
 
301
            <table border="1" cellspacing="5">
 
302
 
 
303
              <tr> 
 
304
 
 
305
                <td class="SectionBody" valign = top> 
 
306
SNMP Load &amp; CPU Monitor for Nagios version 1.3<br>
 
307
                  (c)2004-2006 Patrick Proy 
 
308
                  <p>Usage: ./check_snmp_load.pl [-v] -H &lt;host&gt; -C &lt;snmp_community&gt; 
 
309
                    [-2] | (-l login -x passwd [-X pass -L &lt;authp&gt;,&lt;privp&gt;]) 
 
310
                    [-p &lt;port&gt;] -w &lt;warn level&gt; -c &lt;crit level&gt; 
 
311
                    -T=[stand|netsl|netsc|as400|cisco|cata|nsc|fg|bc|nokia|hp|lp] 
 
312
                    [-f] [-t &lt;timeout&gt;] [-V]<br>
 
313
                    -v, --verbose<br>
 
314
                    print extra debugging information <br>
 
315
                    -h, --help<br>
 
316
                    print this help message<br>
 
317
                    -H, --hostname=HOST<br>
 
318
                    name or IP address of host to check<br>
 
319
                    -C, --community=COMMUNITY NAME<br>
 
320
                    community name for the host's SNMP agent (implies v1 protocol)<br>
 
321
                    -2, --v2c<br>
 
322
                    Use snmp v2c<br>
 
323
                    -l, --login=LOGIN ; -x, --passwd=PASSWD<br>
 
324
                    Login and auth password for snmpv3 authentication <br>
 
325
                    If no priv password exists, implies AuthNoPriv <br>
 
326
                    -X, --privpass=PASSWD<br>
 
327
                    Priv password for snmpv3 (AuthPriv protocol)<br>
 
328
                    -L, --protocols=&lt;authproto&gt;,&lt;privproto&gt;<br>
 
329
                    &lt;authproto&gt; : Authentication protocol (md5|sha : default 
 
330
                    md5)<br>
 
331
                    &lt;privproto&gt; : Priv protocole (des|aes : default des) 
 
332
                    <br>
 
333
                    -P, --port=PORT<br>
 
334
                    SNMP port (Default 161)<br>
 
335
                    -w, --warn=INTEGER | INT,INT,INT<br>
 
336
                    1 value check : warning level for cpu in percent (on one minute)<br>
 
337
                    3 value check : comma separated level for load or cpu for 
 
338
                    1min, 5min, 15min <br>
 
339
                    -c, --crit=INTEGER | INT,INT,INT<br>
 
340
                    critical level for cpu in percent (on one minute)<br>
 
341
                    1 value check : critical level for cpu in percent (on one 
 
342
                    minute)<br>
 
343
                    3 value check : comma separated level for load or cpu for 
 
344
                    1min, 5min, 15min <br>
 
345
                    -T, --type=stand|netsl|netsc|as400|cisco|bc|nokia|hp|lp<br>
 
346
                    CPU check : <br>
 
347
                    stand : standard MIBII (works with Windows), <br>
 
348
                    can handle multiple CPU.<br>
 
349
                    netsl : linux load provided by Net SNMP<br>
 
350
                    netsc : cpu usage given by net-snmp (100-idle)<br>
 
351
                    as400 : as400 CPU usage<br>
 
352
                    cisco : Cisco CPU usage<br>
 
353
                    cata : Cisco catalyst CPU usage<br>
 
354
                    nsc : NetScreen CPU usage<br>
 
355
                    fg : Fortigate CPU usage<br>
 
356
                    bc : Bluecoat CPU usage<br>
 
357
                    nokia : Nokia CPU usage<br>
 
358
                    hp : HP procurve switch CPU usage<br>
 
359
                    lp : Linkproof CPU usage<br>
 
360
                    -f, --perfparse<br>
 
361
                    Perfparse compatible output<br>
 
362
                    -t, --timeout=INTEGER<br>
 
363
                    timeout for SNMP in seconds (Default: 5)<br>
 
364
                    -V, --version<br>
 
365
                    prints version number</p>
 
366
                </td>
 
367
 
 
368
              </tr>
 
369
 
 
370
            </table>
 
371
 
 
372
          </td>
 
373
 
 
374
        </tr>
 
375
 
 
376
        <tr> 
 
377
 
 
378
          <td> 
 
379
 
 
380
            <p class="SectionBody">This project is hosted on : <br>
 
381
 
 
382
              <A href="http://sourceforge.net/projects/nagios-snmp"> <IMG src="http://sourceforge.net/sflogo.php?group_id=134917&type=5" width="210" height="62" border="0" alt="SourceForge.net Logo" /></A> 
 
383
 
 
384
            </p>
 
385
 
 
386
            <p class="SectionBody"> Nagios and the Nagios logo are registered 
 
387
 
 
388
              trademarks of Ethan Galstad.</p>
 
389
 
 
390
          </td>
 
391
 
 
392
        </tr>
 
393
 
 
394
      </table>
 
395
 
 
396
    </td>
 
397
 
 
398
  </tr>
 
399
 
 
400
</table>
 
401
 
 
402
<p>&nbsp;</p>
 
403
 
 
404
</BODY>
 
405
 
 
406
</HTML>
 
407
 
 
408
 
 
409