1MRTG-SQUID(1)                        mrtg                        MRTG-SQUID(1)
2
3
4

NAME

6       mrtg-squid - using mrtg to monitor Squid
7

DESCRIPTION

9       Squid 2.3 knows SNMP and you can therefore use mrtg to monitor it quite
10       easily.
11
12       I have made some modifications to mrtg which simplify this.  My work is
13       based on earlier modification made by: matija.grabnar@arnes.si and
14       kostas@nlanr.net.
15

MODIFICATIONS

17       I added new code for displaying correct units to the previous patches
18       "perminute" and "perhour" ("option" tokens), which allows other
19       measurement in addition to "persecond".
20
21       Then I created a new option token "dorelpercent" which allows the
22       calculation of the percentage of IN-stream / OUT-stream on the fly and
23       then displays it on a fixed scale from 0% to 100%. For my requirements,
24       this does good work. Maybe someone wants a floating scale. It should
25       not be a problem to implement it, too (but give me an option to keep my
26       fixed scale). If IN-stream is always less than OUT-stream both lines
27       (OUT-stream and relative percent) are always displayed on top of IN-
28       stream bulk. Otherwise this option makes no sense. With this option you
29       can display hitrates, errorrates (for router monitoring: rel.
30       droprates) easily now.
31
32       If you use this options please consider that you need a 5th
33       colourname/value pair in your Colours statements!
34
35       Due to some discussion on this list, I have implemented two tokens too:
36
37       "kilo" and "kMG"
38
39       "kilo" should contain the value of k (1000 or 1024), where 1000 is the
40       default.
41
42       "kMG" is a comma separated list of multiplier prefixes, used instead of
43       "", "k", "M", "G", "T" on the MRTG display. Leave the place free, if
44       you want no prefix.
45
46       Also an incomplete list of OIDs for the new SQUID release is added.
47
48       I hope you enjoy it.
49

CONFIG EXAMPLE

51       You can measure responsetimes in ms and display it with MRTG correctly
52       with:
53
54        kMG[measure-ms]: m,,k,M,G,T
55        short[measure-ms]: s
56
57       You can display now MB/s as 1024*1024 B/s with:
58
59        kilo[volume]: 1024
60
61       A sample config for squid:
62
63        Target[proxy-hit]: cacheHttpHits&cacheProtoClientHttpRequests:public@proxy
64        Title[proxy-hit]: HTTP Hits
65        PageTop[proxy-hit]: <H2>proxy Cache Statistics: HTTP Hits / Requests</H2>
66        Suppress[proxy-hit]: y
67        LegendI[proxy-hit]:  HTTP hits
68        LegendO[proxy-hit]:  HTTP requests
69        Legend1[proxy-hit]:  HTTP hits
70        Legend2[proxy-hit]:  HTTP requests
71        YLegend[proxy-hit]: perminute
72        ShortLegend[proxy-hit]: req/min
73        Options[proxy-hit]: nopercent, perminute, dorelpercent
74
75        Target[proxy-srvkbinout]: cacheServerInKb&cacheServerOutKb:public@proxy
76        Title[proxy-srvkbinout]: Cache Server Traffic In / Out
77        PageTop[proxy-srvkbinout]: <H2>Cache Statistics: Server traffic volume (In/Out) </H2>
78        Suppress[proxy-srvkbinout]: y
79        LegendI[proxy-srvkbinout]:  Traffic In
80        LegendO[proxy-srvkbinout]:  Traffic Out
81        Legend1[proxy-srvkbinout]:  Traffic In
82        Legend2[proxy-srvkbinout]:  Traffic Out
83        YLegend[proxy-srvkbinout]: per minute
84        ShortLegend[proxy-srvkbinout]: b/min
85        kMG[proxy-srvkbinout]: k,M,G,T
86        kilo[proxy-srvkbinout]: 1024
87        Options[proxy-srvkbinout]: nopercent, perminute
88

AUTHOR

90       Andreas Papst <andreas.papst@univie.ac.at> Dirk-Lueder Kreie
91       <deelkar@gmx.de>
92
93
94
952.16.4                            2010-05-17                     MRTG-SQUID(1)
Impressum