Monitoring Squid

[LEFT][CODE]http://www.visolve.com/squid/whitepapers/monitoringsquid.php[/CODE]
[B][B][SIZE=-1][B]
Introduction[/B][/SIZE][/B][/B]

[SIZE=-1]Squid runtime information like CPU usage, Memory usage, Cache Hit, Miss etc can be monitored using SNMP (a.k.a Simple Network Management Protocol). For this your squid server should have SNMP Server installed; True SNMP support is available from squid 2 and above. SNMP is normally transported through UDP packets. SNMP receives and responds to SNMP messages sent to the SNMP port on the local machine. The standard SNMP port is 161; by default Squid listens for incoming SNMP requests on port 3401. [/SIZE]

[SIZE=-1] There are a number of tools used to monitor Squid via SNMP, among which MRTG is mostly used. The Multi Router Traffic Grapher (MRTG) is a tool to monitor squid information which generates a real-time status (graphical representation), in dynamic view by sampling data every five minutes (may vary according to your need). MRTG shows activity - in the last 24 hours and also in a weekly, monthly and yearly graph. [/SIZE]

[SIZE=-1] Note: Working examples used in this document are from Linux OS. This may vary for other OS. [/SIZE] [B][B][SIZE=-1][B]

Enable SNMP in Squid[/B][/SIZE][/B][/B]


[SIZE=-1]To use SNMP with squid, it must be enabled with the configure script, and rebuilt. To enable SNMP in squid go to squid src directory and follow the steps given below : [/SIZE]

[SIZE=-1] ./configure --enable-snmp [ ... other configure options ] [/SIZE]

[SIZE=-1] make all[/SIZE]
[SIZE=-1] make install [/SIZE]

[SIZE=-1] And edit following tags in squid.conf file : [/SIZE]

[SIZE=-1] acl aclname snmp_community public[/SIZE]
[SIZE=-1] snmp_access aclname [/SIZE]

[SIZE=-1] Once you configure squid and SNMP server, Start SNMP and squid. [/SIZE]

[SIZE=-1] Querying the Squid SNMP agent [/SIZE]

[SIZE=-1]You can test if your Squid supports SNMP with the snmpwalk program (snmpwalk is a part of the UCD-SNMP project). Note that you have to specify the SNMP port, which in Squid defaults to 3401. [/SIZE]

[SIZE=-1] snmpwalk -p 3401 hostname communitystring .1.3.6.1.4.1.3495.1.1.If it gives output like : [/SIZE]

[SIZE=-1] enterprises.nlanr.squid.cacheSystem.cacheSysVMsize = 7970816[/SIZE]
[SIZE=-1] enterprises.nlanr.squid.cacheSystem.cacheSysStorage = 2796142[/SIZE]
[SIZE=-1] enterprises.nlanr.squid.cacheSystem.cacheUptime = Timeticks: (766299) 2:07:42.99 [/SIZE]

[SIZE=-1] then it is working ok, and you should be able to make nice statistics out of mrtg tool. [/SIZE] [B][B][SIZE=-1][B]

Installing and configuring MRTG[/B][/SIZE][/B][/B]

[SIZE=-1]You can get MRTG from [URL="http://mrtg.hdl.com/pub/"]http://mrtg.hdl.com/pub/.[/URL]Create a user for mrtg for example create a user name as mrtg and then untar the package [/SIZE]

[SIZE=-1] tar -xvzf mrtg-* [/SIZE]

[SIZE=-1] To configure, compile and install the mrtg enter the following commands : [/SIZE]

[SIZE=-1] ./configure[/SIZE]
[SIZE=-1] make[/SIZE]
[SIZE=-1] make install [/SIZE]

[SIZE=-1] And run[/SIZE]
[SIZE=-1]/cfgmaker --global 'WorkDir: /home/mrtg/' --global 'Options[_]: bits,growright' --output /home/mrtg/cfg/mrtg.cfg public@ipaddress or hostname of SNMP-Squid machine [/SIZE]

[SIZE=-1] This will create a configuration file as mrtg.cfg in /home/mrtg/cfg/mrtg.cfg [/SIZE]

[SIZE=-1] [B]Note:[/B] This example above will create an mrtg config file in /home/mrtg/cfg assuming /home/mrtg is visible on your webserver [/SIZE]

[SIZE=-1] Edit this configuration file (mrtg.cfg)[/SIZE]
[SIZE=-1] LoadMIBs: /mib.txt[/SIZE]
[SIZE=-1] And you have to set Target to get squid information. [/SIZE]

[SIZE=-1](Note: The Squid MIB can be addressed by its root, which is 1.3.6.1.4.1.3495.1. In symbolic names, that is iso.org.dod.internet.private.enterprises.nlanr.squid. Symbolic names are used only when interacting with people - the packet only contains the numeric MIB label.) [/SIZE]

[B][SIZE=-1][B]Running MRTG[/B][/SIZE][/B]

[SIZE=-1]Once you have created a configuration file, try the following : [/SIZE]

[SIZE=-1] /mrtg /mrtg.cfg [/SIZE]

[SIZE=-1]This will query your squid and also create your first mrtg traffic graphs and webpages. When you run mrtg for the first time there will be a lot of complaints about missing log files. Don't worry, this is normal for the first 2 times you start mrtg. If it keeps complaining after this time you might want to look into the problem. [/SIZE]

[SIZE=-1] Sample [URL="http://www.visolve.com/squid/whitepapers/cachecputime.php"]Screen shots[/URL] generated by MRTG-SNMP. [/SIZE]

[SIZE=-1]Starting mrtg by hand is not ideal in the long run. So when you are satisfied with the results you must automate the process of running mrtg in regular intervals (this means every 5 minutes by default). [/SIZE]

[SIZE=-1] If you are using Linux, then the line may look like this if you are using crontab -e [/SIZE]

[SIZE=-1] */5 * * * * /mrtg /mrtg.cfg [/SIZE] [B][B][SIZE=-1][B]

References[/B][/SIZE][/B][/B]


[SIZE=-1][URL="http://www.visolve.com/squid/squid24s1/contents.php"]ViSolve Squid Configuration Manual 2.4[/URL][/SIZE]
[SIZE=-1] [URL="http://www.visolve.com/squid/squid30/contents.php"]ViSolve Squid Configuration Manual 3.0[/URL][/SIZE]
[SIZE=-1] [URL="http://people.ee.ethz.ch/%7Eoetiker/webtools/mrtg/"]http://people.ee.ethz.ch/~oetiker/webtools/mrtg/[/URL][/SIZE]
[SIZE=-1] [URL="http://people.ee.ethz.ch/%7Eoetiker/webtools/mrtg/squid.html"]http://chrismiles.info/unix/mrtg/squidsample/[/URL][/SIZE]
[SIZE=-1] [URL="http://net-snmp.sourceforge.net/"]http://net-snmp.sourceforge.net[/URL][/SIZE]
[/LEFT]