vADC Docs

Monitoring Stingray using MRTG

by crispin on ‎03-13-2013 04:07 AM (1,214 Views)

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 Stingray to allow monitoring of traffic to a site.

Step 1 - Enabling SNMP

SNMP support needs to be enabled on each Stingray 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 Stingray using 'snmpget':

$ snmpget -M /usr/share/snmp/mibs:$ZEUSHOME/zxtm/etc -mALL -v1 -c public stingrayhost totalBytesInLo.0

ZXTM-MIB::totalBytesInLo.0 = Counter32: 140113170

If this works, then SNMP is working correctly.  For more information on installing SNMP, check out Installing the Stingray SNMP MIBs.

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 Stingray machine or virtual appliance, they can be any machine that has the ability to communicate with Stingray 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[stingray_traffic]: Stingray - Traffic

PageTop[stingray_traffic]: <H1>Total traffic through Stingray</H1>

Target[stingray_traffic]: totalBytesInLo.0&totalBytesOutLo.0Smiley Tonguerivate@stingrayhost

MaxBytes[stingray_traffic]: 1250000

Title[stingray_conns]: Stingray - Current Connections

PageTop[stingray_conns]: <H1>Number of current connections to Stingray</H1>

Target[stingray_conns]: totalCurrentConn.0&totalCurrentConn.0Smiley Tonguerivate@stingrayhost

MaxBytes[stingray_conns]: 10000

Options[stingray_conns]: gauge, noo, nopercent

YLegend[stingray_conns]: Current conns

ShortLegend[stingray_conns]: conns

Legend1[stingray_conns]: Current Connections

LegendI[stingray_conns]: Conns

You will also need the Stingray MIB, which you can download through the Admin Interface 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  and save it in the docroot.  You should now be able view the mrtg graphs by going to http://youwebsite/14all.cgi:


This article originally written by Crispin Flowerday, July 2005