BW-IPFM is a perl script wich uses the ipfm log files to generate easy-to-read reports. It can provide daily, monthly and specific time frame repports.

Monthly Bandwith Usage for November 2002
Hosts              In        Out     Total
------------------------------------------
nala          159.48M     14.33M   173.81M
reglisse        8.50M     52.60M    61.10M
simba         274.51M     18.99M   293.50M
BROADCAST     118.48K          0   118.48K
------------------------------------------
Total:        442.69M     85.92M   528.61M

BW-IPFM is free and protected by the GPL license.



bw-ipfm-1.5.tar.gz bw-ipfm-1.5.pl
bw-ipfm-1.4.tar.gz bw-ipfm-1.4.pl
bw-ipfm-1.3.tar.gz bw-ipfm-1.3.pl
bw-ipfm-1.2.tar.gz bw-ipfm-1.2.pl
bw-ipfm-1.1.tar.gz bw-ipfm-1.1.pl
bw-ipfm-1.0.tar.gz bw-ipfm-1.0.pl


Version 1.5

  • Fixed wrong separator detection

  • Fixed wrong day/month displayed in title with -d and -m

  • Fixed wrong title display when -interval used

  • Improved FILENMAE detection

Version 1.4

  • Fixed the bug of wrong monthly reading

  • Fixed a bug in the imbricated while wich was not detecting all log and may fall in infinit loop

  • Fixed the missing -i in the help

  • Added the -yesterday switch

  • Added the -lastXXdays switch

  • Added the -lastXXmonths switch

  • Added the -debug switch

  • Improved the from to value initialization with the new interval function

  • Improved help function

  • Changed -from and -to for -interval

Version 1.3

  • Fixed the sort routine bug where the 1st element became the last one

  • Added auto detect feature to get the pattern of the log file using ipfm.conf

Version 1.2

  • Fixed duplicate "Usage" in title

  • Fixed bug of futur day generating infinit loop

Version 1.1

  • Fixed bug of non appearing host

  • Fixed bug of bandwith attribution to the wrong host

  • Fixed bug of non existent september in the month list

  • Added the -from directive

  • Added the -to directive

  • Added Sort support

  • Added the $ipfm_minute and $ipfm_second configuration

  • Improved the argument capture routine

  • Removed the $main_file configuration

  • Removed the -w directive, now use -from -to

  • Removed the -s directive, now use -from -to

Version 1.0

  • Initial Release

  1. Download and install IPFM from http://robert.cheramy.net/ipfm

  2. Download BW-IPFM and untar

  3. Edit bw-ipfm and modify the line $configuration_file to point on your ipfm.conf

  4. Edit your ipfm.conf to create hourly logs, example:

    NEWLOG
LOG 192.168.0.0/255.255.255.0
FILENAME "/var/log/ipfm/%y/%m/%d/%H:%M:%S"
DUMP EVERY 1 hour after 00 minutes 00 seconds
CLEAR EVERY 1 hour after 00 minutes 00 seconds
SORT TOTAL

That's it, now you're ready to type ./bw-ipfm and see your repports!


USAGE: ./bw-ipfm [-d [DD][/MM][/YY] | -m [MM][/YY] | [-interval DD/MM/YY-DD/MM/YY]][-f (host|in|out|total)][-o (asc|des)][-i ID][-h]
If no argument are specify, -d is assume

-d [DD][/MM][/YY]

generate a daily repport (current day of current month of current year is used if none are specify

-m [MM][/YY]

generate a monthly repport (curent month of current year is used if none are specify)

-yesterday

generate a daily repport for yesterday

-lastXXday

generate a repport for the last XX days

-lastXXmonths

generate a repport for the last XX months

-interval DD/MM/YY-DD/MM/YY

gspecify the interval for the repport

-i ID

Specify wich FILENAME you want to use from your ipfm.conf (usefull only if you have multipe FILENAME instance in your ipfm.conf)

-f [host|in|out|total]

specify the field to sort on, can be host, in, out or total

-o [asc|des]

specify the order to sort on, can be asc ascending or des for descending

-debug

gPrint repport and debugging information

-h

Print this help



For question, suggestion or support, please contact the author,
Patrick Lagacé, (bwipfm AT patricklagace DOT com)

BW-IPFM is a member of the Intellos network
Patrick Lagacé, November 2002