3 Copyright (C) 2005 Stanislav Sinyagin
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 2 of the License, or
8 (at your option) any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
19 $Id: docsis-monitors.xml,v 1.1 2010-12-27 00:04:28 ivan Exp $
20 Stanislav Sinyagin <ssinyagin@yahoo.com>
22 Example monitors that may be applied to DOCSIS CMTS monitoring
31 <token-set name="docs-warnings">
32 <param name="comment" value="DOCSIS Warnings" />
35 <token-set name="docs-minor">
36 <param name="comment" value="DOCSIS Minor failures" />
39 <token-set name="docs-major">
40 <param name="comment" value="DOCSIS Major failures" />
47 <!-- **********************************************************
48 Three levels of actions for different severity levels
49 ********************************************************** -->
50 <action name="docs-tset-warnings">
51 <param name="action-type" value="tset" />
52 <param name="tset-name" value="docs-warnings" />
55 <action name="docs-tset-minor">
56 <param name="action-type" value="tset" />
57 <param name="tset-name" value="docs-minor" />
60 <action name="docs-tset-major">
61 <param name="action-type" value="tset" />
62 <param name="tset-name" value="docs-major" />
66 <!-- ==========================================================
67 == RFC2670 monitors ==
68 ========================================================== -->
71 <!-- **********************************************************
73 ********************************************************** -->
74 <monitor name="docsis-snr-1">
75 <param name="monitor-type" value="expression" />
76 <param name="rpn-expr"
77 value="DUP,0,GT,EXC,DUP,24.5,LT,EXC,22,GE,AND,AND" />
78 <param name="action" value="docs-tset-warnings" />
79 <param name="expires" value="1800" />
80 <param name="comment">
81 Signal/Noise-Ratio lower than 30dB
85 <monitor name="docsis-snr-2">
86 <param name="monitor-type" value="expression" />
87 <param name="rpn-expr"
88 value="DUP,0,GT,EXC,DUP,22,LT,EXC,18,GE,AND,AND" />
89 <param name="action" value="docs-tset-minor" />
90 <param name="expires" value="21600" />
91 <param name="comment">
92 Signal/Noise-Ratio lower than 25dB
96 <monitor name="docsis-snr-3">
97 <param name="monitor-type" value="expression" />
98 <param name="rpn-expr" value="DUP,0,GT,EXC,18,LT,AND" />
99 <param name="action" value="docs-tset-major" />
100 <param name="expires" value="21600" />
101 <param name="comment">
102 Signal/Noise-Ratio lower than 18dB
107 <!-- **********************************************************
108 Correctable FEC error rate monitors
109 ********************************************************** -->
110 <monitor name="docsis-feccor-1">
111 <param name="monitor-type" value="expression" />
112 <param name="rpn-expr">
114 {Error-Free},{Uncorrectable},+,+,
118 <param name="action" value="docs-tset-warnings" />
119 <param name="expires" value="1800" />
120 <param name="comment">
121 FEC correctable error rate more than 10%
125 <monitor name="docsis-feccor-2">
126 <param name="monitor-type" value="expression" />
127 <param name="rpn-expr">
129 {Error-Free},{Uncorrectable},+,+,
133 <param name="action" value="docs-tset-minor" />
134 <param name="expires" value="21600" />
135 <param name="comment">
136 FEC correctable error rate more than 20%
141 <!-- **********************************************************
142 Uncorrectable FEC error rate monitors
143 ********************************************************** -->
144 <monitor name="docsis-fecuncor-1">
145 <param name="monitor-type" value="expression" />
146 <param name="rpn-expr">
148 {Error-Free},{Correctable},+,+,
152 <param name="action" value="docs-tset-warnings" />
153 <param name="expires" value="1800" />
154 <param name="comment">
155 FEC uncorrectable error rate more than 0.5%
159 <monitor name="docsis-fecuncor-2">
160 <param name="monitor-type" value="expression" />
161 <param name="rpn-expr">
163 {Error-Free},{Correctable},+,+,
167 <param name="action" value="docs-tset-minor" />
168 <param name="expires" value="21600" />
169 <param name="comment">
170 FEC uncorrectable error rate more than 1%
174 <monitor name="docsis-fecuncor-3">
175 <param name="monitor-type" value="expression" />
176 <param name="rpn-expr">
178 {Error-Free},{Correctable},+,+,
182 <param name="action" value="docs-tset-major" />
183 <param name="expires" value="21600" />
184 <param name="comment">
185 FEC uncorrectable error rate more than 2%
190 <!-- **********************************************************
191 Downstream utilization monitors
192 ********************************************************** -->
193 <monitor name="docsis-downutl-1">
194 <param name="monitor-type" value="expression" />
195 <param name="rpn-expr">
196 {TotalBytes},/,100,*,
200 <param name="action" value="docs-tset-warnings" />
201 <param name="expires" value="1800" />
202 <param name="comment">
203 DOCSIS downstream utilization more than 75%
207 <monitor name="docsis-downutl-2">
208 <param name="monitor-type" value="expression" />
209 <param name="rpn-expr">
210 {TotalBytes},/,100,*,
214 <param name="action" value="docs-tset-minor" />
215 <param name="expires" value="21600" />
216 <param name="comment">
217 DOCSIS downstream utilization more than 80%
221 <monitor name="docsis-downutl-3">
222 <param name="monitor-type" value="expression" />
223 <param name="rpn-expr">
224 {TotalBytes},/,100,*,
227 <param name="action" value="docs-tset-minor" />
228 <param name="expires" value="21600" />
229 <param name="comment">
230 DOCSIS downstream utilization more than 85%
236 <!-- ==========================================================
237 == Cisco-specific monitors ==
238 ========================================================== -->
239 <!-- **********************************************************
240 Upstream utilization monitors
241 ********************************************************** -->
243 <monitor name="docsis-uputil-1">
244 <param name="monitor-type" value="expression" />
245 <param name="rpn-expr">
249 <param name="action" value="docs-tset-warnings" />
250 <param name="expires" value="1800" />
251 <param name="comment">
252 DOCSIS upstream utilization more than 75%
256 <monitor name="docsis-uputil-2">
257 <param name="monitor-type" value="expression" />
258 <param name="rpn-expr">
262 <param name="action" value="docs-tset-minor" />
263 <param name="expires" value="21600" />
264 <param name="comment">
265 DOCSIS upstream utilization more than 80%
269 <monitor name="docsis-uputil-3">
270 <param name="monitor-type" value="expression" />
271 <param name="rpn-expr">
274 <param name="action" value="docs-tset-major" />
275 <param name="expires" value="21600" />
276 <param name="comment">
277 DOCSIS upstream utilization more than 85%
282 <!-- **********************************************************
283 Upstream free contention slots monitors
284 ********************************************************** -->
286 <monitor name="docsis-upslots-1">
287 <param name="monitor-type" value="expression" />
288 <param name="rpn-expr">
292 <param name="action" value="docs-tset-warnings" />
293 <param name="expires" value="1800" />
294 <param name="comment">
295 free DOCSIS upstream minislots less than 17%
299 <monitor name="docsis-upslots-2">
300 <param name="monitor-type" value="expression" />
301 <param name="rpn-expr">
305 <param name="action" value="docs-tset-minor" />
306 <param name="expires" value="21600" />
307 <param name="comment">
308 free DOCSIS upstream minislots less than 12%
312 <monitor name="docsis-upslots-3">
313 <param name="monitor-type" value="expression" />
314 <param name="rpn-expr">
317 <param name="action" value="docs-tset-major" />
318 <param name="expires" value="21600" />
319 <param name="comment">
320 free DOCSIS upstream minislots less than 7%
324 <!-- **********************************************************
325 Modems online monitors
326 ********************************************************** -->
328 <!-- If Modems_Total < 100, then
329 Active < 10% ===> warning
330 If Modems_Total >= 100, then
331 Active < 50% ===> minor
332 Active < 10% ===> major -->
334 <monitor name="docsis-modems-1">
335 <param name="monitor-type" value="expression" />
336 <param name="rpn-expr">
337 {Modems_Total},/,100,*,10,LT,
338 {Modems_Total},100,LT,AND
340 <param name="action" value="docs-tset-warnings" />
341 <param name="expires" value="1800" />
342 <param name="comment">
343 Less than 10% of DOCSIS modems online on a low-loaded interface
347 <monitor name="docsis-modems-2">
348 <param name="monitor-type" value="expression" />
349 <param name="rpn-expr">
350 {Modems_Total},/,100,*,
353 {Modems_Total},100,GE,AND
355 <param name="action" value="docs-tset-minor" />
356 <param name="expires" value="21600" />
357 <param name="comment">
358 Less than 50% of DOCSIS modems online
362 <monitor name="docsis-modems-3">
363 <param name="monitor-type" value="expression" />
364 <param name="rpn-expr">
365 {Modems_Total},/,100,*,10,LT,
366 {Modems_Total},100,GE,AND
368 <param name="action" value="docs-tset-major" />
369 <param name="expires" value="21600" />
370 <param name="comment">
371 Less than 10% of DOCSIS modems online
375 <!-- ==========================================================
376 == IF-MIB monitors for cable interfaces ==
377 ========================================================== -->
379 <monitor name="docs-inerrors-1">
380 <param name="monitor-type" value="expression" />
381 <param name="rpn-expr">
382 {Packets_In},/,100,*,DUP,
385 <param name="action" value="docs-tset-warnings" />
386 <param name="expires" value="21600" />
387 <param name="comment">
388 Input packet errors more than 10%
392 <monitor name="docs-inerrors-2">
393 <param name="monitor-type" value="expression" />
394 <param name="rpn-expr">
395 {Packets_In},/,100,*,DUP,
398 <param name="action" value="docs-tset-minor" />
399 <param name="expires" value="21600" />
400 <param name="comment">
401 Input packet errors more than 50%
405 <monitor name="docs-outerrors-1">
406 <param name="monitor-type" value="expression" />
407 <param name="rpn-expr">
408 {Packets_Out},/,100,*,DUP,
411 <param name="action" value="docs-tset-warnings" />
412 <param name="expires" value="21600" />
413 <param name="comment">
414 Output packet errors more than 10%
418 <monitor name="docs-outerrors-2">
419 <param name="monitor-type" value="expression" />
420 <param name="rpn-expr">
421 {Packets_Out},/,100,*,DUP,
424 <param name="action" value="docs-tset-minor" />
425 <param name="expires" value="21600" />
426 <param name="comment">
427 Output packet errors more than 50%