Captrap is a set of Perl scripts designed to work with the pmacctd network traffic accounting daemon. Pmacctd logs traffic statistics to a MySQL database, and Captrap fetches those data and generates tables and graphs.
Captrap is intended for users in situations like these:
The graphs produced by Captrap can be useful for determining whether a cap will be overrun based on recent usage data.
For more information, see the README file.
Demo 1 is a set of pages and graphs for this server, updated by an hourly cron job. Demo 2 is from another system (with more exciting graphs) but is not updated regularly.
See the changelog for more detailed
information about release changes.
You may examine the contents of the current Captrap package
here.
--- current version ---
2016-09-06: Captrap 1.0.4
source tar.bz2: captrap-1.0.4.tar.bz2
Debian package: captrap-1.0.4_all.deb
This fixes a warning about CGI::Pretty being deprecated. CGI::Pretty is no
longer used. This also fixes some experimental smartmatch errors.
--- old versions ---
2013-11-14: Captrap 1.0.3
source tar.bz2: captrap-1.0.3.tar.bz2
Debian package: captrap-1.0.3_all.deb
I'm not actively developing captrap any more, and the code looks old and
clunky, but I still use it. This release makes captrap build and run on Debian
Jessie (in its current state).
2010-12-27: Captrap 1.0.2
source tar.bz2: captrap-1.0.2.tar.bz2
Debian package: captrap-1.0.2_all.deb
This release fixes two bugs--the first bug prevented captrap_view from running,
and the second bug prevented 'make install' from working unlesss 'make' was run
first.
2010-01-28: Captrap 1.0.1
source tar.bz2: captrap-1.0.1.tar.bz2
Debian package: captrap-1.0.1_all.deb
Version 1.0.1 is a quick fix for a race condition I encountered right after
releasing 1.0.0.
2010-01-27: Captrap 1.0.0
source tar.bz2: captrap-1.0.0.tar.bz2
Debian package: captrap-1.0.0_all.deb
Captrap is now feature-complete according to my original plans, so the time has
come to declare it "1.0". Further improvements are likely to be incremental.
This version supports SVG output, more use of color for those who can see them,
and optional patterned-bar graphs for the colorblind. There are also several
other improvements and bugfixes; see the changelog for details.
2009-01-03: Captrap 0.9.0
source tar.bz2: captrap-0.9.0.tar.bz2
Debian package: captrap-0.9.0_all.deb
0.9.0 has some bugfixes and some new features, including graphing of packet
statistics and outputting of text and CSV tables. Man pages are now generated
from POD markup in the source files.
2009-10-31: Captrap 0.8.2
source tar.bz2: captrap-0.8.2.tar.bz2
Debian package: captrap-0.8.2_all.deb
Captrap crashed on Halloween. This release fixes a date calculation bug.
2009-10-26: Captrap 0.8.1
source tar.bz2: captrap-0.8.1.tar.bz2
Debian package: captrap-0.8.1_all.deb
This release has a few minor documentation fixes (notably, better instructions
for Debian Lenny). If you're already using Captrap 0.8.0 there's no need to
upgrade.
2009-09-01: Captrap 0.8.0
source tar.bz2: captrap-0.8.0.tar.bz2
Debian package: captrap-0.8.0_all.deb
This is the first public release of Captrap, so there are likely to be bugs and
incompatibilities. I'm only going to announce it to a few people, but search
engine spiders will find this page eventually. If you've come here on your own,
please test Captrap and give me feedback.
You can download the Captrap Git repository with the following command:
git clone git://git.fatooh.org/captrap.git
Captrap is developed on Debian Squeeze and tested on Debian Sid and Debian Lenny. Users of other operating systems may be able to use Captrap with varying success depending on how different the system is from Debian.
Please test Captrap and send me bug reports if it doesn't work for you. A patch and/or diagnosis of the problem would be most helpful.
Debian users should download and install the Debian package.
# dpkg -i captrap-0.8.0_all.deb # apt-get -f install
Captrap depends on a package that doesn't exist on Debian Lenny. Lenny users should read the debian_lenny file for instructions.
After that, read the INSTALL document (either in /usr/share/doc/captrap/INSTALL.gz or here) for further configuration instructions.
Download the source tar.bz2 file and extract it. Read the README and INSTALL files.
CPAN (for modules Captrap needs)
http://www.cpan.org/
pmacct (which logs data Captrap uses):
http://www.pmacct.net/
gnuplot (which generates Captrap's graphs):
http://www.gnuplot.info/
Corey Hickey, bugfood-c [at] fatooh [dot] org
Captrap is licensed under the GNU General Public License, version 3.
other stuff