mrtg-squid(1) [suse man page]
MRTG-SQUID(1) mrtg MRTG-SQUID(1) NAME
mrtg-squid - using mrtg to monitor Squid DESCRIPTION
Squid 2.3 knows SNMP and you can therefore use mrtg to monitor it quite easily. I have made some modifications to mrtg which simplify this. My work is based on earlier modification made by: matija.grabnar@arnes.si and kostas@nlanr.net. MODIFICATIONS
I added new code for displaying correct units to the previous patches "perminute" and "perhour" ("option" tokens), which allows other mea- surement in addition to "persecond". Then I created a new option token "dorelpercent" which allows the calculation of the percentage of IN-stream / OUT-stream on the fly and then displays it on a fixed scale from 0% to 100%. For my requirements, this does good work. Maybe someone wants a floating scale. It should not be a problem to implement it, too (but give me an option to keep my fixed scale). If IN-stream is always less than OUT-stream both lines (OUT-stream and relative percent) are always displayed on top of IN-stream bulk. Otherwise this option makes no sense. With this option you can display hitrates, errorrates (for router monitoring: rel. droprates) easily now. If you use this options please consider that you need a 5th colourname/value pair in your Colours statements! Due to some discussion on this list, I have implemented two tokens too: "kilo" and "kMG" "kilo" should contain the value of k (1000 or 1024), where 1000 is the default. "kMG" is a comma separated list of multiplier prefixes, used instead of "", "k", "M", "G", "T" on the MRTG display. Leave the place free, if you want no prefix. Also an incomplete list of OIDs for the new SQUID release is added. I hope you enjoy it. CONFIG EXAMPLE
You can measure responsetimes in ms and display it with MRTG correctly with: kMG[measure-ms]: m,,k,M,G,T short[measure-ms]: s You can display now MB/s as 1024*1024 B/s with: kilo[volume]: 1024 A sample config for squid: Target[proxy-hit]: cacheHttpHits&cacheProtoClientHttpRequests:public@proxy Title[proxy-hit]: HTTP Hits PageTop[proxy-hit]: <H2>proxy Cache Statistics: HTTP Hits / Requests</H2> Suppress[proxy-hit]: y LegendI[proxy-hit]: HTTP hits LegendO[proxy-hit]: HTTP requests Legend1[proxy-hit]: HTTP hits Legend2[proxy-hit]: HTTP requests YLegend[proxy-hit]: perminute ShortLegend[proxy-hit]: req/min Options[proxy-hit]: nopercent, perminute, dorelpercent Target[proxy-srvkbinout]: cacheServerInKb&cacheServerOutKb:public@proxy Title[proxy-srvkbinout]: Cache Server Traffic In / Out PageTop[proxy-srvkbinout]: <H2>Cache Statistics: Server traffic volume (In/Out) </H2> Suppress[proxy-srvkbinout]: y LegendI[proxy-srvkbinout]: Traffic In LegendO[proxy-srvkbinout]: Traffic Out Legend1[proxy-srvkbinout]: Traffic In Legend2[proxy-srvkbinout]: Traffic Out YLegend[proxy-srvkbinout]: per minute ShortLegend[proxy-srvkbinout]: b/min kMG[proxy-srvkbinout]: k,M,G,T kilo[proxy-srvkbinout]: 1024 Options[proxy-srvkbinout]: nopercent, perminute AUTHOR
Andreas Papst <andreas.papst@univie.ac.at> Dirk-Luder Kreie <deelkar@gmx.de> 2.16.2 2008-05-16 MRTG-SQUID(1)
Check Out this Related Man Page
ap-mrtg(8) System Manager's Manual ap-mrtg(8) NAME
ap-mrtg, ap-rrd - AP statistics translators SYNOPSIS
ap-mrtg -i ip -c community -t type [-b bssid ] [-v] [-r] [-h] ap-rrd -i ip -c community -t type -ddb_file [-b bssid ] [-r] [-h] DESCRIPTION
ap-mrtg get stats from AP and return it in MRTG parsable format. The Multi Router Traffic Grapher (MRTG) is a tool to monitor the traffic load on network-links. MRTG generates HTML pages containing graph- ical images which provide a LIVE visual representation of this traffic. You may get it from: http://peo- ple.ee.ethz.ch/~oetiker/webtools/mrtg/. ap-rrd gets stats from an AP and writes them to an RRDtool database. RRDtool is a data logging and graphing system for time series data. OPTIONS
-i ip AP ip address -c community SNMP community string -t type Statistics type <w>ireless, <e>thernet, associated <s>tations or <l>ink quality in client mode; -b bssid Mac address of the AP to which get link quality. -d db_file Name of the rrdtool database to write to. -v report MRTG about problems connecting to AP - if you want to get report about when AP spot work enable it -r reset AP when getting LinkQuality stats -h print help screen MRTG Configuration Example Simple mrtg.cfg for get stats from Atmel based AP: Target[ap_e]: `/usr/local/bin/ap-mrtg -i 192.168.0.1 -c "public" -t ethernet -v` Options[ap_e]: noinfo, growright, bits MaxBytes[ap_e]: 12500 Title[ap_e]: Traffic Analysis for AP Ethernet port PageTop[ap_e]: <H1>Traffic Analysis for AP Ethernet port</H1> Target[ap_w]: `/usr/local/bin/ap-mrtg -i 192.168.0.1 -c "public" -t wireless -v` Options[ap_w]: noinfo, growright, perminute ShortLegend[ap_w]: pkt/min MaxBytes[ap_w]: 100000000 Legend1[ap_w]: Packets In Legend2[ap_w]: Packets Out YLegend[ap_w]: packets/min Title[ap_w]: Traffic Analysis for AP Wireless port PageTop[ap_w]: <H1>Traffic Analysis for AP Wireless port</H1> Target[ap_s]: `/usr/local/bin/ap-mrtg -i 192.168.0.1 -c "public" -t stations -v` Options[ap_s]: growright, gauge, noinfo ShortLegend[ap_s]: stations MaxBytes[ap_s]: 10 YTics[ap_s]: 10 Legend2[ap_s]: none Legend1[ap_s]: Associated Stations YLegend[ap_s]: Associated Stations Title[ap_s]: Traffic Analysis for AP Associated Stations PageTop[ap_s]: <H1>Traffic Analysis for AP Associated Stations</H1> LegendO[ap_s]: none LegendI[ap_s]: Associated Stations Link Quality stats If the AP is not in client mode, it errors out. Grabbing the signal strength resets the ethernet and wireless stats and AP. It's safe do not use this type of stat. Optionally you may set mac address (bssid) of the AP to which getting link quality stats, by default used first returned AP. Simple mrtg.cfg for get stats from Atmel based AP with Link Quality and reset stats: Target[ap_e]: `/usr/local/bin/ap-mrtg -i 192.168.0.1 -c "public" -t ethernet -v` Options[ap_e]: noinfo, growright, bits, gauge MaxBytes[ap_e]: 12500 Title[ap_e]: Traffic Analysis for AP Ethernet port PageTop[ap_e]: <H1>Traffic Analysis for AP Ethernet port</H1> Target[ap_w]: `/usr/local/bin//ap-mrtg -i 192.168.0.1 -c "public" -t wireless -v` Options[ap_w]: noinfo, growright, perminute, gauge ShortLegend[ap_w]: pkt/min MaxBytes[ap_w]: 100000000 Legend1[ap_w]: Packets In Legend2[ap_w]: Packets Out YLegend[ap_w]: packets/min Title[ap_w]: Traffic Analysis for AP Wireless port PageTop[ap_w]: <H1>Traffic Analysis for AP Wireless port</H1> Target[EdAP_s]: `/usr/local/bin/ap-mrtg -i 192.168.0.1 -c "public" -t link -b FFFFFFFF -v -r` MaxBytes[EdAP_s]: 100 Options[EdAP_s]: noinfo,growright,integer,unknaszero,nopercent,gauge Title[EdAP_s]: Signal Analysis for EdAP Wireless port YLegend[EdAP_s]: Signal Strength dBm/Quality ShortLegend[EdAP_s]: dBm PageTop[EdAP_s]: <H1>Signal/Quality Strength for EdAP</H1> LegendI[EdAP_s]: Signal Quality LegendO[EdAP_s]: Signal Strength in dBm AUTHOR
Roman Festchook <roma@polesye.net> http://ap-utils.polesye.net SEE ALSO
ap-config(8), ap-trapd(8) Wireless Access Point Utilities for Unix ap-mrtg(8)