Modem usage monitor

A program to monitor modem usage over time (allthough it can easily be changed to monitor usage of other ressources). It generates an image, which can be incorporated in a HTML page.

Last version version 0.32 Thu Jan 25 11:00:03 CET 2001

This programm is used to monitor modem usage over time (allthough it can easily be changed to monitor any other ressource). It generates an image showing modem/ressource usage over time, which can be incorporated in an automagically updated HTML page like this:

Analog
ISDN

Modems are counted from top to bottom. A colored bar represents a modem being active. The number on the vertical axis is the tty-port-number so you have to add 1 to have the corresponding serial port-number that is the number of the modem.

The horizontal-axis represents the time axis. In this case it should represent 3days and 8 hours

License and Download

Modemusage it is a Perl script copyrighted by T.Pospisek under the GPL. You can download it here. If you use it, then please leave me a note.

README

The following is an excerpt from the README:

MODEMUSAGE
----------

Description:  This small Perl script generates a png with a x-y representation
              of modem(tty) usage over time. This can be very well used to
              display the modem usage on a web page.

Preliminary:  You need the GD library from http://www.boutell.com/gd/. You
              need Perl (http://www.perl.org) too.

Installation: 1) Decide where you want to have the png in and how it should be
                 called. Edit the config file. Find the line for the template:

                 $template = "/var/www/stats/usage.png";

                 and replace it by the absoltue path to the png. Do the same
                 with the line:

                 $grafik = "/var/ww/stats/usage_axe.png";

                 This is the actual picture. Edit the demo-www-page index.html
                 and change the location of the png file (here usage_axe.png)
                 appropriately.

              2) Edit the config file. Change the line my $n_modems = 32
                 to represent correctly the number of modems you've got.

              3) Find out how you can display a list of used ttys. On my system
                 (with a Cyclades board) I can do this with:

                 w -hs|fgrep ttyC|cut -b 14-17

                 Change the line:

                 my $get_ttys="w -hs|fgrep ttyC|cut -b 14-17";

                 appropriately.

              4) Decide on how often you want your modems to be checked. Edit
                 your crontab and put a command line like the following in it:

                 0,5,10,15,20,25,30,35,40,45,50,55 * * * * root modemusage -f /etc/modemusage.cfg.

                 where /etc/modemusage.cfg is the config file.

                 Decide how long a period you want to monitor and change that
                 in the line:

                 my $x_s = 960 * $x_factor;

                 $x_factor represents the x-axe stretch factor and probably
                 doesn't need to be changed.

                 960 is the number of checks to represent in a picture.
                 To calculate the correct number for yourself you divide the
                 legth of the period in minutes you want to represent by the
                 length of the period a check is done. Since we're checking
                 every 5 minutes in cron 960 represents 3 1/3 days here...

              5) Well ok, go for it. You should be able to look at the
                 index.html page and have it refreshed every 5 minutes...
                 Good luck, and hope you'll have an easier job now finding
                 broken/hung modems...

Copyright etc.:  Programm written and (c) under GPL by T. Pospisek. The
                 homepage of this proggie is www.sourcepole.ch/sources/software/modemusage