Megjegyzések:
WorkDir
A munkakönyvtárban (workdir) kell meghatározni, hová készítse az MRTG a naplófile-okat és a weblapokat.
példa:
WorkDir: /usr/tardis/pub/www/stats/mrtgOpcionális globális paraméterek:
Refresh
Hány másodpercenként kell a böngészõnek (Netscape) az oldalt újratöltenie? Ha ez nem definiált, az alapbeállítás 300 másodperc (5 perc).
példa:
Refresh: 600
Interval
Milyen gyakran futtassuk az MRTG-t? Az alapbeállítás 5 perc. Ha ritkábban futtatjuk, azt itt lehet beállítani. Ez két dolgot eredményez:
példa:
Interval: 10
WriteExpires
Ezzel a kapcsolóval az MRTG *.meta file-okat
fog generálni a CERN és Apache serverek részére,
melyek a HTML és GIF file-okról tartalmaznak Expiration tageket.
A *.meta file-ok ugyanabba a könyvtárba fognak készülni,
ahová a többi file, így lehetséges, hogy be kell
állítani a "MetaDir"-t az srm.conffile-ban, hogy ez mûködjön.
megjegyzés: ha Apache-1.2 fut, a mod_expire
használható ugyanerre a célra ... lásd: htaccess-dist
file.
példa:
WriteExpires: Yes
IconDir
Ha az MRTG-ikonokat máshol szeretnénk tárolni, mint a munkakönyvtár, használjuk az IconDir változót ennek beállítására.
példa:
IconDir: /mrtgicons/
Konfiguráció a monitorozandó
Targetek részére:
A konfigurációs Target kulcsszót egyéni névnek kell követnie. Ez lehet az a név, amit a weblapokhoz, logfile-okhoz és gifekhez használunk. A Target szekciót a cfgmaker eszközzel automatikusan el lehet készíttetni. Lásd: readme.html-t az ehhez kapcsolódó instrukciókhoz.
Target
A Target kulcsszóval tudjuk megmondani az MRTG-nek, hogy mit monitorozzon. A Target kulcsszónak különbözõ formátumú argumentumai vannak:
Target[ezwf]: 2:public@wellfleet-fddi.ethz.ch
Target[ezci]: -1:public@ezci-ether.ethz.ch
Target[ezwf]: 1.3.6.1.2.1.2.2.1.14.1&1.3.6.1.2.1.2.2.1.20.1:public@myrouter
Target[ezwf]: ifInErrors.1&ifOutErrors.1:public@myrouter
Target[ezwf]: /1.2.3.4:public@wellfleet-fddi.ethz.ch Target[ezci]: -/1.2.3.4:public@ezci-ether.ethz.ch Target[ezwf]: 1.3.6.1.2.1.2.2.1.14/1.2.3.4&/1.2.3.4:public@myrouter Target[ezwf]: ifInErrors/1.2.3.4&ifOutErrors/1.2.3.4:public@myrouter
ahol a paraméterek jelentése a következõ:
Target[ezci]: 1:public@ezci-ether.ethz.ch:9161::4Ez a ki/bemeneti oktett számlálókra fog vonatkozni, melyek 1 ifIndexû interface-szel rendelkeznek az ezci-ether.ethz.ch-n, mely a 9161-es UDP porton hallgató SNMP agent által ismert. A standard inicializáló timeout (2 másodperc) használt, de a próbálkozások száma 4-re van állítva.
Target[ezwf]: `/usr/local/bin/df2mrtg /dev/dsk/c0t2d0s0`Ügyeljünk arra, hogy a parancs elõtt és után aposztróf (') helyett visszaaposztrófot (`) használjunk.
Target[ezwf]: 2:public@wellfleetA + 1:public@wellfleetA * 4:public@ciscoFRouterUptime
Abban az esetben, amikor több interface-rõl szeretnénk kiszámítani a használt sávszélességet, általában nincs a router uptime és router név a weblapon megjelenítve. Ha ezek az interface-ek ugyanazon a routeren vannak és az uptime-ot és nevet meg kellene megjeleníteni, specifikálni kell még a community-jukat és a címüket újra a RouterUptime kulcsszóval.
példa:
Target[kacisco.comp.edu]: 1:public@194.64.66.250 + 2:public@194.64.66.250 RouterUptime[kacisco.comp.edu]: public@194.64.66.250MaxBytes
Az a maximális érték, amit a két figyelt változó (tipikusan a kimeneti és bemeneti byte-szám) elérheti. Router forgalom figyelésénél általában byte/second-ban specifikált az interface port által maximálisan szállítható adatmennyiség. Ha a MaxBytes-nál nagyobb értékû forgalmat érzékelne, azzal nem foglalkozik. További információkhoz az AbsMax szekciót is olvassuk el. A MaxBytes érték használt még a skálázatlan grafikonok (lásd Unscaled szekció) Y tengelyének kiszámításához is. Mivel a legtöbb link bit/second beosztású, szükséges a maximális sávszélesség (bitekben) osztása 8-cal, hogy megkapjuk a byte/second osztást. Nagyon fontos, hogy a skálázatlan grafikonok valóságos információt mutassanak. T1 = 193.000, 56K = 7.000, Ethernet = 1.250.000. A MaxBytes értéket az MRTG arra használja, hogy eldöntse a routertõl kapott érték érvényes-e. Ha két különbözõ MaxBytes értékre van szükség, használhatjuk a MaxBytes1 és MaxBytes2 értékeket a MaxBytes helyett.
példa:
MaxBytes[ezwf]: 1250000
MaxBytes1
Ugyanaz, mint MaxBytes, csak az 1-es változóra vonatkozik.
MaxBytes2
Ugyanaz, mint MaxBytes, csak a 2-es változóra vonatkozik.
Title
A HTML lap címe, amit a generált grafikonokhoz kapunk.
példa:
Title[ezwf]: Traffic Analysis for Our Nice Company
PageTop
Olyan dolgokat lehet itt megadni, amelyeket a generált HTML felsõ részéhez akarunk hozzáadni. Több soros szöveget is használhatunk, csak arra kell ügyelni, hogy az elsõ karakter space legyen. Figyeljünk arra, hogy a HTML oldalban ezek a sorok ugyanabban a sorban lesznek. Ha szeretnénk sortöréseket is beiktatni, használjuk a "\n" szekvenciát.
példa:
PageTop[ezwf]: <H1>Traffic Analysis for ETZ C95.1</H1> Our Campus Backbone runs over an FDDI line\n with a maximum transfer rate of 12.5 megabytes per second.
Opcionális Target konfigurációs
tagek:
AddHead
Használjuk ezt a taget úgy, mint a PageTop fejlécet, de ennek a tartalma hozzá fog adódni a </TITLE> és </HEAD> közötti részhez.
példa:
AddHead[ezwf]: <link rev="made" href="[40]mailto:mrtg@blabla.edu";>
AbsMax
Akkor használjuk, amikor olyan linket figyelünk, amely több forgalmat tud kezelni, mint a MaxBytes érték. Pl. olyan vonal, amely tömörítést vagy valamilyen frame relay linket használ, ekkor használjuk az AbsMax kulcsszót, hogy az abszolút maximális elérhetõ értéket megadjuk. Ezt azért szükséges tudnunk, hogy kiszûrjük a routerek által visszaadott valótlan értékeket. Ha nem állítjuk be az AbsMax-ot a rateup nem foglalkozik a MaxBytes-nál nagyobb értékekkel.
példa:
AbsMax[ezwf]: 2500000
Unscaled
Alapból minden grafikon függõlegesen skálázott, hogy az aktuális adatokat láthassuk, még ha jóval alacsonyabb is a forgalom, mint a MaxBytes. Az Unscaled változóval eltûntethetjük ezt. Ennek az argumentuma egy string, amely egy betût tartalmazhat minden grafikonról, amelyet nem akarunk skálázni: d = day (napi), w = week (heti), m = month (havi), y = year (éves). A mintában az éves és havi grafikonok skálázását tûntettük el.
példa:
Unscaled[ezwf]: ym
WithPeak
Alapból a grafikonok a monitorozott változóknak csak az átlagos értékét tartalmazzák - általában a bejövõ és kimenõ forgalom mértékét. A következõ opció az MRTG-t arra utasítja, hogy megjelenítse az 5 perces csúcsértékeket a heti (w), havi (m) és éves (y) grafikonokon. A mintában a havi és az éves grafikonhoz definiáltuk azt, hogy az átlagos értékek mellett a csúcsokat is tartalmazza.
példa:
WithPeak[ezwf]: ym
Suppress
Alapból az MRTG 4 grafikont készít. Ezzel az opcióval elnyomhatjuk kiválasztott grafikonok készítését. A szintaxis a fenti két opcióval analóg. A példában az éves grafikont tüntetjük el.
példa:
Suppress[ezwf]: y
Directory
Alapból az MRTG minden targethez generált file-t (GIF-eket, HTML lapokat, naplófile-okat stb.) a WorkDir-ben tárol. Ha Directory opció specifikált, a file-okat egy WordDir alatti könyvtárba teszi. (pl. a Directory opció minden file-t, ami az ezwf targethez tartozik berakja a /usr/tardis/pub/www/stats/mrtg/ezwf/ könyvtárba) A könyvtárnak már léteznie kell, az MRTG ezt nem hozza létre.
példa:
WorkDir: /usr/tardis/pub/www/stats/mrtg Directory[ezwf]: ezwf
XSize és YSize
Alapból az MRTG-grafikonok 100x400 pixel szélesek
(plusz egy kevés a címkéknek). A példában
majdnem négyzet alakú grafikonokat kapunk....
Ügyeljünk arra, hogy az XSize 20 és
600 között legyen; az YSize pedig nagyobb legyen, mint 20.
példa:
XSize[ezwf]: 300 YSize[ezwf]: 300
XZoom és YZoom
Ha a grafikonban nagyobb pixeleket szeretnénk használni, "Zoomoljunk" rájuk.
példa:
XZoom[ezwf]: 2.0 YZoom[ezwf]: 2.0
XScale és YScale
Ha ténylegesen szeretnénk skálázni a grafikonokat, használjuk az XScale-t és az YScale-t. (Az eredmény furcsán néz ki.... Ha valaki szeretne patchet írni rá, megteheti...)
példa:
XScale[ezwf]: 1.5 YScale[ezwf]: 1.5
Step
Megváltoztatja az alapbeosztást 5*60
másodpercrõl valami másra. (Ez sem tesztelt...)
példa:
Step[ezwf]: 60
Options
Az Options kulcsszó néhány boolean kapcsoló beállítását teszi lehetõvé.
growright
Alapból a grafikonok
balra haladnak. Ez az opció megfordítja a haladási
irányt, így az aktuális idõ a jobb szélén
lesz a grafikonnak, a régebbi adatok pedig a bal oldalán.
bits
Minden monitorozott változó
értékét megszorozza 8-cal. (Tehát byte helyett
bitben mutatja azokat.) Ez hatással van a "gyárilag beállított"
címkékre és egységekre is.
perminute
Minden monitorozott változó
értékét megszorozza 60-nal. (Tehát egység
per percben mutatja azokat egység per másodperc helyett.)
Így kis értékek esetén pontosabb grafikonokat
készít. Ez hatással van a "gyárilag beállított"
címkékre és egységekre is.
perhour
Minden monitorozott változó
értékét megszorozza 3600-zal. (Tehát egység
per órában mutatja azokat egység per másodperc
helyett.) Így kis értékek esetén pontosabb
grafikonokat készít. Ez hatással van a "gyárilag
beállított" címkékre és egységekre
is.
noinfo
Elnyomja az információt
az uptime-ról és az eszköz nevérõl a generált
weblapon.
nopercent
Nem jeleníti meg
a százalékos kihasználtságot.
transparent
A generált GIF-eknek
átlátszó hátteret készít.
integer
A grafikonok alatti összesítéseket
egészként jeleníti meg, vesszõ nélkül.
dorelpercent
A BEmenõ forgalomnak
a KImenõhöz viszonyított relatív százalélát
is kiszámolja és megjeleníti egy újabb sorban.
Megjegyzés: Csak egy fix skála használható
(0-100 %-ig). Ezért, ha a BEmenõ forgalom nagyobb, mint a
KImenõ, akkor is csak 100 %-ot jelez ki. Ha a BEmenõ forgalom
nem mindig kisebb vagy egyenlõ, mint a KImenõ, nem javasolt
a használata ennek az opciónak. Megjegyzés: Ha ezt
az opciót kombináljuk a Colours opcióval, egy ötödik
értékpár szükséges ott.
gauge
A targetrõl összegyûjtött
értékeket abszolútként kezeli. Ez hasznos lehet
olyan dolgok monitorozásánál, mint például
lemez terület, processzor használat, hõmérséklet
stb. A "gauge" és "absolute" opciók hiányában,
az MRTG a változókat úgy tekinti, mint egy számlálót
és kiszámítja a különbséget az aktuális
és az elõzõ érték között,
majd elosztja a két beolvasási idõ közötti
különbséggel, hogy az értéket megkapja.
absolute
Ez olyan adatforrásokhoz
van, amelyek resetelik az értéküket kiolvasáskor.
Ez azt jelenti, hogy a rateupnak nem kell kiszámítania
a különbséget az adatforrás mostani és
az utolsó kiolvasása között. A megkapott érték
még el lesz osztva az utolsó 2 kiolvasás között
eltelt idõvel, ez okozza a különbséget a "gauge"opcióhoz
képest.
példa:
Options[ezwf]: growright, bits
kilo
Ez az opció a prefixumok szorzóértékének megváltoztatásához használható. Az alapérték 1000. A példa a speciális esetre vonatkozik, mikor 1 kB = 1024B, 1 MB = 1024 kB stb.
példa:
kilo[ezwf]: 1024
kMG
Megváltoztatja az alap szorzóprefixumokat (,k,M,G,T,P). A példában a ShortLegend csak egy egységet definiál. Formátum: Vesszõvel elválasztott prefixumlista. Két egymás utáni vesszõ vagy egy vesszõ a sor elején vagy végén, a tételnek nem ad prefixumot. Megjegyzés: Ha nem akarunk prefixumokat, hagyjuk üresen a sort.
példa:
a nm/s-ben (nanométer/second) adott sebesség nm/h-ban kijelezve
ShortLegend[ezwf]: m/min kMG[ezwf]: n,u,m,,k,M,G,T,P Options[ezwf]: perhour
Colours
A Colours tag segítségével az alap színsémákat írhatjuk felül. Megjegyzés: Mind a 4 szükséges színt meg kell adni itt. A szín nevét ("Colorx") fogja feliratként megjeleníteni, míg az RGB érték az igazi szín, amit a megjelenítéshez használ, mind a grafikonon, mind a HTML dokumentumban.
Formátum: Colour1#RRGGBB,Colour2#RRGGBB,Colour3#RRGGBB,Colour4#RRGGBB
Fontos: Ha használjuk a dorelpercent opciót,
egy ötödik szín név szín érték
pár szükséges:
Colour1#RRGGBB,Colour2#RRGGBB,Colour3#RRGGBB,Colour4#RRGGBB,Colour5#RRGGBB
Colour1
Elsõ változó
(általában bemenet) az alap grafikonon.
Colour2
Második változó
(általában kimenet) az alap grafikonon.
Colour3
Elsõ változó
maximuma (bemenet).
Colour4
Második változó
maximuma (kimenet).
RRGGBB
2 digites hexa érték
a pirosnak (RR), zöldnek (GG) és kéknek (BB).
példa:
Colours[ezwf]: GREEN#00eb0c,BLUE#1000ff,DARK GREEN#006600,VIOLET#ff00ff
Background
A Background taggel a generált HTML oldal háttérszínét tudjuk bekonfigurálni.
példa:
Background[ezwf]: #0a0a0a
YLegend,ShortLegend,Legend[1234]
A következõ kulcsszók lehetõvé teszik, hogy felülírjuk a grafikon és a HTML dokumentum különbözõ feliratainak megjelenített szövegét.
YLegend
Az Y-tengely címkéje
a grafikonnak. Ügyeljünk arra, hogy a túl hosszú
szöveg, mely nem fér ki a grafikonon, nem lesz megjelenítve.
ShortLegend
Az egység string
(alapból "b/s"), amit Max, Average és Current értékekhez
használ.
Legend[1234IO]
A szín felirat stringjei.
példa:
YLegend[ezwf]: Bits per Second ShortLegend[ezwf]: b/s Legend1[ezwf]: Incoming Traffic in Bits per Second Legend2[ezwf]: Outgoing Traffic in Bits per Second Legend3[ezwf]: Maximal 5 Minute Incoming Traffic Legend4[ezwf]: Maximal 5 Minute Outgoing Traffic LegendI[ezwf]: In: LegendO[ezwf]: Out:
Ügyeljünk arra, hogy ha a LegendI vagy
a LegendO egy üres stringnek van beállítva a:
LegendO[ezwf]:
segítségével, a megfelelõ
vonal a grafikon alatt nem lesz egyáltalán kinyomtatva.
Timezone
Ha egy nemzetközi világban élünk, elõfordulhat, hogy a grafikonokat különbözõ idõzónákba szeretnénk generálni. Ez a TZ változóban van beállítva. Bizonyos operációs rendszerek alatt, mint például a Solaris, ez azt fogja okozni, hogy a helyi idõt is a kiválasztott idõzónának megfelelõen fogjuk megkapni....
példa:
Timezone[ezwf]: JapanA Timezone a standard Solaris idõzóna, pl.: Japan, Hongkong, GMT, GMT+1 stb.
Weekformat
Alapból az MRTG (pontosabban a rateup) az strftime(3) '%W' opciót használja a hét számainak formázásához a havi grafikonon. Az egzakt szemantikája ennek a formátum opciónak eltérõ a rendszerek között. Ha úgy találjuk, hogy a hét száma rossz, és a rendszer strftime(3) rutinja támogatja, használhatunk másik formátumot. A POSIX '%V' szélesen alkalmazott hét számozási konvenciónak tûnik. A hét formátum karaktert egy betûvel kell specifikálni: W, V vagy U lehet.
példa:
Weekformat[ezwf]: V
Két nagyon speciális Target
név:
Azért, hogy némi gépelést megspóroljunk, definiálhatunk egy "^"-nek nevezett targetet. Ehhez a targethez definiált valamennyi kulcsszó szövege, a megfelelõ kulcsszó ELÉ lesz fûzve minden olyan targetnél, melyet ezen sor után definiálunk. Hasonló a helyzet a "$" targetnél, de itt a szöveg UTÁNA lesz fûzve.
Ügyeljünk arra, hogy egy space lesz beszúrva a kulcsszó érték és az elé fûzött szöveg közé, valamint a kulcsszó érték és az utána fûzött szöveg közé is. Ez jól mûködik szöveg értékû kulcsszavaknál, de nem nagyon hasznos más kulcsszavak esetében. Lásd "alap" target leírást lejjebb.
A példa az MRTG-t arra utasítja, hogy egy közös fejlécet használjon és egy közös kontakt személyt minden olyan lapnál, melyek késõbb definiált targetekrõl fognak készülni.
példa:
PageTop[^]: <H1>NoWhere Unis Traffic Stats</H1><HR> PageTop[$]: Contact Peter Norton if you have any questions<HR>
Az elõ/utó értékek
eltávolításához specifikáljunk egy üres
értéket, pl.:
PageTop[^] PageTop[$]
Még egy nagyon speciális
Target név:
A "_" target név egy alapértéket ad meg a kulcsszónak. Az explicit kulcsérték, az elõ- illetve utókulcsérték hiányában az alapérték lesz használatos.
példa:
YSize[_]: 150 Options[_]: growright,bits,nopercent WithPeak[_]: ymw Suppress[_]: y MaxBytes[_]: 1250000
Az alapérték eltávolításához
és a "gyári alapérték" visszaállításához
specifikáljunk egy üres értéket, pl.:
YLegend[_]:
Több alap/elõ/utóérték
beállítás is lehet egy konfig file-ban. A késõbbi
beállítások felülírják az elõzõeket
a konfigurációs file további részében.
Azok az alap/elõ/utóértékek, melyeket egy kulcsszó/target
párhoz használunk az egyetlenek, melyeknek akkor lesz hatásuk,
mikor a target elõször lesz említve a konfig file-ban.
példa:
MaxBytes[_]: 1250000 Target[myrouter.somplace.edu.2]: 2:public@myrouter.somplace.edu MaxBytes[_]: 8000 Title[myrouter.somplace.edu.2]: Traffic Analysis for myrouter.somplace.edu
A myrouter.somplace.edu.2 targetnél a
fenti példában az alap MaxBytes 1250000 lesz, amelynek onnantól
van hatása, ahol a target neve, a myrouter.somplace.edu.2 elõször
tûnik fel a konfig file-ban.
Néhány példa mrtg.cfg file:
Minimális mrtg.cfg
WorkDir: /usr/tardis/pub/www/stats/mrtg Target[r1]: 2:public@myrouter.somplace.edu MaxBytes[r1]: 64000 Title[r1]: Traffic Analysis ISDN PageTop[r1]: <H1>Stats for our ISDN Line</H1>
Cfg több router részére:
WorkDir: /usr/tardis/pub/www/stats/mrtg Title[^]: Traffic Analysis for PageTop[^]: <H1>Stats for PageTop[$]: Contact The Chief if you notice anybody<HR> MaxBytes[_]: 64000 Options[_]: growright Title[isdn]: our ISDN Line PageTop[isdn]: our ISDN Line</H1> Target[isdn]: 2:public@router.somplace.edu Title[backb]: our Campus Backbone PageTop[backb]: our Campus Backbone</H1> Target[backb]: 1:public@router.somplace.edu MaxBytes[backb]: 1250000 # a következõ sor eltávolítja az alap elõértéket # amit fentebb definiáltunk Title[^]: Title[isdn2]: Traffic for the Backup ISDN Line PageTop[isdn2]: our ISDN Line</H1> Target[isdn2]: 3:public@router.somplace.eduVissza az MRTG-hez.