← Back to branch summary

~ubuntu-branches/ubuntu/natty/ntop/natty

« back to all changes in this revision

Viewing changes to python/templates/rrdAlarmConfiguratorHelp.tmpl

  • Committer: Bazaar Package Importer
  • Author(s): Ludovico Cavedon, Jordan Metzmeier, Ludovico Cavedon
  • Date: 2010-12-15 20:06:19 UTC
  • mfrom: (5.1.5 sid)
  • Revision ID: james.westby@ubuntu.com-20101215200619-0ojz3iak95ihibun
Tags: 3:4.0.3+dfsg1-1
http://bugs.debian.org/522042
http://bugs.debian.org/595450
https://launchpad.net/bugs/257466
[ Jordan Metzmeier ]
* New upstream release (Closes: #522042)
* Move data files to /usr/share/ntop (Closes: #595450).
* Package architecture independent data in a separate ntop-data package.
* Use debhelper 7.
* Update Standards-Version to 3.9.1.
* Depend on python-mako.
* Do not include ntop.txt in binary packages as it is a copy of the man
  page.
* Do not include NEWS, as it is outdated.
* Switch to package source version 3.0 (quilt).
* Add password creation to debconf
* Changed init script to fix localization problems (thanks to Alejandro
  Varas <alej0varas@gmail.com>, LP: #257466)
* Remove manual update-rc.d calls from postrm and postinst. debhelper adds
  this for us.
* Add pre-depends on adduser for postinst script.
* Fix errors in the manpages: fix-manpage-errors.patch.
* Added fixes for matching active interfaces.
* Added a watch file.

[ Ludovico Cavedon ]
* Remove direct changes to upstream tree, and move them into specific patch
  files:
  - fix-manpage-errors.patch: fix typos in ntop.8.
  - dot-path.patch: fix path of /usr/bin/dot executable
* Add patches:
  - reduce-autogen-purged-files.patch: prevent agutogen.sh from reamoving
  too many files during cleanup.
  - Add build-without-ntop-darwin.patch, to fix compilation without
  ntop_darwin.c.
* No longer add faq.html, as it is not distributed in the upstream tarball.
* Use ${source:Version} in control file. Have ntop-data recommend
  ntop.
* Rename dirs to ntop.dirs and keep only empty directories that need
  to be created.
* Remove var/lib from ntop.install file, as it is empty (keeping it in
  ntop.dirs).
* Update po files.
* Breaks and Replaces instead of Conflitcs for ntop-data.
* Use a longer package description.
* Remove useless configure options from debian/rules.
* Move private shared libraries libraries in /usr/lib/ntop.
* Add change-plugin-dir.patch for adjusting plugin directory.
* Remove development files.
* Use system library for MochiKit.js.
* Rewrite DEP5 copyright file.
* Repackage upstream tarball in order to remove non-DFSG-compliant code. Add
  get-orig-source.sh script and get-orig-source target in debian/rules.
* Add explanation to README.Debian why geolocation is no longer working.
* Add avoid-copy-maxmind-db.patch to prevent copying of Geo*.dat
  files.
* Remove old unused patches.

Show diffs side-by-side

added added

removed removed

Lines of Context:
python/templates/rrdAlarmConfiguratorHelp.tmpl
 
1
<p>&nbsp;</p>
 
2
<h3>RRDAlarm</h3>
 
3
<p>RRDAlarm is a tool design to work in conjunction with <b>ntop</b> to let you configure and check a certain number of thresholds for any rrd file generated by <b>ntop</b>. During the checking if a threshold is exceeded the action defined for that specific threshold will be launched, in this manner you can configure, for example, a mailing script to send you a mail for any abnormality that you want to control over your network. This piece of software is written in python and included in <b>ntop</b> through two dynamic loaded modules, ntop and host (look at python.c), provided as an extension to python by <b>ntop</b> itself. 
 
4
 
 
5
<h3>RRDAlarm configuration </h3>
 
6
<p>RRDAlarm needs a configuration file to actually do the checking, this file must contain the thresholds to check and all the data necessary to perform the action established in correspondence of the trespass of a threshold. To generate the configuration you have to fill the table (Utils -> RRDAlarm -> Configure Thresholds) with rows, each row represent a threshold. Every time you modify the table you can save it clicking the Save Config button at the bottom of the table. You can still provide a manually written configuration file (appropriately formatted of course), place it in the right directory and call the ../python/rrdalarm/start.py script, but you'll find the configuration page to be more easy and good looking than edit everything manually. Moreover using this tool you can create multiple configuration files, load them, and have an immediate look at the thresholds you set.</p>
 
7
<h3>Description</h3>
 
8
<p>To load a configuration file you can modify the filename input field in the Configuration file row; pressing the button "Load" will cause the page to reloaded with the data from the new configuration file.</p>
 
9
<p>The table you see in the center of the RRD Alarm Configuration's page is the one that holds all the data of the configuration file. Every row of the table is a threshold and is selectable by a mouse click, once you select a row you can edit it changing the values on the input fields in the last row of the table. Any time you'll hit the update button the values inside the input field will be inserted in the row you selected. Hitting the Add Row button a new row will be added at the bottom of the others filled with the values currently inside the input fields. Adding and updating a row are two operations that will be performed only if the input fields values are valid, if not the uncorrected fields will turn red, placing the mouse over those fields will tell you what kind of problem was there. To help you write a valid RRD File Path you can activate the autosuggest function for that field clicking on the image button just right of it.</p>
 
10
<p>To deselect a row and reset the current values of the input field just click on the Reset button.</p>
 
11
<p>To remove a row first you need to select one, then just press on the Remove Row button. Due to the fact that the IDs could be a reference for you and should remain the same, the rows will no be re-indexed; holes can happen, if you don't like them you can still click at the top of the ID column to reIndex your table.</p>
 
12
<h3>Threshold format</h3>
 
13
<p>A threshold consist of an <b>ID</b> that represent it, a <b>RRD File Path</b> field that points to the file(s) to check periodically (same expansion characters as unix shell can be used, remember that the path inserted here is relative to the RRD file), and the <b>Threshold Type</b> you want to set, above or below. Next you must establish a limit <b>Value</b> for your threshold, any kind of numeric values are accepted. The <b>Num. Repetitions</b> field requires, on the contrary, a non negative integer and it defines the number of times for the threshold to exceed (successively) before the alarm to trigger. The <b>Start Time</b> and <b>End Time</b> let you specify the time frame you want to be controlled; the format accepted by this two fields is a subset of the AT TIME format defined in the <a href="http://oss.oetiker.ch/rrdtool/doc/rrdfetch.en.html#IAT_STYLE_TIME_SPECIFICATION">Fetch</a> documentation on RRDTool homepage. The next field <b>Action To Perform</b> shows (in bold) the name of the script that will be launched when an alarm is triggered and the parameter to pass on to that script just after the colon. The scripts listed in the drop down menu are all the executable files present in the &quot;ntop/rrdalarm/scripts/&quot; directory in your ntop install directory on disk. The last field <b>Time Before Next Alarm (sec)</b> expresses the the minimum number of seconds before another action can be triggered, any non negative number is acceptable.</p>
 
14
<p>Example:</p>
 
15
<center>
 
16
<table id="configuration" cellspacing="0" cellpadding="5" border="1" >
 
17
<thead>
 
18
<tr>
 
19
<th nowrap="nowrap" bgcolor="#f3f3f3" align="center" title="Click to reIndex this column"><A href="">ID</A> 
 
20
</th>
 
21
<th nowrap="nowrap" bgcolor="#f3f3f3" align="center"> RRD File Path</th>
 
22
<th bgcolor="#f3f3f3" align="center">Threshold<br/>Type 
 
23
</th>
 
24
<th nowrap="nowrap" bgcolor="#f3f3f3" align="center"> Value </th>
 
25
<th bgcolor="#f3f3f3" align="center">Num.<br/>Repetitions 
 
26
</th>
 
27
<th nowrap="nowrap" bgcolor="#f3f3f3" align="center"> Start Time </th>
 
28
<th nowrap="nowrap" bgcolor="#f3f3f3" align="center"> End Time </th>
 
29
<th nowrap="nowrap" bgcolor="#f3f3f3" align="center"> Action To Perform </th>
 
30
<th nowrap="nowrap" bgcolor="#f3f3f3" align="center" title="Time Before Next Action (sec)">Time Before<br/>Next Action (sec)
 
31
</th>
 
32
</tr>
 
33
</thead>
 
34
<tbody id="body">
 
35
<tr style="">
 
36
<td align="right">1</td>
 
37
<td align="left">interfaces/eth0/ethernetPkts.rrd</td>
 
38
<td align="center">
 
39
above
 
40
<img class="tooltip" border="0" src="/arrow_up.png"/>
 
41
</td>
 
42
<td align="right">0.0</td>
 
43
<td align="right">0</td>
 
44
<td align="right">now-10h</td>
 
45
<td align="right">now</td>
 
46
<td align="left" title="savelog">
 
47
<strong>savelog</strong>
 
48
:
 
49
id1logfile.txt
 
50
</td>
 
51
<td align="right">0</td>
 
52
</tr>
 
53
  </tbody>
 
54
</table>
 
55
</center>
 
56
<h3>Save Configuration</h3>
 
57
<p>All the modifications you made to the table are non-persistent, meaning you HAVE to click the Save Config button at the bottom of the table in order to save the configuration file on disk. The name of the configuration file that will be saved is the value of the Configuration File field. The path for this file is restricted to the standard defined by <b>ntop</b> installation directory.</p>
 
58
<h3>Start the Check</h3>
 
59
<p>RRDAlarm was designed to run continuously every minute to check the configuration file you provided. Anyway you can click on the Check Thresholds now link or click on the menu Utils->RRD Alarm->Check Now, this action will execute the start.py script that will check all the thresholds you have set and create an HTML report page with the details of the operation. To schedule the start.py script to run every minute you can install the crontab.rrdalarm file in the /ntop/rrdalarm install directory (simply open a shell with your ntop user and digit &quot;crontab &lt;pathcrontab.rrdalarm&gt;&quot;), you need cron installed of course and curl. For windows users there are some porting for cron and curl that can work for you. The operation that will be executed every minute is a HTTP get to &quot;<i>http://localhost:3000/python/rrdalarm/start.py?noHTML=true</i>&quot;; the last parameter will instruct the script not to return with a HTML report page.</p>
 
60
<p>&nbsp;</p>
 
 
b'\\ No newline at end of file'