As already mentioned in the architecture guide, all Perl clients are written around Perl module Bionanny::Listener et al. Their API is a simplified Bionanny API (allowing to get data but not to log them - at least not at the moment).
Where are all these clients?
The sources are in the src/perl subdirectory (where else?) - but the Ant compile target moves them into build/run directory and some of them into build/cgi-bin directory. That's the place they should be used/called from.
Note, however, that the Ant compile target just moves them but it does not check if their first line (usually something like #!/usr/local/bin/perl -w) corresponds with the Perl executable location on your machine. Therefore, you may need to change it manually.
The bionanny.pl is a comprehensive command-line client. Invoke it by:
For a detailed help with examples, call (assuming that the perldoc is on your path):
There are several scripts that can be called as cgi-bin scripts and they show monitored data in a Web browser. As always with the cgi-bin scripts, the important is to put them where your HTTP server can find them. By default, the Ant will move them to the build/cgi-bin directory - so you can simply make a symbolic link pointing there.
Or, you can set an Ant property cgi.bin.dir pointing to a directory where Ant will copy them instead. For example:
./build-dev.sh -Dcgi.bin.dir=/my/cgi-bin/place compile
Remember, however, the example above will work only if you have a correct write permission to the destination directory.
Now, when your HTTP server knows about them, you can put in your browser something like:
and start to use it.