MRTG ADD-ON
By Rolph Haspers (kliko@haspers.nl)
#-----------------------------------------------------------------------
#Based on the following ADD-ON's By:
# - Marcel Leicher (marcel@silverpoint.nl)
# - Vincent Houwert (vincent@trueserver.nl)
#
#URL: http://gbgraph.menthenberg.nl/
#
#Special for hosting companies; MRTG-archive, Traffic usage graph, etc.
#-----------------------------------------------------------------------
#Version 1.9, on MRTG (www.mrtg.org) 2.9.12
#(c) 2001, Last change: June 10th 2001
#-----------------------------------------------------------------------
This version: 2.0c
Date: 24-08-2001
Please give feedback on bugs and sites using this add-on to kliko@haspers.nl
----------------------------------------------------------------------------
Files with this program:
Perl:
* gb.pl
This is the main program generating the PNG graphics
* target.pl
This is the part which generates the .data files, used by gb.pl
* GD.ppd
This is a file to install the GD library for Perl (see ActiveState.com)
PNG:
* fun.png
A 'very ugly' example of a possible baseimage, see extra's.
* gb.png
An example output file
ASP:
* data.asp
Example ASP-form to get host name and month for input to get the the PNG graphic.
-----------------------------------------------------------------------
Requirements:
* Windows system (not tested on Unix. Target.pl will work on UNIX. GB.pl won't unless the Perl-GD library is installed I guess)
* Perl 5.0 or higher (pref. 5.6.x)
* GD library for Perl (see below)
* MRTG 2.x (tested on 2.9.12, see MRTG instructions on how to install)
-----------------------------------------------------------------------
Installing:
1. Unzip all files in a subdirectory of mrtg (This must be a subdir of MRTG!!!)
2. If you have the GD library already installed continue to step #3.
To install the GD library, go to your Command-prompt and go to your directory
where you just unzipped these files and type the following:
C:>ppm
(When this doesn't work, check your Perl installtion. The Perl directory should be in
your path settings)
You will now get another prompt. Type in install GD.ppd
PPM>install GD.ppd
Now the GD-library will be retrieved from Activestate and installed
3. Edit the variables in gb.pl
4. Edit the variable in target.pl
If you want to make new .data file, change $firsttime to 1.
This isn't necessary if you are running these scripts for the first time. It will delete
all of your .data files for all targets in the config file specified, and fills it with
data from only the current month (can you follow me? I can't :) )
5. Run target.pl location_of_cfg_file
Example: target.pl C:\Mrtg\bin\mrtg.cfg
This will make the [targets].data files in the Log-directory or Work-directory specfied in mrtg.cfg
6. To view a graphic for one of your targets, put gb.pl in a directory of your website (with execute
permission for Perl) and type in:
http://your.domain.com/gb.pl?host=targetname&month=monthnumber
Where:
host = the target you want view. When the datafiles are located in a subdirectory of the $DOCUMENT_ROOT
specified in gb.pl the host name will be: host=subdir/target
month = the monthnumber of the month you want to view. Eg: 1 = January, 2 = February...etc.
You can also put data.asp in the same directory and call data.asp.
7. Make a daily schedule which runs target for each .cfg file. One way is to make a batch file which
runs all targets and schedule this batch file. For example, create target.bat:
@echo off
perl C:\mrtg\bin\data\target.pl C:\mrtg\bin\mrtg.cfg
perl C:\mrtg\bin\data\target.pl C:\mrtg\bin\mrtg2.cfg
etc...
Enjoy!
--------------------------------------------------------------------------
Extra's in gb.pl:
* BaseImg:
In gb.pl you can modify the look&feel of the graph, by adding a "base image".
* Colors:
On the same way as the above option you can add "bluein=xxx","redin=xxx"
and "greenin=xxx" options for coloring the graphs IN-traffic bars.
Adding "blueout=xxx", "redout=xxx", "greenout=xxx", you can change the color of
the OUT-traffic bars.
See gb.pl for example.
--------------------------------------------------------------------------
Known using sites:
LeaseWeb: http://www.leaseweb.nl
Centurion Systems: http://www.centsi.com
--------------------------------------------------------------------------
Version history:
24-08-2001 - version 2.0d Removed some minor bugs
20-06-2001 - version 2.0a. Improved graphing methods. Removed bug with dates. Improved count methods.
17-06-2001 - Version 0.9d. Removed another minor bug and added an example ASP-form.
16-06-2001 - Version 0.9c. Removed a minor bug.
14-06-2001 - Version 0.9b. Made original work for Windows.
12-06-2001 - Release of the original version 1.9. Release by:
- Marcel Leicher (marcel@silverpoint.nl)
- Vincent Houwert (vincent@trueserver.nl)
See history below for the original version.
0.1 - Basic GB/D graph with input from file
- Dotted blue Average-line
0.2 - Larger image
- Total this, Total last month, Average and Peak in text
- Calculate expected use on basis of average
0.3 - Variable graph-color
0.4 - DayInMonth variable; so no static 31 days
- GB/TB conversion for month-total/expected
0.9 - total code makeover
- overall debug mogelijkheid met &debug=1
- extra filecheck
- diverse for() lussen toegevoegd om code optimize
- functies als trim/sprintf gebruikt om strings netter (te formater)
- auto output format in bytes, k, m, g, t, en peta bytes.
- totaal berekening met array functie, max berekening omgeschreven,
avg nu over aantal dagen dat er waardes zijn ipv over aantal dagen maand
- grijs raster toegevoegd
- y-waarde met 1 decimaal, rechts uitgelijnt
- uitlijnen totaal overzicht op rechts incl. afrondenen formateren 0.1f.
1.0 - using new .data filetype, with date in it.
1.2 - added archiving function
1.3 - added tab's
1.4 - 2 color graph, baseimg option
1.9 - lot's of debugging and optimizing, perl and php.