3 Copyright (C) 2003 Roman Hochuli, 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: rfc2670.docsis-if.old.1.0.4.xml,v 1.1 2010-12-27 00:04:27 ivan Exp $
20 Roman Hochuli <roman@hochu.li>
21 Stanislav Sinyagin <ssinyagin@yahoo.com>
23 SEE ALSO: xmlconfig/examples/docsis-monitors.xml
30 <!-- DOCS-IF-MIB::docsIfSignalQualityTable -->
31 <def name="docsIfSigQUnerroreds" value="1.3.6.1.2.1.10.127.1.1.4.1.2"/>
32 <def name="docsIfSigQCorrecteds" value="1.3.6.1.2.1.10.127.1.1.4.1.3"/>
33 <def name="docsIfSigQUncorrectables" value="1.3.6.1.2.1.10.127.1.1.4.1.4"/>
34 <def name="docsIfSigQSignalNoise" value="1.3.6.1.2.1.10.127.1.1.4.1.5"/>
36 <!-- DOCS-IF-MIB::docsIfCmtsDownChannelCounterTable -->
37 <def name="docsIfCmtsDownChnlCtrExtTotalBytes"
38 value="1.3.6.1.2.1.10.127.1.3.10.1.4"/>
39 <def name="docsIfCmtsDownChnlCtrExtUsedBytes"
40 value="1.3.6.1.2.1.10.127.1.3.10.1.5"/>
45 <template name="docsis-upstream-subtree">
46 <param name="precedence" value="-500" />
47 <param name="comment" value="DOCSIS upstream channel statistics" />
48 <param name="data-file">
49 %system-id%_%interface-nick%_docsis_upstream.rrd
51 <param name="collector-timeoffset-hashstring"
52 value="%system-id%:%interface-nick%" />
53 <param name="descriptive-nickname" value="%system-id%:%interface-name%"/>
54 <param name="graph-title" value="%descriptive-nickname%" />
56 <param name="has-overview-shortcuts" value="yes"/>
57 <param name="overview-shortcuts" value="snr,fec"/>
59 <param name="overview-subleave-name-snr" value="SNR"/>
60 <param name="overview-direct-link-snr" value="yes"/>
61 <param name="overview-direct-link-view-snr" value="expanded-dir-html"/>
62 <param name="overview-shortcut-text-snr"
64 <param name="overview-shortcut-title-snr"
65 value="Show signal quality graphs for all upstreams in one page"/>
66 <param name="overview-page-title-snr"
69 <param name="overview-subleave-name-fec" value="FEC_Summary"/>
70 <param name="overview-direct-link-fec" value="yes"/>
71 <param name="overview-direct-link-view-fec" value="expanded-dir-html"/>
72 <param name="overview-shortcut-text-fec"
74 <param name="overview-shortcut-title-fec"
75 value="Show FEC statistics for all upstreams in one page"/>
76 <param name="overview-page-title-fec"
79 <param name="rrd-hwpredict" value="disabled" />
82 <template name="docsis-signal-quality-codewords">
83 <param name="rrd-create-dstype" value="COUNTER" />
84 <param name="vertical-label" value="Codewords/s" />
85 <param name="graph-lower-limit" value="0" />
88 <template name="docsis-upstream-signal-quality">
90 <param name="snmp-object" value="$docsIfSigQSignalNoise.%ifindex-map%"/>
92 <param name="rrd-create-dstype" value="GAUGE" />
93 <param name="rrd-ds" value="SNR" />
94 <param name="collector-scale" value="10,/" />
96 <param name="comment" value="Signal/Noise Ratio" />
97 <param name="graph-legend" value="Signal/Noise Ratio" />
98 <param name="vertical-label" value="dB" />
100 <param name="normal-level" value="25" />
101 <param name="lower-limit" value="18" />
102 <param name="graph-lower-limit" value="10" />
103 <param name="graph-upper-limit" value="30" />
105 <param name="precedence" value="1000" />
107 <!-- This monitor may be redefined by
108 DocsisUpSNRMonitor selector action -->
109 <param name="monitor" value="docsis-snr-lower-20db" />
112 <leaf name="FEC_Summary">
113 <param name="ds-type" value="rrd-multigraph" />
114 <param name="ds-names" value="corr,uncorr" />
116 <param name="graph-lower-limit" value="0.01" />
117 <param name="graph-upper-limit" value="100" />
118 <param name="graph-logarithmic" value="yes" />
119 <param name="graph-rigid-boundaries" value="yes" />
121 <param name="precedence" value="950" />
122 <param name="comment"
123 value="Reed-Solomon forward error correction (FEC) summary" />
124 <param name="vertical-label" value="Percent" />
126 <param name="ds-expr-corr">
127 {Correctable},{Error-Free},{Correctable},{Uncorrectable},+,+,/,100,*
129 <param name="graph-legend-corr" value="Correctable Codewords" />
130 <param name="line-style-corr" value="##SingleGraph" />
131 <param name="line-color-corr" value="##green" />
132 <param name="line-order-corr" value="1" />
134 <param name="ds-expr-uncorr">
135 {Uncorrectable},{Error-Free},{Correctable},{Uncorrectable},+,+,/,100,*
137 <param name="graph-legend-uncorr" value="Uncorrectable Codewords" />
138 <param name="line-style-uncorr" value="##SingleGraph" />
139 <param name="line-color-uncorr" value="##red" />
140 <param name="line-order-uncorr" value="2" />
143 <leaf name="Error-Free">
144 <apply-template name="docsis-signal-quality-codewords"/>
145 <param name="snmp-object" value="$docsIfSigQUnerroreds.%ifindex-map%"/>
146 <param name="rrd-ds" value="Unerroreds" />
147 <param name="hidden" value="yes"/>
148 <param name="comment"
149 value="FEC codewords received on this channel without error"/>
150 <param name="graph-legend" value="Error-free Codewords" />
151 <param name="precedence" value="900" />
152 <param name="graph-lower-limit" value="0.01" />
153 <param name="graph-upper-limit" value="100" />
154 <param name="graph-logarithmic" value="yes" />
155 <param name="graph-rigid-boundaries" value="yes" />
158 <leaf name="Correctable">
159 <apply-template name="docsis-signal-quality-codewords"/>
160 <param name="snmp-object" value="$docsIfSigQCorrecteds.%ifindex-map%"/>
161 <param name="rrd-ds" value="Correcteds" />
162 <param name="hidden" value="yes"/>
163 <param name="comment"
164 value="FEC codewords received on this channel correctable errors"/>
165 <param name="graph-legend" value="Correctable Codewords" />
166 <param name="precedence" value="800" />
167 <param name="monitor-action-target" value="FEC_Summary"/>
168 <param name="graph-lower-limit" value="0.01" />
169 <param name="graph-upper-limit" value="100" />
170 <param name="graph-logarithmic" value="yes" />
171 <param name="graph-rigid-boundaries" value="yes" />
174 <leaf name="Uncorrectable">
175 <apply-template name="docsis-signal-quality-codewords"/>
176 <param name="snmp-object"
177 value="$docsIfSigQUncorrectables.%ifindex-map%"/>
178 <param name="rrd-ds" value="Uncorrectables" />
179 <param name="hidden" value="yes"/>
180 <param name="comment"
181 value="FEC codewords received on this channel uncorrectable errors"/>
182 <param name="graph-legend" value="Uncorrectable Codewords" />
183 <param name="precedence" value="700" />
184 <param name="monitor-action-target" value="FEC_Summary"/>
185 <param name="graph-lower-limit" value="0.01" />
186 <param name="graph-upper-limit" value="100" />
187 <param name="graph-logarithmic" value="yes" />
188 <param name="graph-rigid-boundaries" value="yes" />
194 <template name="docsis-downstream-subtree">
195 <param name="precedence" value="-500" />
196 <param name="comment" value="DOCSIS downstream statistics" />
197 <param name="data-file">
198 %system-id%_%interface-nick%_docsis_downstream.rrd
200 <param name="collector-timeoffset-hashstring"
201 value="%system-id%:%interface-nick%" />
202 <param name="descriptive-nickname" value="%system-id%:%interface-name%"/>
203 <param name="graph-title" value="%descriptive-nickname%" />
205 <param name="has-overview-shortcuts" value="yes"/>
206 <param name="overview-shortcuts" value="util"/>
207 <param name="overview-subleave-name-util" value="Utilization"/>
208 <param name="overview-direct-link-util" value="yes"/>
209 <param name="overview-direct-link-view-util" value="expanded-dir-html"/>
210 <param name="overview-shortcut-text-util"
211 value="All Utilization"/>
212 <param name="overview-shortcut-title-util"
213 value="Show utilization graphs for all downstreams in one page"/>
214 <param name="overview-page-title-util"
215 value="Downstream Utilization Graphs"/>
216 <param name="rrd-hwpredict" value="disabled" />
220 <template name="docsis-downstream-util">
221 <leaf name="Utilization">
222 <param name="ds-type" value="rrd-multigraph" />
223 <param name="ds-names" value="util" />
224 <param name="graph-lower-limit" value="0" />
225 <param name="graph-upper-limit" value="100" />
227 <param name="precedence" value="950" />
228 <param name="comment"
229 value="Downstream channel utilization" />
230 <param name="vertical-label" value="Percent" />
232 <param name="ds-expr-util">
233 {UsedBytes},{TotalBytes},/,100,*
235 <param name="graph-legend-util" value="Utilization" />
236 <param name="line-style-util" value="##resourceusage" />
237 <param name="line-color-util" value="##resourceusage" />
238 <param name="line-order-util" value="1" />
241 <leaf name="TotalBytes">
242 <param name="rrd-create-dstype" value="COUNTER" />
243 <param name="snmp-object-type" value="COUNTER64" />
244 <param name="vertical-label" value="Bytes/s" />
245 <param name="graph-lower-limit" value="0" />
246 <param name="snmp-object"
247 value="$docsIfCmtsDownChnlCtrExtTotalBytes.%ifindex-map%"/>
248 <param name="rrd-ds" value="TotalBytes" />
249 <param name="hidden" value="yes"/>
250 <param name="comment">
251 The total number of bytes in the Payload portion
253 <param name="graph-legend" value="Total Bytes" />
254 <param name="precedence" value="800" />
257 <leaf name="UsedBytes">
258 <param name="rrd-create-dstype" value="COUNTER" />
259 <param name="snmp-object-type" value="COUNTER64" />
260 <param name="vertical-label" value="Bytes/s" />
261 <param name="graph-lower-limit" value="0" />
262 <param name="snmp-object"
263 value="$docsIfCmtsDownChnlCtrExtUsedBytes.%ifindex-map%"/>
264 <param name="rrd-ds" value="UsedBytes" />
265 <param name="hidden" value="yes"/>
266 <param name="comment">
267 The total number of DOCSIS data bytes transported by this downstream
270 <param name="graph-legend" value="Used Bytes" />
271 <param name="precedence" value="800" />
272 <param name="monitor-action-target" value="Utilization"/>
280 <monitor name="docsis-snr-lower-20db">
281 <param name="monitor-type" value="expression" />
282 <param name="rpn-expr" value="DUP,0,GT,EXC,20,LT,AND" />
283 <param name="action" value="docsis-snr-lower-20" />
284 <param name="expires" value="3600" />
285 <param name="comment">
286 Signal/Noise-Ratio was lower than 20dB
290 <action name="docsis-snr-lower-20">
291 <param name="action-type" value="tset" />
292 <param name="tset-name" value="docsis-snr-lower-20" />
298 <token-set name="docsis-snr-lower-20">
299 <param name="comment" value="S/N Ratio less than 20dB" />