MRTG is a graphing tool that can be used to monitor network services and draw graphs showing traffic trends. It can easily be integrated with ZXTM to allow monitoring of traffic to a site.

Step 1 - Enabling SNMP

SNMP support needs to be enabled on each ZXTM machine that you wish to monitor. To turn on support, go to the Administration Server for each machine, and enable it on the System -> SNMP page. You can select port and community string, but for this example we will assume you use '161' and 'private' as the port and community string respectively.

Once SNMP is enabled, you should be able to request snmp values from a ZXTM using 'snmpget':

$ snmpget -M /usr/share/snmp/mibs:$ZEUSHOME/zxtm/etc -mALL -v1 -c private zxtm1 totalBytesInLo.0
ZXTM-MIB::totalBytesInLo.0 = Counter32: 140113170
$

If this works, then SNMP is working correctly.

Step 2 - Installing MRTG and RRDtool

For this demonstration we will use MRTG and RRDtool. Using RRDtool has the advantage that the images are generated on the fly when they are viewed rather than every 5 minutes when the data is collected. MRTG and RRDtool do not need to be located on the ZXTM machine, they can be any machine that has the ability to communicate with ZXTM via SNMP.

The method of installation of MRTG and RRDtool will depend on your operating system, e.g. on Debian Linux you can use the apt tool to install them.

Step 3 - Configure MRTG

Before you configure MRTG you need to decide where the docroot of the website (that will display the graphs) will be, and where to store the raw data. For this demonstration we will use /data/mrtg/data and /data/mrtg/docroot respectively.

Create a MRTG configuration file called /data/mrtg/docroot/14all.cfg :

HtmlDir: /data/mrtg/docroot
ImageDir: /data/mrtg/docroot
IconDir: /data/mrtg/docroot
LogDir: /data/mrtg/data
LoadMIBs: /data/mrtg/mibs/ZXTM-MIB.txt

WriteExpires: No
Interval: 5
NoMib2: Yes
LogFormat: rrdtool

Options[_]: growright

Title[zxtm1_traffic]: ZXTM - Traffic
PageTop[zxtm1_traffic]: <H1>Total traffic through ZXTM</H1>
Target[zxtm1_traffic]: totalBytesInLo.0&totalBytesOutLo.0:private@zxtm1
MaxBytes[zxtm1_traffic]: 1250000

Title[zxtm1_conns]: ZXTM - Current Connections
PageTop[zxtm1_conns]: <H1>Number of current connections to ZXTM</H1>
Target[zxtm1_conns]: totalCurrentConn.0&totalCurrentConn.0:private@zxtm1
MaxBytes[zxtm1_conns]: 10000
Options[zxtm1_conns]: gauge, noo, nopercent
YLegend[zxtm1_conns]: Current conns
ShortLegend[zxtm1_conns]: conns
Legend1[zxtm1_conns]: Current Connections
LegendI[zxtm1_conns]: Conns 

You will also need the ZXTM MIB, which you can download through the ZXTM Administration Server on the Security -> SNMP page. The MIB should be saved into /data/mrtg/mibs .

To check that mrtg is working correctly, run:

$ mrtg /data/mrtg/docroot/14all.cfg

If nothing is printed on stdout, then mrtg is configured correctly, and you should now have some data stored in /data/mrtg/data

Now add a cron job to call mrtg every 5 minutes:

0-55/5 * * * * root /usr/bin/mrtg /data/mrtg/data/14all.cfg

Step 4 - And Finally

One last step is to create a website that can show the MRTG graphs. You configure the docroot to /data/mrtg/docroot and to run cgi scripts from anywhere.

Once the site is created, download the 14all.cgi script from http://my14all.sourceforge.net/ and save it in the docroot.

You should now be able view the mrtg graphs by going to http://mrtgwebsite/14all.cgi:

Crispin Flowerday [Zeus Dev Team] 01 July 2005   2 comments