MRTG Statistics Archiever

Version 0.2

Oleg Krotoff <krot@tnsplus.kz>

16/06/2000

---------

Intro and Disclaimer

This script was written as a result of attempts to provide

automatic archiving of graphs, generated by MRTG for all 

targets.

I failed to customize the scripts written by Emanuele Leonardi 

<Emanuele.Leonardi@roma1.infn.it> and Rawlin Blake 

<blake@nevada.edu> (their scripts supplied with MRTG in contrib)

so I wrote my own.

The script provided "as-is", just because it may be usefull

for someone with the same needs. It works for me, but

I can't be sure that it will work for you. It was tested only

with Linux 2.2.14 -- 2.2.16, Apache 1.3.6 -- 1.3.12 

and Perl 5.6. 

---------

* mrtg-archiver

Main part is the 'mrtg-archiver' script itself. It tries to parse

MRTG configuration file and extracts the list of targets. Then

the script copies graphs and necessary parts of html file to

the archive.

* Command-line options:

-conf=/path/to/config-file	MRTG configuration file

-arch=/path/to/archive		Path to folder, where the archive

				will be stored. You should create

				folders 'days', 'weeks', 'months'

				'years' in it and also you can

				place the supplied index.html

				to the archive folder. All other

				indexes are produced automaticaly.

-d	Produce daily archive

-w	Produce weekly archive

-m	Produce monthly archive

-y	Produce yearly archive

-back=n		Tell the archiever, that date, to which the archiving

		process is made was n seconds earlier. This allows

		to make daily archives at, for example, 3:00am but

		mark them by correct (yesterday) date.

The script relies heavily on the structure of html files produced by

MRTG, so if the structure change substantialy the script will possibly

crash.		

* What you can customize in script:

The variable $GroupRE contains regular expression to group targets.

Currently it groups targets by router IP in target itself, assuming

that target name starts from router IP. You can change it to anything

you want and also you can group targets by some parts in Title.

For this you should comment out line 178 and uncomment line 179.

The variable $img_suffix contains the suffix (currently 'png')

of graph files produced by MRTG. If your MRTG produces gifs, you

can change this variable's value to 'gif'.

* Starting the archiver

mrtg-archive supposed to be started by cron. The example lines to

be put in crontab are supplied in file 'to-crontab'

* Navigating through archives

To provide the navigation through archives, the cgi-script 'mrtgnav' 

should be placed into /cgi-bin/mrtg of your WWW server. It requires

URI.pm to be installed on your site. You may need to change the

value of $HtmlBase, it should contain the location of Web server

document root.

The idea of the navigation script was inspired by Cooler 

(http://cooler.irk.ru).