MRTG官方配置手冊 (翻譯完畢)

ioerr

原文在我的博客里面http://hi.baidu.com/ioerr/blog/item/0000ee24c5332a064c088d86.html.（博客已經(jīng)沒了，被百度廢了2015.1.16）
難免錯誤,估計還不少,大家共同訂正吧.
本來打算年前搞定，一直沒有抽出時間，剛上班，還沒有忙起來，趕緊弄完，就算給大家送份遲到的新年禮物吧。

雖然mrtg功能簡單些，但是還是那句話，對于要求不高的用戶足夠了，配置簡單，不像cacti，感覺配置比較復(fù)雜了。只要你好好看看手冊，很多的功能mrtg也是有的，就是先天原因吧，有的實現(xiàn)起來似乎麻煩點。

最后給大家拜個晚年。

MRTG2.16.2配置參考手冊

MRTG運行時的行為是由一個配置文件控制的。這個配置文件可以用cfgmaker生成。（請參考cfgmaker的手冊）。但是更加詳細精巧的配置還是需要手工進行的。
這篇文檔介紹了mrtg使用的所有配置選項。
語法
MRTG配置文件語法遵循一些簡單的規(guī)則：
l  管檢測必須在一行的開頭。
l  在一個關(guān)鍵詞行之后的以空格開頭的每一行都是關(guān)鍵詞行的后繼行。
l  空行被忽略。
l  以#開頭的行是注釋行。
l  你可以使用Include: file的形式把其它的文件導(dǎo)入配置文件。
例子：include: base-option.inc
如果被包含的文件被相對路徑指定，包括當前目錄和包含主配置文件的目錄都會被搜索。
全局配置關(guān)鍵詞
WorkDir
WorkDir 指定日志文件和網(wǎng)頁文件的生成文件。
例子：
WorkDir: /usr/tardis/pub/www/stats/mrtg
可選全局關(guān)鍵詞
HtmlDir
HtmlDir指定html（或者shtml，這個會在以后被支持）生成的位置。
注意：WorkDir會覆蓋htmldir和imagedir、logdir的設(shè)置。
例子：
Htmldir：/www/mrtg/
ImageDir
ImageDir 指定存放生成的圖片的文件夾。這個文件夾應(yīng)該設(shè)置在html文件夾內(nèi)。
例子：
Imagedir：/www/mrtg/images

LogDir
LogDir 指定存放日志的文件夾.這不必放在htmldir文件夾內(nèi).
例子:
Logdir：/www/mrtg/logs
Forks( UNIX only)
在支持Fork的系統(tǒng)之中（例如UNIX）,當mrtg需要通過snmp獲取數(shù)據(jù)的時候，它能fork自己成為多個實例。
在高延遲或者存在大量設(shè)備的情況下，這能極大的提高效率。如果你的那臺交換機就在隔壁，那它可能不會提高你的查詢速度。
據(jù)我所知，NT不能fork，所以這項功能在NT中不能使用。
例子：
forks：4

EnableIPv6
當把值設(shè)置為yes時，如果相應(yīng)的庫文件存在（請參考mrtg-ipv6手冊頁），那么IPv6就可以啟用
了。這樣IPv6功能就啟用了，mrtg就能夠和基于IPv6的路由器及其它對象的snmp進行通訊，它們
可能使用了IPv6來指定地址。
如果IPv6被啟用并且對象是一個主機名，mrtg將嘗試解析主機名為IPv6地址，并且如果失敗了，
再解析為IPv4地址。注意如果指定了IPv4地址或者設(shè)置了主機名，但是沒有設(shè)置IPv6地址，mrtg
將僅使用IPv4；mrtg如果使用IPv6通訊失敗，將不會使用IPv4。這是設(shè)計中實現(xiàn)的。
注意現(xiàn)在許多的路由器沒有支持基于IPv6的SNMP。這些路由器將使用IPv4Only選項。
IPv6默認是關(guān)閉的。
例子：
EnableIpv6：yes

------------------------
EnableSnmpV3
當這一項參數(shù)化設(shè)置為yes的時候，將使用Net::SNMP模塊替代SNMP_SESSION模塊來生成snmp請求
。如果snmpv3參數(shù)被設(shè)置了，這將允許使用SNMPv3。
SNMPv3默認是關(guān)閉的。
例子：
EnableSnmpV3：yes

--------------------------
Refresh
瀏覽器應(yīng)該多長時間重新加載頁面？如果沒有指定的話，默認使300秒（5分鐘）。
例子：
Refresh:600

---------------------------
Interval
你多長時間調(diào)用一次mrtg呢？默認是5分鐘。如果頻率比較低的話，你應(yīng)該在這里指定。這將完成
兩個任務(wù)：
生成的HTML頁面包含正確的關(guān)于間隔的信息...
在生成的HTML頁面中包含正確的META設(shè)置...
下面的例子我們讓mrtg每10分鐘運行一次。如果你讓mrtg每5分鐘運行一次，你可以注釋掉這一行。
例子：
Interval：10
注意：除非你使用rrdtool，你不要把間隔設(shè)置的小于5分鐘。如果你使用rrdtool，你可以用這樣
的格式來設(shè)置時間間隔
Interval:MM[SS]
甚至可以設(shè)置間隔為1秒。然而還是要注意，間隔的設(shè)置會影響rrdtool和mrtg對于數(shù)據(jù)庫的初始
化。如果以后你改變了間隔的設(shè)置，所有已經(jīng)存在的數(shù)據(jù)庫將保持初始化時候的解析度。也要注
意你的mrtg-rrd的 web前端是否支持這種設(shè)置。


------------------------------
MaxAge
MRTG非常的以來計算機的時間。如果時間設(shè)置有錯誤，特別是比當前時間快很多，會引起mrtg把日志文件中的數(shù)據(jù)當成過期數(shù)據(jù)來處理。
為了避免這樣的情況發(fā)生，你可以對日志文件指定最大容忍時間來進行“合理性檢查”，如果文件看上去很老了，mrtg先不會操作這個文件，而是發(fā)出抱怨（警告），給你一個機會來檢查原因。
例子：
MaxAge:7200
上面的例子中mrtg將不會更新過期兩小時的數(shù)據(jù)（7200秒）。
-----------------------------
WriteExpires
這個選項將使得mrtg為CERN和Apache（其中包含Expirations標簽的）生成.meta文件。這些*.meta文件將會在與其它文件相同的目錄里面創(chuàng)建，為了能夠保證它正常運行，你將需要在Apache.conf或者.htaccess文件設(shè)置“MetaDir.”和“MetaFiles on”。
注意：如果你運行的是Apache-1.2或者更新版本，你能夠使用mod_expire來達到同樣的效果...請參考htaccess.txt。
例子：
WriteExpires:yes
-----------------------
NoMib2
正常情況下我們會查詢設(shè)備的“sysUptime”（運行時間）和“sysName”（系統(tǒng)名稱）。但是一些設(shè)備沒有這些信息。如果你想避免mrtg生成相關(guān)警告，請設(shè)置nomib2選項。
一個不提供基本的mib2屬性信息的例子是 Computer Associates - Unicenter TNG 代理。CA 除了使用它自己的代理外還依賴OS的SNMP代理來提供系統(tǒng)管理功能。
例子：
NoMib：yes

-----------------------
SingleRequest
一些SNMP實現(xiàn)不能支持一次查詢多個snmp變量。設(shè)置這個參數(shù)可以強迫mrtg每次只查詢一個變量。
例子：
SingleRequest：yes


----------------------
SnmpOptions
除了每個監(jiān)控對象的超時選項可設(shè)置外，你還能夠更詳細的配置snmpget操作。目前支持以下的選項：
timeout                   => $default_timeout,
retries                   => $default_retries,
backoff                   => $default_backoff,
default_max_repetitions   => $max_repetitions,
use_16bit_request_ids     => 1,
lenient_source_port_matching => 0,
lenient_source_address_matching => 1
選項后面的值是默認值。注意這些設(shè)置會覆蓋每個監(jiān)控對象的超時設(shè)置。
每個監(jiān)控對象的SnmpOptions[]將會覆蓋全局設(shè)置.這個關(guān)鍵詞主要是為了在SNMPv3中使用.
16bit的請求id是對SMC堡壘路由器進行請求查詢的唯一方法.
例子:
SnmpOptions: retries => 2, only_ip_address_matching => 0
注意AS/400的snmp似乎不太配合mrtg,除非這樣設(shè)置:
SnmpOptions: lenient_source_port_matching => 1
--------------------
IconDir
如果你想把mrtg的圖標保存在某個文件夾中,既不是工作目錄,也不是imageDir,那么使用這個選項來定義icon的目錄.
例子:
IconDir: /mrtgicons/
--------------------
LoadMIBs
加載指定的MIB文件并讓其中的OID可以用字符名字引用.為了獲得更好的效率,mrtg在WorkDir中維護一個MIB緩存.
例子:
LoadMIBs: /dept/net/mibs/netapp.mib,/usr/local/lib/ft100m.mib
------------------------
Language
使用這個選項來產(chǎn)生指定語言的結(jié)果(檢查翻譯目錄來查看你的mrtg支持多少種語言.在這個目錄中你還能找到一些說明
,關(guān)于怎樣支持新的語言.)
目前支持下面幾種語言:
big5  brazilian bulgarian catalan chinese croatian czech danish dutch eucjp french galician gb gb2312
german greek hungarian icelandic indonesia iso2022jp italian korean lithuanian malay norwegian polish
portuguese romanian russian russian1251 serbian slovak slovenian spanish swedish turkish ukrainian
例子:
Language:danish
---------------------------
LogFormat
設(shè)置這個選項的值為rrdtool就啟用了rrdtool模式.在這種模式中,mrtg依靠rrdtool來做日志.請參考mrtg-rrd.
例子:
LogFormat:rrdtool
----------------------------
LibAdd
如果你使用了rrdtool模式并且你的rrdtool的perl模塊(RRDs.pm)不能被perl自身找到,你可以使用這個選項來提供相應(yīng)
的路徑.
例子:
LibAdd: /usr/local/rrdtool/lib/perl/
-----------------------------
PathAdd
如果rrdtool的可執(zhí)行部分在正常的"ATH"中不能被找到,你可以使用這個關(guān)鍵詞來給你的PATH增加一個適合的目錄.
例子:
PathAdd: /usr/local/rrdtool/bin/


-----------------------
RunAsDaemon
這個參數(shù)啟用daemon模式來運行mrtg。守護模式就是指MRTG只運行一次，而不是反復(fù)的運行（因為它是使用cron運行的
。）這會節(jié)省計算資源的，因為只在開始的時候?qū)ε渲梦募�進行一次加載和分析。
使用daemon模式，MRTG自己對時間間隔進行控制。因此為“interval”選項設(shè)置一個合適的值是很重要的。
如果你想讓mrtg以某個特定的用戶和組來運行（不推薦使用root身份運行mrtg），那么在命令行運行mrtg時請使用--
user和--group參數(shù)。
例子：
mrtg --user=mrtg_user --group=mrtg_group mrtg.cfg
也要注意：在daemon模式中，當配置文件改變時，為了使改變生效，重啟進程是必要的。
在UNIX中，Daemon參數(shù)讓mrtg在檢查過配置文件后就進入后臺運行。在WindowsNT中，MRTG進程將脫離控制臺運行，但是
因為NT/2000的shel會等待子進程結(jié)束，所以你需要使用下面的命令來運行：
start /b perl mrtg mrtg.cfg
你可能需要注意修改路徑信息。
例子：
RunAsDaemon: Yes
Interval:    5
If you are daemontools and still want to run mrtg as a daemon you can additionally specify
NoDetach:yes
這將使得mrtg不脫離終端運行.
------------------
ConversionCode
一些設(shè)備可能會生成非數(shù)字的值,但這些值如果能被轉(zhuǎn)換成數(shù)字,對于MRTG的圖像生成還是有用的.這個關(guān)鍵字指定了一個進行轉(zhuǎn)換操作的Perl文件的路徑.在這個文件中包含一個或者多個Perl的子程序.每個子程序都必須接收一個single string變量并返回一個single numeric值.當使用RRDtool的時候,會返回一個decemal值.當某一個子程序的名字在后面的監(jiān)控目標中指定的時候(參看后面內(nèi)容),MRTG將會為這個監(jiān)控目標調(diào)用它兩次,一次是轉(zhuǎn)換輸入值,一次轉(zhuǎn)換輸出值.當轉(zhuǎn)換失敗的時候,子程序必須返回一個undefine值.如果出現(xiàn)失敗,在MRTG的日志文件中將會用Perl的警告函數(shù)寫入一個警告.MRTG將會把子程序?qū)�入一個隔離的名稱空間(package MRTGConversion),這樣用戶就不必擔心會影響到MRTG的全局名字空間了。MRTG automatically prepends this package declaration to the user-supplied code.
例子：
假設(shè)某個OID返回一個字符串，它的長度對于被監(jiān)控的值來說是適當?shù)�。為了把字符串轉(zhuǎn)換成一個數(shù)字，MRTG可以用來繪制圖形，我們創(chuàng)建一個文件“MyConversions.pl”，內(nèi)容如下：
# Return the length of the string argument
sub Length2Int {
   my $value = shift;
   return length( $value );
}
然后在MRTG的配置文件中加入下面的內(nèi)容（假設(shè)轉(zhuǎn)換代碼的文件在MRTG/bin目錄中）：
ConversionCode: MyConversions.pl
這將使得MRTG把我們定義的Length2Int子程序包含進自己的執(zhí)行環(huán)境中。Length2Int將能夠被在任何監(jiān)控目標上被調(diào)用，只是需要像下面一樣把“|Length2Int”加到監(jiān)控目標定義中：
Target[myrouter]: 1.3.6.1.4.1.999.1&1.3.6.1.4.1.999.1:public@mydevice|Length2Int
看下面的“Extended Host Name Syntax”來獲取完整的關(guān)于定義“監(jiān)控目標”的語法信息。


-----------------
2008.12.24
-----------------
Target
使用這個關(guān)鍵詞你高速mrtg監(jiān)控的目標是什么。它能夠以很多種形式進行定義。
------------------
基本形式（Basic）
最基本的格式為“port:community@router”，這將為主機‘router’（dns名稱或者IP地址）的‘port’接口生成一個通訊
流量圖，并且使用‘community’作為snmp查詢的口令。
例子：
Target[myrouter]: 2:public@wellfleet-fddi.domain
如果你的community包含[email=‘@’]‘@’[/email]或者空格，這些字符必須被使用‘\’進行轉(zhuǎn)義.
例子:
Target[bla]: 2:stu\ pi\@d@router
-----------------------
SNMPv2c
如果你使用一個高速的路由器你可能想要使用ifHC*計數(shù)器.這個特性由SNMPv2c參數(shù)啟用.然而不幸的是,并非所有的設(shè)備都支
持SNMPV2C.這個參數(shù)將使得你的計數(shù)器不會在5分鐘內(nèi)就被重置,因為我們使用了64位計數(shù)器代替了原來的32位計數(shù)器.
例子:
Target[myrouter]: 2:public@router1:::::2
------------------------
SNMPv3
作為SNMPV2C的替代,SNMPv3提供了對ifHC*計數(shù)器的訪問功能,并具備了加密功能.不是所有的設(shè)備都支持SNMPv3,你還需要
perl的Net::SNMP庫來支持SNMPv3.涉及SNMPv3的配置建議使用cfgmaker,因為它會檢查Net::SNMP庫文件是否被加載,并且在不
能使用v3的時候會使用SNMPv2c.
--------------------------
SNMP v3 需要使用認證參數(shù),使用SnmpOptions[]來傳遞.
Example: Target[myrouter]: 2:router1:::::3 SnmpOptions[myrouter]: username=>'user1'
--------------------------
noHC
不是所有支持SNMPv2和SNMPv3的路由器在每個接口上都提供ifHC*計數(shù)器.noHC 關(guān)鍵詞表明需要使用低速的計數(shù)器ifInOctets
和ifOutOctets,而不是高速的ifHC*計數(shù)器.如果SNMPv2和SNMPv3被指定使用但是ifHC*計數(shù)器不可用,cfgmaker將會自動的插
入這個關(guān)鍵詞.
Example: Target[myrouter]: #Bri0:router1:::::3 SnmpOptions[myrouter]: username=>'user1' noHC[myrouter]: yes
-----------------------
reversing
有時候你處于鏈路錯誤的一側(cè),你也想mrtg把流入流量報告成流出流量等等.這個關(guān)鍵詞能做到這一點,你只是需要把"Target"
的描述中加上一個'-'.它就能把流入和流出流量交換.
例子:
Target[ezci]: -1:public@ezci-ether.domain

-------------------------
Explicit OIDs
你也可以使用‘OID_1&OID_2:community@router’明確的指定想要查詢的OID.下面的例子在接口1上檢索輸入和輸出流量的錯誤
計數(shù).MRTG需要為兩個變量繪制圖形,這樣你需要指定兩個OID,比如溫度和濕度或者錯誤的輸入和錯誤的輸出.
例子:
Target[myrouter]: 1.3.6.1.2.1.2.2.1.14.1&1.3.6.1.2.1.2.2.1.20.1:public@myrouter

-------------------------
MIB 變量
MRTG知道很多字符形式的SNMP變量.請參看主頁上的mibhelp.txt查看這些名字的列表.一個例子就是ifInErrors和ifOutErrors.
這意味著你可以這樣定義上面的例子:
例子:
Target[myrouter]: ifInErrors.1&ifOutErrors.1:public@myrouter

--------------------------
SnmpWalk
也許你會監(jiān)控一個只有使用'walk'才能訪問的snmp 對象.你可以讓mrtg進行walk操作,這需要在OID前面加上WaLK.或者你想訪問
walk操作返回的某個特定條目,那么你可以使用WaLKx,x是一個從"0"開始的數(shù)字.
例子:
Target[myrouter]: WaLKstrangeOid.1&WaLKstrangeOid.2:public@myrouter
Target[myrouter]: WaLK3strangeOid.1&WaLK4strangeOid.2:public@myrouter
---------------------------
SnmpGetNext
也有特殊的例子,那就是snmpgetnext能返回正確的值,但是walk不能.這中情況在使用snmpv2 or v3的時候會發(fā)生,因為在這些版
本中使用了snmpgetbulk方法.你可以在OID的前面加上字符串"GeTNEXT",以讓getnext操作來代替getbulk.
例子:
Target[myrouter]: GeTNEXTstrangeOid&GeTNEXTstrangeOid:public@myrouter

-----------------------------
SNMP Walk 相關(guān)計算
在一些情況下，snmpwalk 需要計算行數(shù)，而實際的數(shù)據(jù)并沒有意義。例如，計算CAM表中的MAC地址數(shù)目，或者同時進行撥號的
會話數(shù)目。你可以在OID前面加上CnTWaLK來讓MRTG進行計算。下面將對同時通過VOIP進行撥號的數(shù)目進行計算：
Target[myrouter]: CnTWaLK1.3.6.1.4.1.9.10.55.1.1.1.1.3&CnTWaLK1.3.6.1.4.1.9.10.55.1.1.1.1.3:public@myrouter

--------------------------------
使用IP來指定接口
有時候SNMP接口的索引號可能會變化，比如添加新接口或者移除某個接口。這可能會讓你的配置文件產(chǎn)生偏差，引起MRTG工作
出現(xiàn)錯誤等等。MRTG支持使用IP地址而不僅使用接口索引號來定義監(jiān)控對象。
確保使用的IP地址確實在同一個路由器上，特別是當繪制兩個不同OID的時侯；并確保使用‘&’分隔開接口。
你可以使用選項 “--ifref=ip”來讓cfgmaker生成相應(yīng)的配置文件。
例子：
Target[myrouter]: /1.2.3.4:public@wellfleet-fddi.domain
Target[ezci]: -/1.2.3.4:public@ezci-ether.domain
Target[myrouter]: ifInErrors/1.2.3.4&ifOutErrors/1.2.3.4:public@myrouter


-------------------------------

[ 本帖最后由 ioerr 于 2009-2-3 16:14 編輯 ]

ioerr

-------------圣誕快樂 2008.12.25-------------

使用名字（描述）來指定接口

如果你不能使用接口的IP地址來指定,那么你可能想用接口的名字來指定監(jiān)控的接口.這和使用IP地址的方法類似,但是前綴使

用\而不是/.

你可以指定cfgmaker使用選項--ifref=descr來自動生成配置文件.

例子:
Target[myrouter]: \My-Interface2:public@wellfleet-fddi.domain
Target[ezci]: -\My-Interface2:public@ezci-ether.domain
Target[myrouter]: ifInErrors\My-If2&ifOutErrors\My-If3:public@myrouter

如果你的描述中包括'&' 、':' 、'@'或者空格，那么你需要使用反斜線進行轉(zhuǎn)義。
Target[myrouter]: \fun\:\ ney\&ddd:public@hello.router

-----------------
使用名字（編號）來指定接口

這是指定你的交換機接口的唯一明智的做法。你可以使用--ifref=name來指示cfgmaker生成相應(yīng)的配置文件。

例子：
Target[myrouter]: #2/11:public@wellfleet-fddi.domain
Target[ezci]: -#2/11:public@ezci-ether.domain
Target[myrouter]: ifInErrors#3/7&ifOutErrors#3/7:public@myrouter

如果你的描述中包括'&' 、':' 、'@'或者空格，那么你需要使用反斜線進行轉(zhuǎn)義。
Target[myrouter]: \fun\:\ ney\&ddd:public@hello.router

----------------
使用以太網(wǎng)地址（MAC）來指定接口

如果SNMP的接口索引發(fā)生變化，你可以使用“物理地址”來指定接口，有時候被稱作“硬件地址”，在SNMP中就是變量

‘ifPhyAddress’。在內(nèi)部，MRTG會對配置文件中的物理地址和收集到的接口的索引的物理地址進行匹配，然后在其后的會

話中使用它。

你可以在各種監(jiān)控對象的定義中使用物理地址，這需要在OID的后面加上物理地址，并使用'!'來作分隔符（與ip地址選項類

似）。注意，一些路由器把一個MAC地址應(yīng)用到所有的接口上，這會影響到對接口唯一性的識別。mrtg會發(fā)覺這種情況，并提

出警告。

你可以使用--ifref=eth來讓cfgmaker生成相應(yīng)的配置文件。

例子：
Target[myrouter]: !0a-0b-0c-0d:public@wellfleet-fddi.domain
Target[ezci]: -!0-f-bb-05-71-22:public@ezci-ether.domain
Target[myrouter]: 1.3.6.1.2.1.2.2.1.14!0a-00-10-23-44-51&1.3.6.1.2.1.2.2.1.14!0a-00-10-23-44-

51:public@myrouter
Target[myrouter]: ifInErrors!0a-00-10-23-44-51&ifOutErrors!0a-00-10-23-44-51:public@myrouter


-----------------
使用類型來指定接口

有些設(shè)備似乎總是嘗試拒絕被監(jiān)控：既沒有ifName也沒有ifDescr，更不要提永久性的ifIndex了。唯一的辦法就是使用接口

的類型，因為接口在你要監(jiān)控的設(shè)備上是唯一的...

你可以使用--ifref=type來生成相應(yīng)的配置文件。

例子：
Target[myrouter]: %13:public@wellfleet-fddi.domain
Target[ezci]: -%13:public@ezci-ether.domain
Target[myrouter]: ifInErrors%13&ifOutErrors%14:public@myrouter





---------------------------
ifIndex的位置

有點OID中間包含有接口索引號。使用上面提到的各種方法指定接口的時候，關(guān)鍵詞‘IndexPOS’可以被用來指出ifIndex的位

置。如果IndexPOS沒有使用，ifIndex將會被加在OID的結(jié)尾。

例子：
Target[myrouter]: OID.IndexPOS.1/1.2.3.4&OID.IndexPOS.1/1.2.3.4:public@myrouter

用真實的數(shù)字OID取代里面“OID”字符。


-----------------------------
可擴展的主機名的語法

在所有的使用‘community@router’地方，你都能為SNMP的community名稱添加額外的使用冒號分隔的后綴作為參數(shù)。你也可以

使用管道符號和上面“ConversionCode”選項介紹中提到的轉(zhuǎn)換子程序的名字。完整的語法如下：
community@router[:[port][:[timeout][:[retries][:[backoff][:[version]][|name]]]]]


各個參數(shù)的含義如下：

********
port

和SNMP 代理聯(lián)系用的UDP端口號（默認值：161）
完整的port參數(shù)的語法是： remote_port[!local_address[!local_port]]

有的機器具備某些特殊的安全特性，只允許來自某個IP地址的查詢。如果進行查詢的主機有多個接口，指定進行查詢的接口可

能是必須的。

port指定被查詢的機器的工作端口。另外，進行查詢的機器的IP地址也可能需要被指定。

例子：
somehost
somehost:161
somehost:161!192.168.2.4!4000 （使用IP 192.168.2.4，端口4000 作為源主機參數(shù)。）
somehost:!192.168.2.4 （使用192.168.2.4作為源地址）
somehost:!!4000 （使用端口4000作為源端口）

********
timeout
SNMP查詢的初始化超時時間，單位是秒（默認值：2）

*********
retries
超時查詢的次數(shù)（默認值：5）

*********
backoff
每次重試的超時倍數(shù)因子（默認值：1）

*********
version
指定SNMP的版本。如果你有一個快速的路由器，你可能會在這里使用‘2’。如果涉及到授權(quán)和加密的SNMP，你可能在這里需要

使用‘3’。這會指示MRTG嘗試使用64位的計數(shù)器，并能避免計數(shù)器頻繁的重置。不是所有的路由器都支持這種特性。SNMPv3還

需要另外的設(shè)置，請參考SnmpOption[].

例子：
3:public@router1:::::2

*********
name
MRTG調(diào)用的把輸入、輸出值轉(zhuǎn)換成整數(shù)的子程序名稱。參考上面的“ConversionCode”。

例子：
1.3.6.1.4.1.999.1&1.3.6.1.4.1.999.2:public@mydevice:161::::2|Length2Int

這將在設(shè)備上檢索OID1.3.6.1.4.1.999.1的值作為輸入和1.3.6.1.4.1.999.2的值作為輸出，檢索使用UDP 161端口，使用

SNMPv2，并會執(zhí)行轉(zhuǎn)換子程序Length2Int來把這些值轉(zhuǎn)換成整數(shù)。
采用默認值就可以忽略不寫。后面的冒號也可以被忽略。管道符號必須在最后。在冒號和管道符號左右都不能使用空格。

例子：
  Target[ezci]: 1:public@ezci-ether.domain:9161::4
這將檢索在ezci-ether.domain上的接口1的輸入輸出字節(jié)的計數(shù)器，SNMP代理在UDP端口9161監(jiān)聽，標準的超時時間被使用（2

秒），但是重試次數(shù)被設(shè)置為4次，backoff值采用默認值。





---------------
使用IPv6地址

如果啟用了IPv6地址，你就可以使用IPv6地址來定義監(jiān)控目標。為了避免和端口號等產(chǎn)生混亂，IPv6地址必須被放到方括號

內(nèi)。

例子：
Target[IPv6test]: 2:public@[2001:760:4::]:6161::4


-----------------
外部監(jiān)控腳本的使用

如果你想監(jiān)控的設(shè)備之類的對象沒有通過snmp提供數(shù)據(jù)，你可以使用一些外部的程序來進行數(shù)據(jù)收集。
外部的命令必須返回4個輸出用的lines：

line1
第一個變量一般情況下是指‘流入的字節(jié)數(shù)’

line2
第二個變量一般情況下是指‘流出的字節(jié)數(shù)’

line3
字符串型變量，提供監(jiān)控目標的運行時間

line4
字符串型變量，提供監(jiān)控目標的名字

依據(jù)你的腳本返回的數(shù)據(jù)的類型，你可能會在Options關(guān)鍵詞上使用‘gauge’或者‘a(chǎn)bsolute ’。

例子：
Target[myrouter]: `/usr/local/bin/df2mrtg /dev/dsk/c0t2d0s0`

注意在命令兩頭使用的是（`）而不是（'）.
如果你想在命令名中使用（`），這是可以的，但是需要使用反斜線轉(zhuǎn)義。
如果你的腳本不返回任何數(shù)據(jù)但是也不想讓mrtg對無效的數(shù)據(jù)給出任何警告，它可以返回‘UNKNOWN’數(shù)據(jù)，而不是返回數(shù)字

。注意，rrdtool能很好的處理unknown數(shù)據(jù)。



----------------- 11:13 2008-12-29 ----------------

監(jiān)控多個目標



你也可以對幾個監(jiān)控目標的監(jiān)控指標使用數(shù)學(xué)進行計算。Perl解釋器能理解的計算方法都可以使用。我們可以計算ISDC鏈接

的兩個B通道使用，或者計算服務(wù)器上硬盤空間的使用率。

例子：
Target[myrouter]: 2:public@wellfleetA + 1:public@wellfleetA

Target[myrouter]: .1.3.6.1.4.1.999.1&.1.3.6.1.4.1.999.2:public@mydevice /
     .1.3.6.1.4.1.999.3&.1.3.6.1.4.1.999.4:public@mydevice * 100
注意：在表達式中，每個監(jiān)控目標定義的兩邊都必須有空格。監(jiān)控目標定義本身不能有空格，除非在接口描述和接口名稱上

，在這些地方，可以使用反斜線進行轉(zhuǎn)義。
MRTG自動的對表達式的結(jié)果進行取整，除非使用RRDTool日志格式，并且使用gauge選項。在內(nèi)部MRTG使用Perl的

Math::BigFloat package來計算，精度是40比特。在極端情況下，使用64bit的整數(shù)，表達式的結(jié)果將會是精確的。



-------------------------
SNMP查詢優(yōu)化

MRTG對自己的SNMP查詢進行了優(yōu)化。如果在一個配置文件中，某個監(jiān)控目標出現(xiàn)了多次，在一輪數(shù)據(jù)查詢中，MRTG對一個目

標的查詢只進行一次，對每一個同樣的目標都使用這批數(shù)據(jù)。對不同監(jiān)控目標的識別只基于簡單的字符串匹配，而不是進一

步的語法分析。

例子：
Target[Targ1]: 1:public@CiscoA
Target[Targ2]: 2:public@CiscoA
Target[Targ3]: 1:public@CiscoA + 2:public@CiscoA
Target[Targ4]: 1:public@CISCOA

上面的例子會產(chǎn)生三個SNMP查詢。數(shù)據(jù)分別來自1:public@CiscoA、2:public@CiscoA,這兩個監(jiān)控目標分別只被查詢一次，并

用于Targ1、Targ2、Targ3。Targ4會對1:public@CISCOA監(jiān)控目標再一次進行查詢，因為字符串和1:public@CiscoA不同。



---------------
最大字節(jié)數(shù)

監(jiān)控的兩個變量允許達到的最大值。對于監(jiān)控路由器來說，正常情況下就是指某個接口每秒能承載的字節(jié)數(shù)。
如果查詢得到的值比MaxBytes大，那么它會被忽略。請進一步參考AbsMax獲取信息。MaxBytes的值也被用于在繪圖時計算Y的

范圍（參考Unscaled一節(jié)）。

因為大多數(shù)鏈接的帶寬單位都是bits/s，你需要用最大帶寬除以8，為了能計算每秒的字節(jié)數(shù)。這對于實時正確的顯示信息是

非常重要的。T1 = 193000, 56K = 7000, 10 MB Ethernet = 1250000, 100 MB Ethernet = 12500000。MaxBytes的值被mrtg

用于決定從路由器得到的值是否有效。

如果你需要兩個不同的MaxBytes來測量兩個不同的變量，你可以使用MaxBytes1和MaxBytes2來代替MaxBytes。

例子：

MaxBytes[myrouter]: 1250000



---------------
Title

生成的HTML頁面的標題。

例子：
Title[myrouter]: Traffic Analysis for Our Nice Company





＝＝＝＝＝＝＝＝11:23 2008-12-30＝＝＝＝＝＝＝＝
可選監(jiān)控目標配置選項

---------------
PageTop

指定附加到HTML頁面的頂部的內(nèi)容。只要第一列為空，你可以寫好幾行。注意這些行都會出現(xiàn)在第一行。如果你想換行，請使用‘\n’。

例子：

PageTop[myrouter]: <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.

----------------
RouterUPtime

如果你想要計算多個接口的帶寬使用你也許不能在頁面上顯示路由器的運行時間和名稱。
如果這些接口都在同一個路由器上，并且需要顯示運行時間和名稱，那么你不得不使用RouterUptime關(guān)鍵詞來指定它的‘community’和IP地址。
如果你想使用OID來指定路由器的運行時間，參考下面的相應(yīng)實例。

例子：

Target[kacisco.comp.edu]: 1:public@194.64.66.250 + 2:public@194.64.66.250
RouterUptime[kacisco.comp.edu]: public@194.64.66.250

RouterUptime[kacisco.comp.edu]: hrSystemUptime.0:public@194.64.66.250

-----------------
RouterName

如果默認的路由器名字不正確或者沒有，你可以使用RouterName從相同/不同的主機獲取指定的OID。

一個實例是：在BayTechDS72上不論你怎么指定UnitID，sysName總是顯示“ds72”。UnitID存放1.3.6.1.4.1.4779.1.1.3.0，這樣我們可以讓MRTG顯示它而不是sysName。

例子：
RouterName[kacisco.comp.edu]: 1.3.6.1.4.1.4779.1.1.3.0

也可以在另一臺主機上指定另一個OID：
RouterName[kacisco.comp.edu]: 1.3.6.1.4.1.4779.1.1.3.0:public@194.64.66.251

-----------------
MaxBytes1
和MaxBytes一樣, 為監(jiān)控的變量1指定.

MaxBytes2
和MaxBytes一樣, 為監(jiān)控的變量2指定.

-----------------
IPv4Only

許多的IPv6路由器目前還不支持基于IPv6的SNMP，并且必須使用IPv4來監(jiān)控。當和監(jiān)控目標通訊的時候，即使啟用了IPv6，IPv4Only選項也會強制使用IPv4。當監(jiān)控目標是同時使用IPv4和IPv6地址的主

機的時候；沒有IPv4Only選項，如果IPv6啟用，監(jiān)控將不能正常工作。

如果設(shè)置為no（默認值），mrtg將會使用IPv6，除非監(jiān)控目標沒有設(shè)置IPv6地址，這樣就會使用IPv4。如果設(shè)置為yes，mrtg就只會使用IPv4。

注意如果這個選項被設(shè)置為yes，但是監(jiān)控目標沒有IPv4地址，和監(jiān)控目標的通訊會失敗。

如果IPv6選項沒有啟用，這個選項不回產(chǎn)生影響。

例子：

Target[v4onlyrouter_1]: 1:public@v4onlyrouter
IPv4Only[v4onlyrouter_1]: Yes



＝＝＝＝＝＝＝＝＝＝＝＝＝
SnmpOptions（v3）

SNMPv3需要設(shè)置大量的選項。這是一個每個監(jiān)控目標都可以設(shè)置的參數(shù)，它允許訪問SNMPv3的用戶安全模式。選項的語法使

用列表如下。

-------------
安全模式

SNMPv3有3種安全模式，在被監(jiān)控的設(shè)備上進行定義。例如：在Cisco路由器上安全模式是由snmp-server組全局配置命令進行

配置的。

--------------
NoAuthNoPriv

既沒有身份驗證也沒有私鑰的定義。在這種模式下只需要用戶名稱的選項。

例子：
SnmpOptions[myrouter]: username=>'user1'

--------------
AuthNoPriv
使用用戶名和口令�？诹畋籹nmpkey程序進行散列計算，或者在選項ContextEngineID中使用明文進行傳送。

例子：
SnmpOptions[myrouter]: username=>'user1',authpassword=>'example',
   contextengineid=>'80000001110000004000000'

---------------
priv

身份驗證和密鑰都被定義。默認的私鑰協(xié)議是DES。
例子：SnmpOptions[myrouter]: authkey=>'0x1e93ab5a396e2af234c8920e61cfe2028072c0e2',

authprotocol=>'sha',privprotocol=>'des',username=>'user1', privkey=>'0x498d74940c5872ed387201d74b9b25e2'

＝＝＝＝＝＝＝＝＝
snmp 選項
下面的選項關(guān)鍵詞都可以被支持：

----------------
username
與用戶安全模式有關(guān)的用戶名。

----------------
contextname
一個SNMP代理可以定義多個context。這個關(guān)鍵詞允許它們被獲取。

----------------
contextengineid
一個唯一的24字節(jié)的字符串，用于識別snmp代理。

-----------------
authpassword
定義在AuthNoPriv或者Priv安全模式下的用戶口令。

----------------
authkey
與明文口令的md5或者sha散列計算有關(guān)，與engineid一同使用。使用snmpkey命令來生成這個散列（hash），或者在腳本中使

用Net::SNMP::Security::USM得到.

----------------
authprotocol{sha|md5}
在SNMP客戶端定義的散列算法。默認是md5。

----------------
privpassword
在Priv模式中對snmp數(shù)據(jù)包進行加密的明文密鑰,它是事先設(shè)置的共享的.

----------------
privkey
明文預(yù)置密鑰的散列,和engineid同用.使用snmpkey命令來生成這個散列（hash），或者在腳本中使用

Net::SNMP::Security::USM得到.

--------------------
privprotocol {des|3desede|aescfb128|aescfb192|aescfb256}
指定snmp代理使用的加密方法,默認是des.

[ 本帖最后由 ioerr 于 2008-12-30 15:51 編輯 ]

ioerr

需要監(jiān)控流量所以開始找軟件,開始想使用cacti,配置總是失敗,于是又撿起來MRTG,它的優(yōu)點是:簡單易上手.裝上基本就能馬上運行.除非運氣不好.仔細看看文檔,監(jiān)控其它數(shù)據(jù)也是可以的.就是死板點.但是對于大多數(shù)人來說基本夠用了.

剛翻譯到這里,本來想元旦前翻譯完,然后再貼上來,但是家務(wù)較多,估計夠嗆了,再說馬上要放假了,節(jié)前獻禮吧.

祝大家元旦快樂

ioerr

再補充些，翻譯的慢了點，呵呵


-----------------10:36 2008-12-31-----------------
PageFoot
在這里指定添加到生成HTML頁面的底部的內(nèi)容.只要第一列是空的,你可以寫很多行內(nèi)容.注意它們將會顯示成一行.如果你想
換行請使用'\n'.這些內(nèi)容會添加在</BODY>標簽前面.
例子:
PageFoot[myrouter]: Contact <A HREF="[email=peter@..delete..this..x.yz%22%3EPeter%3C/A]mailto:peter@..delete..this..x.yz">eter</A[/email]>
  if you have questions regarding this page
------------------
AddHead
作用類似PageTop,但是內(nèi)容添加在</TITLE></HEAD>之間.
例子:
AddHead[myrouter]: <link rev="made" href="[email=mrtg@..delete..this..blabla.edu]mailto:mrtg@..delete..this..blabla.edu[/email]">
---------------------
BodyTag
這個選項讓你對自己頁面的<body>進行定制.
例子:
BodyTag[myrouter]: <BODY LEFTMARGIN="1" TOPMARGIN="1"
                      BACKGROUND="/stats/images/bg.neo2.gif">
---------------------
AbsMax
如果你正在監(jiān)視一個鏈路,它能處理比MaxBytes更大的量.比如使用壓縮技術(shù)的鏈路或者幀中繼鏈路,你可以使用這個參數(shù)來指
定一個曾經(jīng)達到的最大絕對值.這是為了挑出那些路由器返回的不太真實的值.如果你不設(shè)置它,那么超過MaxBytes的值會被忽
略.
例子:
AbsMax[myrouter]: 2500000
----------------------
Unscaled
默認情況下,每個圖都會被繪制,即使它比MaxBytes小很多.使用Unscaled你可以對其進行控制.它的參數(shù)是一個字符串,包含一
些字符:d=day w=week m=month y=year.用來控制哪些圖不被繪制.還有一個特殊的情況,把它設(shè)置為n,就是none.如果你想覆
蓋全局設(shè)置,這會有所幫助.下面的例子中,月和年的圖被取消繪制.
例子:
Unscaled[myrouter]: ym

------------------------
WithPeak
默認情況下,圖像中只包含平均值-一般情況下是流入流出的速率.下面的選項指示mrtg繪制5分鐘內(nèi)的峰值,在周/月和年的圖
像中.在例子中,我們讓圖像既顯示平均值,也顯示月和年的峰值.
例子:
WithPeak[myrouter]: ym


-------------------------11:27 2009-01-04-------------------------
suppress
默認情況下，mrtg生成四個圖像.使用這個選項,你可以禁止生成指定的圖像.這個選項的參數(shù)和上面兩個類似.在下面的例子
中,我們禁止生成"年"的圖像因為這個圖像在開始的時候基本是空的.
例子:
Suppress[myrouter]: y
--------------------------
Extension:
默認情況下,mrtg生成的文件的后綴是.html.使用這個參數(shù)你可以讓mrtg來使用不同的后綴.例如,你可以設(shè)置后綴為php3,然
后你將能夠在輸出中包含有PHP標簽(這對于從數(shù)據(jù)庫中獲取路由器的名字是很有用的).
---------------------
Directory
默認情況下,mrtg把生成的文件(包括Gif,html,還有日志文件等等)都放置在WorkDir中.
如果Directory選項被指定,這些文件將會被放置到WorkDir下的目錄中去,也可能是在Log-、Image-或HtmlDir中的目錄中去。
例如在下面的例子中，監(jiān)控的路由器的文件被放置到/usr/tardis/pub/www/stats/mrtg/myrouter/中.)
目錄必須是存在的,mrtg不會創(chuàng)建目錄.
例子:
WorkDir: /usr/tardis/pub/www/stats/mrtg
Directory[myrouter]: myrouter
注意:這里的路徑是相對路徑,如果不對,將會出現(xiàn)意想不到的問題.
--------------------------
Clonedirectory
如果Directory選項被設(shè)置,這個參數(shù)將使得mrtg吧Directory中的所有文件都復(fù)制到CloneDirectory中去.
和上面的參數(shù)一樣,也要求目錄是已經(jīng)存在的,mrtg不會生成目錄.
例子:
WorkDir: /usr/tardis/pub/www/stats/mrtg
Directory[myrouter]: myrouter
Clonedirectory[myrouter]: myclonedirectory
注意:這個參數(shù)必須是相對路徑,否則會出現(xiàn)意外.
------------------------------
XSize and YSize
默認情況下,mrtg圖像是100*400像素.在下面的例子中,我們生成了一個幾乎正方形的圖像.
注意:XSize的值必須在20到600之間,YSize必須大于20.
例子:
XSize[myrouter]: 300
YSize[myrouter]: 300
--------------------------------
XZoom and YZoom
如果你想要圖像的像素變大,你可以對它們進行"縮放".
例子:
XZoom[myrouter]: 2.0
YZoom[myrouter]: 2.0
-------------------------------
XScale and YScale
If you want your graphs to be actually scaled use XScale and YScale.注意:如果使用這兩個參數(shù),坦率的說,生成的圖
像可能會很難看,歡迎大家解決這個bug.
例子:
XScale[myrouter]: 1.5
YScale[myrouter]: 1.5
---------------------------------
YTics and YTicsFactor
如果你想在圖像上顯示超過4條線,請使用YTics.如果你想對Y軸上的數(shù)據(jù)進行縮放,使用 YTicsFactor.默認情況下,YTics值為
4,YTicsFactor是1.0。
例子：
架設(shè)你處理的值位于0到700之間。你想劃7條線，想在Y軸上顯示0、1、2、3、4、5、6、7而不是100、200、300、400、500、
600、700。你可以這樣寫：
YTics[myrouter]: 7
YTicsFactor[myrouter]: 0.01


-------------------
Factor
如果你想讓在圖像下面的數(shù)字都乘以一個常數(shù)，是用這個參數(shù)定義它。
例子：
  Factor[as400]: 4096
-------------------
Step
把默認的間隔5*60s變成其它的什么東西（沒有做過很多的測試，慎用...）
例子：
Step[myrouter]: 60
---------------------
PNGTitle
當你使用rateup來生成圖像的時候，這個選項會把指定的標題顯示在圖像上。
例子：
PNGTitle[myrouter]: WAN Link UK-US
-----------------------
Opentions
這個選項關(guān)鍵詞允許你設(shè)置一些布爾變量：
--------
growright
圖像默認情況下從左邊生成。這個選項會讓圖像從右邊生成。
-----------
bits
指定所有的被監(jiān)控變量的值都乘以8（比如顯示結(jié)果為bits，而不是Bytes）。這也會影響到被監(jiān)控對象的廠商默認值
（‘factory default’）。
----------
perminute
All the monitored variable values are multiplied by 60 (i.e. shown in units per minute instead of units per
second) in case of small values more accurate graphs are displayed. It also affects the 'factory default'
labeling and units for the given target.
所有監(jiān)控變量的值都乘以60（即: 用分鐘為單位而不是秒），這用在某些顯示小的值會更準確圖像中。這也會影響到工廠預(yù)
置的值和單位。
----------
perhour
All the monitored variable values are multiplied by 3600 (i.e. shown in units per hour instead of units per
second) in case of small values more accurate graphs are displayed. It also affects the 'factory default'
labeling and units for the given target.
所有監(jiān)控變量的值都乘以3600（即: 用小時為單位而不是分），這用在某些顯示小的值會更準確圖像中。這也會影響到工廠
預(yù)置的值和單位。
-------------
noinfo
禁止在生成的頁面中顯示運行時間和設(shè)備名稱。
------------
nopercent
不顯示使用百分比。
-------------
transparent
使得生成的gif圖像的背景透明。
-----------
integer
使得在圖像下方的數(shù)據(jù)為整數(shù)，不使用逗點。
------------
dorelpercent
這個選項在圖像中顯示流入流量和流出流量的相對百分比。注意：這個百分比的范圍是0-100％。因此如果流入流量比流出流
量大，那么會顯示100％。如果你不肯定流入流量一定小于流出流量，請不要使用這個參數(shù)。注意：如果你還使用了Colours
選項，你需要指定第五對 colour-name、 colour-value。
------------
avgpeak
有的ISP使用平均峰值來讓用戶交費。這個選項讓MRTG在每個圖像上顯示平均峰值。The value is built by averaging the
max 5 minute traffic average for each 'step' shown in the graph. For the Weekly graph this means that it
builds the average of all 2 hour intervals 5 minute peak values. (Confused? Thought so!我也很暈，沒看懂~~~)
-------------
gauge
使用這個選項，mrtg會把收集到的值作為當前狀態(tài)值，而不是一個不斷增加的計數(shù)器。這對于監(jiān)控硬盤空間、cpu負載、溫度
等等是很有用的。
如果沒有指定‘gauge’或者‘a(chǎn)bsolute’，MRTG會吧變量當成計數(shù)器來對待，根據(jù)目前的值，還有先前的值及這兩個值之間
的間隔來進行計算。
--------------
absolute
這個選項用來應(yīng)對這樣的數(shù)據(jù)變量，每當它們被讀取后，就會重新置0。這意味著rateup不用對從數(shù)據(jù)源獲取的當前值和上一
個值進行某些處理。但是獲取的值還是會除以兩次取值的時間間隔，這也是和‘gauge’選項的區(qū)別。這對于外部數(shù)據(jù)的收集
很有用。
----------------
derive
如果你正在使用rrdtool做日志或者繪圖，你可以使用第三方數(shù)據(jù)源. 除了不是全時間運行外，Derive 就象一個計數(shù)器. 在
一些值的變化需要被繪制圖像的情況下，這個選項是很有用的。
--------------
unknaszero
unknow的數(shù)據(jù)不再取前一個狀態(tài)的值，而是當作0來處理。但是請注意，因為在圖像中間位置的平線比一個取值0的平線更顯
眼。
---------------
withzeroes
正常情況下，當計算平均值的時候，我們忽略取到的0值。如果不想這樣，請使用這個選項。

---------------9:56 2009-01-06---------------
noborder
如果你使用的是rateup來記錄數(shù)據(jù)，mrtg將能生成圖像。正常情況下，這些圖像有一個陰影邊框。如果你不想生成邊框，啟用這個選項。但是如果你沒有使用rateup，那么將不會有任何效果。
---------------
noarrow
和上面的選項一樣，這個選項也只是影響rateup生成的圖像。正常情況下，rateup生成的圖像有一個箭頭表明數(shù)據(jù)方向。如果你不想生成箭頭，那么可以使用這個選項。
---------------
noi
如果使用rateup來生成圖像，你可以使用這個選項來讓rateup不生成“I”（in）或者說是第一個變量的圖形。這也會移除這個變量在MRTG生成的HTML頁面中的相關(guān)條目，并且會移除這個變量的peak（峰
值），即使peak被啟用了。這個選項允許你隱藏這個數(shù)據(jù)，當你只是想繪制一個變量的時候會很有用。這個選項沒有破壞性，任何被接收的數(shù)據(jù)都會繼續(xù)被記錄，只不過是不顯示。
---------------
noo
和上面的選項一樣，只不過是對‘O’（out）或者說第二個變量起作用。
---------------
nobanner
當使用rateup生成圖像的時候，這個選項使得MRTG不再吧MRTG的banner添加到HTML頁面中去。
---------------
nolegend
當使用rateup生成圖像的時候，這個選項將使得mrtg停止在HTML頁面底部生成圖例說明。
---------------
printrouter
當使用rateup生成圖像的時候，這個選項將在它生成的圖像上添加路由器的名字。如果設(shè)置了PNGTitle，這個選項將會被覆蓋。
---------------
pngdate
當使用rateup生成圖像的時候，這個選項將在生成的圖像上添加時間戳，如果設(shè)置了‘timezone’，還會包括時區(qū)。
---------------
logscale
這個選項使rateup在Y軸顯示數(shù)據(jù)的時候使用對數(shù)。這將使得正常的流量占據(jù)垂直范圍的大多數(shù)區(qū)域，然而峰值還會全部顯示出來。
logscale將顯示所有可用的數(shù)據(jù)并生成好看的圖像。人們通常認為對數(shù)形式的圖像不直觀，并且因此不好看懂。
---------------
expscale
這個選項使得rateup在Y軸上使用指數(shù)形式顯示數(shù)據(jù)。這樣將會在圖像的頂部突出顯示小的變化；在圖像的頂部如果因為小的數(shù)值引起波動的話，這會很有用，比如電壓變化。
expscale作用重點和logscale相反。（這樣理解的話，logscale重點突出中間區(qū)域，expscale重點是曲線頂部。）
---------------
secondmean
The secondmean option sets the maximum value on the graph to the mean of the data greater than the mean of all data（繞嘴，翻不出，也理解不了）。 這個選項重點更多的強調(diào)典型數(shù)據(jù)
，而裁剪峰值數(shù)據(jù)。
這個選項將會給出更直觀的線性數(shù)據(jù)，但是在極少的情況下可能會生成沒有意義的或高或低的曲線（特別是當數(shù)據(jù)與實際平均值誤差較大的時候。）
如果監(jiān)控目標同時包括logscale和secondmean，secondmean將優(yōu)先起作用。
例子：
Options[myrouter]: growright, bits

---------------

foxleoly

MRTG很不錯,我在公司就是用freebsd 7.0做server 上面只跑mrtg..還有些參數(shù)沒有理解透徹啊...繼續(xù)學(xué)習中!!

ioerr

---------------8:53 2009-01-09---------------
kilo
使用這個選項來修改倍數(shù)值。默認是1000。這個選項主要是為了應(yīng)對特殊的情況，比如：1kB＝1024B，1MB＝1024KB等等。
例子：
kilo[myrouter]: 1024


--------------
kMG
修改默認的乘數(shù)前綴(,k,M,G,T,P)。在標簽ShortLegend中定義的只是基本的單位。格式：使用逗號分隔各個前綴。連續(xù)兩個逗號或者在開始、末尾有逗號意味著在這里沒有前綴。如果你不想使用前綴，


那么只放兩個連續(xù)的逗號即可。如果你想跳過一個數(shù)量級，請使用‘-’。


例子：nm/s來作速度單位(納米/s)但顯示為nm/h。
ShortLegend[myrouter]: m/h
kMG[myrouter]: n,u,m,,k,M,G,T,P
options[myrouter]: perhour
（個人理解不太清楚，請對照原文理解。）




Colours
這個選項允許你覆蓋默認的顏色搭配。注意：所需要的4個顏色都必須被指定。顏色的名字（下面的‘colourx’）就是范例中的形式，顏色使用RGB值指定，用于圖像的繪制和頁面顯示。


格式: Col1#RRGGBB,Col2#RRGGBB,Col3#RRGGBB,Col4#RRGGBB


重要提示：如果你使用了dorelpercent選項，需要指定第五個顏色名稱及其RGB值。


Colour1
第一個變量的顏色，正常情況下是輸入流量。


Colour2
第二個變量的顏色，一般是輸出流量。


Colour3
第一個變量最大值,輸入流量。


Colour4
第二個變量最大值，輸出流量。


RRGGBB
兩個一組，分別表示紅色，綠色，藍色。


例子：
Colours[myrouter]: GREEN#00eb0c,BLUE#1000ff,DARK GREEN#006600,VIOLET#ff00ff


----------------------
BackGround
使用這個選項，你能配置生成的HTML頁面的背景色。
例子：
Background[myrouter]: #a0a0a0a


------------------------
YLegend, ShortLegend, Legend[1234]
以下關(guān)鍵詞可以允許你為圖像和頁面中的相應(yīng)輸出指定不同的顏色。


----------
YLegend
圖像Y軸的名字。注意如果名字對于圖像太長會被忽略。


----------
ShortLegend
圖像中Max，Average和Current值使用的計量單位。


Legend[1234IO]
各個實例的名字。


例子：
  YLegend[myrouter]: Bits per Second
  ShortLegend[myrouter]: b/s
  Legend1[myrouter]: Incoming Traffic in Bits per Second
  Legend2[myrouter]: Outgoing Traffic in Bits per Second
  Legend3[myrouter]: Maximal 5 Minute Incoming Traffic
  Legend4[myrouter]: Maximal 5 Minute Outgoing Traffic
  LegendI[myrouter]: &nbsp;In:
  LegendO[myrouter]: &nbsp;Out:


注意：如果LegendI或者LegendO被設(shè)置為空：
LegendO[myrouter]:


圖像下側(cè)相應(yīng)的內(nèi)容將不會被輸出。


-------------------
TimeZone
生活在一個國際化的世界中，你可能想生成不同的時區(qū)的圖像。這個選項用來達到這個目的。在某些操作系統(tǒng)中，比如Solaris，會對localtime產(chǎn)生調(diào)用來獲取相應(yīng)的時區(qū)的時間。


例子：
Timezone[myrouter]: Japan


這個時區(qū)是標準的時區(qū)，比如：Japan, Hongkong, GMT, GMT+1 等等




----------------9:00 2009-02-02   Happy new year!-------------




Weekformat


默認情況下，mrtg（實際上是 rateup）使用strftime(3)'%V'選項來格式化在每月統(tǒng)計圖中的星期幾輸出.在不同的系統(tǒng)中對于格式選項的解釋可能會有不同.如果你發(fā)現(xiàn)對于星期格式的輸出是錯誤的,并


且你的系統(tǒng)的strftime(3)支持的話,可以嘗試另一種格式化選項.POSIX '%V'選項符合廣泛使用的ISO 8601星期輸出格式標準.星期格式使用一個字符來指定,W、V或者U。


unix版本的rateup使用的是libc版本的strftime。在windows中本地的strftime實現(xiàn)不支持%V。于是我們使用了另一個不同版本的strftime，它支持%V。


例子：
Weekformat[myrouter]: W


---------------------------
RRDRowCount


這將影響到新的rrd文件的創(chuàng)建。默認情況下，rrds保存一天的高解析度數(shù)據(jù)值。（加上保存一周的30分鐘樣本數(shù)據(jù)，兩個月的2小時樣本數(shù)據(jù)，兩年的每天樣本數(shù)據(jù)）。使用這個關(guān)鍵詞，你能修改數(shù)據(jù)


樣本的保存筆數(shù)，當新文件被創(chuàng)建的時候會起作用。注意你必須考慮采樣的間隔。


例子：
RRDRowCount[myrouter]: 1600


------------------------------
RRDHWRRAs


正常情況下，mrtg 創(chuàng)建的RRDs只包含從每個監(jiān)控目標收集的數(shù)據(jù)。使用這個選項，你可以啟用基于Holt-Winters 的異常行為探測模塊。RRDHWRRAs 選項指定了Holt-Winters的RRAs，這在rrdcreate的手


冊頁中有描述。


這一這個設(shè)置將僅僅影響新創(chuàng)建的RRDs（以監(jiān)控目標為單位）。


例子：
RRDHWRRAs[myrouter]: RRA:HWPREDICT:1440:0.1:0.0035:288


-----------------------------
TimeStrPos


這定義了時間戳字符串在圖像中的放置位置�？梢杂玫闹涤蠷U、LU、RL、LL（分別代表右上角、左上角、右下角、左下角）還有NO（沒有時間戳）。默認情況下，在圖像上沒有時間戳。


例子：
TimeStrPos[myrouter]: RU


-----------------------------
TimeStrFmt


使用這個選項可以指定放置到圖像中的時間戳的格式（如果啟用了TimeStrPos關(guān)鍵詞）。指定的字符串將會被strftime()函數(shù)使用--參考strftime的相關(guān)文檔來獲取在你的系統(tǒng)中可以使用的定義格式。


默認格式為：%Y-%m-%d %H:%M


例子：
TimeStrFmt[myrouter]: %H:%M:%S




-------------------------------
閥值檢查

通過此項功能，mrtg能檢測到閥值相關(guān)的問題，并能調(diào)用外部的腳本來處理這些問題（比如發(fā)送郵件或

者一個頁面給管理員。）

閥值檢查是通過下面的參數(shù)進行配置的：

-----------------
ThreshDir（GLOBAL）

使用這個參數(shù)來指定一個可寫的目錄，當閥值被觸及的時候，MRTG將發(fā)出警告。

例子：
ThreshDir: /var/mrtg/thresh

------------------
ThreshHyst（GLOBAL）

如果threshold 被打破，并且你也定義了threshdir，那么mrtg將發(fā)送email，但是我們需要避免一種情

況，就是broken和unbroken狀態(tài)切換很快，造成接連發(fā)送，那么我們在離閥值一定范圍內(nèi)只發(fā)送一次

unbroken消息。使用ThreshHyst配置變量你將能夠定義這個值。

比如定義為5%：
ThreshHyst: 0.05

--------------------
ThreshMailServer（GLOBAL）

SMTP服務(wù)器地址，用于接收閥值broken和unbroken狀態(tài)變化的郵件。

-------------------
ThreshMailSender（GLOBAL）

閥值郵件中發(fā)送者的郵件地址。
例子:
ThreshMailSender: mrtg@example.com

--------------------
ThreshMailAddress (PER TARGET)

Threshhold相關(guān)的郵件地址。這將在mailserver被配置的情況下產(chǎn)生作用。

例子：
ThreshMailAddress[_]: admin@example.com
ThreshMailAddress[router]:

這將使得所有的監(jiān)控對象在需要的時候發(fā)送郵件給指定的地址，但是下面名稱為router的監(jiān)控對象被定

義為不會發(fā)送。

---------------------
ThreshMinI（PER TARGET）

這是輸入變量可接受的最小值。如果獲取的值比這個指定的值小，那么在ThreshProgI中指定的程序就會

運行，并發(fā)送一封郵件到ThreshMailAddress（如果被指定了的話），如果這個值被使用%指定，那么指

的是相對于MaxBytes的值。

------------------------
ThreshMaxI（PER  TARGET）
同上面的選項類似，但針對的情況是取得的值比ThreshMaxI高。

-----------------------
ThreshDesc（PER TARGET）
在下面設(shè)置的程序被調(diào)用前，這個選項的值將被賦予環(huán)境變量THRESH_DESC。運行的程序可以使用這個變

量來生成更友好的輸出。

-----------------------
ThreshProgI (PER TARGET)
這個選項定義當ThreshMinI 或者 ThreshMaxI 被觸發(fā)時需要運行的程序。MRTG傳遞了三個變量：

$router變量，觸發(fā)閥值，當前的參數(shù)值。

------------------------
ThreshProgOKI（PER TARGET）

這定義了當參數(shù)的值處于OK狀態(tài)下需要運行的程序（它的狀態(tài)是相對ThreshMinI和ThreshMaxI而言的）

，但是如果前面的程序運行了，狀態(tài)就是不OK的了--基于在ThreshDir中發(fā)現(xiàn)的文件來說的。MRTG傳遞3

個變量給它：$router,閥值處于unbroken狀態(tài)的值,還有當前參數(shù)的值.

------------------------
ThreshMinO, ThreshMaxO, ThreshProgO, and ThreshProgOKO
這些選項和上面提到的一系列選項相同,只不過是針對輸出變量的.

-------------------------------------------

ioerr

--------------------10:15 2009-02-03-------------------
SetEnv
當在你的配置文件中調(diào)用閥值相關(guān)腳本時，你可能需要傳遞一些數(shù)據(jù)給腳本。這可以使用SetEnv配置選項來實現(xiàn)。注意引號是強制使用的。這不能用于外部的腳本。它也不能為
每個監(jiān)控對象設(shè)置環(huán)境變量。
例子：
Example:
SetEnv[myrouter]:  EMAIL="contact_email@someplace.net"
                    HOST="www.some_server.net"
-----------------
HW系列閥值檢查選項
當你使用基于HW RRAs日志的rrd時。你就能為閥值報警使用內(nèi)置于FAILURES RRA的 confidence bounds violations 。
前面的所有的threshold選項都有對應(yīng)的Hold-Winters選項：
ThreshMailAddress -> HWThreshMailAddress
ThreshMinI        -> HWThreshMinI
...
用于threshold檢查的全局變量都是共享的，除了：
ThreshHyst        -> HWThreshHyst
HWThreshDesc設(shè)置HWTHRESH_DESC變量。

----------------------------------------------------------
監(jiān)控對象的默認值
--------------------
前綴和后綴
你可以定義一個監(jiān)控對象名稱為'^'.你為這個監(jiān)控對象定義的每個關(guān)鍵詞也都會為下面的每個監(jiān)控對象預(yù)先自動生成。同樣的也可以定義一個名字為'$'的監(jiān)控對象,不過它的文
字是附加性質(zhì)的.
注意,在預(yù)先添加的文本和關(guān)鍵詞的值之間插入了一個空格,對于附加的文本也一樣.如果關(guān)鍵詞的值是文本,這可以很好的工作,但是對于其他類型的關(guān)鍵詞就不是很有用了.請看
下面"default"監(jiān)控對象的描述.
在這個例子中,此配置文件中定義的每個監(jiān)控對象,MRTG都會為它們的頁面生成相同的頭部和聯(lián)系人信息.
例子:
PageTop[^]: <H1>NoWhere Unis Traffic Stats</H1><HR>
PageTop[$]: Contact Peter Norton if you have any questions<HR>
如果想要移除這些預(yù)先添加和附加的值,可以指定一個空值:
PageTop[^]:
PageTop[$]:
--------------------
NoSpaceChar
對于預(yù)加和附加的值,正常情況下與本地的值之間會有一個空格.有的時候這是不必要的.你可以使用全局選項NoSpaceChar定義一個字符,當你在定義'^','$'監(jiān)控對象的時候,在末
尾加上這個字符,就可以不再生成空格.
例子:
  NoSpaceChar: ~
  Target[^]: 1.3.6.1.4.1.482.50.2.4.20.0&1.3.6.1.4.1.482.50.2.4.21.0:get@~
  Target[a]: a.tolna.net
  Target: b.tolna.net
  Target[c]: c.tolna.net
  Target[d]: d.tolna.net
上面定義的特殊字符是" ~ ".

-----------------------
默認值
如果指定的監(jiān)控對象的名字是"_",那么就為關(guān)鍵詞指定了默認值.如果缺少明確指定的關(guān)鍵詞值,那么預(yù)加和附加的關(guān)鍵詞的值就會使用默認值.
例子:
YSize[_]: 150
Options[_]: growright,bits,nopercent
WithPeak[_]: ymw
Suppress[_]: y
MaxBytes[_]: 1250000
移除默認值,返回"程序默認值",定義一個空值即可:
YLegend[_]:
在配置文件中default/prepend/append的值可能會有這樣幾種情況出現(xiàn).最新的設(shè)置會替代前面的設(shè)置,從而影響配置文件中后面的部分.對關(guān)鍵詞/監(jiān)控對象起作用的
default/prepend/append的值,是在監(jiān)控對象第一次出現(xiàn)時開始起作用的.
例子:
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 IF 2
上面的例子中對于myrouter.someplace.edu.2這個監(jiān)控對象來說,MaxBytes的默認值是1250000,從監(jiān)控對象第一次出現(xiàn)開始起作用.
(上面這些選項我很少用,翻譯的可能會有很多問題,請大家結(jié)合原手冊對照看,謝謝!)

---------------------------------------------------------
命令行選項
--user username and --group groupname
以給定的用戶組/用戶名運行.(只對Unix起作用)
--lock-file filename
使用一個指定的鎖定文件名(默認使用"配置文件名_l").
--confcache-file filename
使用一個指定的配置緩存文件名(默認使用"配置文件名.ok")
--logging filename|eventlog
如果設(shè)置了一個可寫的文件名,那么所有的mrtg的輸出(警告,debug信息,報錯)都會寫入指定的文件.如果你使用的是win32平臺,你可以指定eventlog而不是一個文件名,這樣所有
的信息都會寫入windows日志.
注意:mrtg沒有自己帶"message DLL".這將對windows的事件日志產(chǎn)生副作用,日志中的每條相關(guān)記錄都將提示mrtg沒有message dll.如果你去mrtg的下載區(qū),你會發(fā)現(xiàn)一個mrtg-
message-dll.zip,日志中提到的message dll就在里面.
--daemon
將mrtg放入后臺運行.這和配置文件中的同樣選項作用相同,但是這個參數(shù)要進行權(quán)限設(shè)置(因為/var/run只對root可寫.)
--fhs
配置所有的mrtg路徑符合FHS規(guī)定;(參考http://www.pathname.com/fhs/)
--check
只檢查配置文件的錯誤,不做其它操作.
--pid-file=s
為mrtg作為daemon運行定義pid文件的名字和路徑.
--debug=s
啟用debug模式的選項.由逗號分隔的debug變量值組成:
cfg  - watch the config file reading
dir  - directory mangeling
base - basic program flow
tarp - target parser
snpo - snmp polling
coca - confcache operations
fork - forking view
time - some timing info
log  - logging of data via rateup or rrdtool
eval - print eval strings before evaluting them
prof - add hires timing info the rrd calls
例子:
--debug="cfg,snpo"

------------------------------------------------------
程序退出返回碼
返回碼0表示所有的監(jiān)控對象都處理成功.通常來說,比0大的返回值都意味著不可恢復(fù)的問題出現(xiàn).一個例外是返回碼91,它表示至少有一個監(jiān)控對象處理成功.部分返回碼如下:
  0: 所有的監(jiān)控對象處理成功(All targets sucessful)
  2: 配置錯誤--配置文件不能讀取,或者致命錯誤,等等  (Config error  --can't read, fatal error in config, etc)
17: 其它的MRTG進程正在處理配置文件--(Another MRTG process is processing config)
91: 至少一個監(jiān)控對象處理成功--At least one target sucessful
92: 沒有監(jiān)控對象處理成功--No targets were sucessful
--------------------------------------------------------
例子:
----------------------
最小配置文件mrtg.cfg
WorkDir: /usr/tardis/pub/www/stats/mrtg
Target[r1]: 2:public@myrouter.somplace.edu
MaxBytes[r1]: 8000
Title[r1]: Traffic Analysis ISDN
PageTop[r1]: <H1>Stats for our ISDN Line</H1>
----------------------
有幾個路由器的配置文件
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[_]: 8000
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
# the following line removes the default prepend value
# defined above
Title[^]:
Title[isdn2]: Traffic for the Backup ISDN Line
PageTop[isdn2]: our ISDN Line</H1>
Target[isdn2]: 3:public@router.somplace.edu
--------------------------------------------------------------------
作者相關(guān):
Tobias Oetiker <tobi@oetiker.ch> and many contributors
最后更新: 11/04/08 | Tobias Oetiker | OETIKER+PARTNER AG


(終于完了。)

flamedragon

原帖由 ioerr 于 2008-12-30 15:49 發(fā)表
原文在我的博客里面http://hi.baidu.com/ioerr/blog/i ... 32a064c088d86.html.
難免錯誤,估計還不少,大家共同訂正吧.
本來打算年前搞定，一直沒有抽出時間，剛上班，還沒有忙起來，趕緊弄完，就算 ...

我轉(zhuǎn)換成pdf了！

劍心通明

好人啊

劍心通明

轉(zhuǎn)載先，呵呵，多謝樓主