天天看點

mrtg 參數設定

mrtg運作時的行為可以通過配置檔案來控制,雖然大部配置設定置檔案都是通過cfgmaker來生成的,但是手動調整一些更為精細的配置項是很有必要的,這篇文檔對所有的mrtg能識别的配置選項作了說明

文法

MRTG配置檔案遵循以下幾個簡單規則

關鍵字必須起始于行首

以空格開始的行将被附加到上一行關鍵開頭的行來解析

不解析空行

# 号開頭的行被當成注釋

可通過Include指令包含檔案,例如:Include: base-options.inc 。如果指定相對路徑引入檔案,mrtg将會在目前工作目錄和包含主配置檔案的目錄下尋找該引入檔案

全局關鍵字

WorkDir

WorkDir 日志檔案和生成的的網頁的放置目錄

可選的全局關鍵字

HtmlDir

HtmlDir 指定html檔案(或shtml)的放置目錄。注意: WorkDir會覆寫HtmlDir、ImageDir、LogDir的值

ImageDir

ImageDir 指定圖像檔案的放置目錄,應該放置在HtmlDir下

LogDir

LogDir 指定日志檔案放置目錄,不應該位于HtmlDir下

Forks

Forks 4 (Unix平台下可用),通過snmp請求資料的線程個數,在網絡延遲比較大或者裝置比較多的情況下可以加速snmp資訊的擷取

EnableIPv6

EnableIPv6 yes / no 是否開啟ipv6支援

EnableSnmpV3

EnableSnmpV3 yes / no 預設是禁止的,訓示是否開啟snmpv3支援

Refresh

Refresh 300 網頁重新整理時間間隔,預設是5分鐘(機關為秒)

Interval

Interval 10 mrtg擷取資訊頻率,預設為5分鐘(機關為分鐘),訓示mrtg每隔多少分鐘生成一次包含正确資訊的html檔案,并且在html檔案的Meta header中加入緩存時間訓示(Cache-Control)

MaxAge

Mrtg 高度依賴目前系統時間,如果目前時間是一個錯誤的值,并且比目前時間提前了許多的話,将會導緻mrtg丢失舊日志檔案中的許多資訊,為了避免這種情況,可以加入一個"合理的"時間值,用來檢查日志檔案的最近修改時間,如果一個日志檔案比目前時間加上這個時間值還舊,mrtg将不會往這個檔案寫入資訊,相反的,隻是提示你,給你一個機會了發現問題所在, 如 MaxAge 7200 将告訴mrtg不要更新2小時前至今未修改的日志檔案

WriteExpires

這個選項将會為CERN和apache伺服器生成相應的.meta檔案,這個與WEB伺服器軟體有關

NoMib2

正常情況下MRTG查詢snmp裝置的’sysUptime’和’sysName’屬性,但是有的設定沒有實作這兩個屬性,這将會導緻mrtg發出警告資訊訓示屬性丢失,這時可以将NoMib2置為yes

SingleRequest

SingleRequest yes/no 有的snmp實作不支援一次請求多個snmp變更值,可以設定這個值強制mrtg一次請求一個屬性值

SnmpOptions

除了可以為每個目标指定單獨的逾時選項處,也可以在全局選項上配置snmpget程序的行為,SnmpOptions支援Hash選項,目前支援以下選項:

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

注意,這些選項會覆寫每個單獨的target中的的timeout值

IconDir

圖示目錄

LoadMIBs

載入指定的MIB檔案,可載入多個以’,'号分隔

Language

指定輸出語言,(檢查translate目錄看支援哪些語言)目前支援

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

LogFormat

LogFormat rrdtools,将激活rrdtools模式,這種模式下mrtg使用rrdtools來記錄日志

LibAdd

如果你激活了rrdtools模式并且rrdtool Perl子產品沒有安裝在perl能自行找到的位置,可以用來LibAdd來指定合适的路徑

PathAdd

如果rrdtool的可執行檔案不在目前的PATH中,可能通過PathAdd來指定

RunAsDeamon

yes/no 将mrtg作為守護程序來運作,大多數情況下mrtg是結合cron來定時運作的,在沒有設定重複運作時[比如在windows下],start /b perl mrtg.cfg,當然這裡要對應好目錄

ConversionCode

指定轉換代碼,有的snmp裝置提供的是非數值值,這對mrtg繪制圖形來說是沒有用的,是以要用一些代碼來轉換,這個關鍵字指定一個包含了轉換代碼的perl檔案,這個檔案中必須包含一個或多個函數,每個函數必須能夠接收處理一個字元串參數并傳回一個數值

針對每個Target的配置項

每個監控對象需要有一個唯一的名稱來辨別,這個名稱會被添加在屬用這個監控對象的屬性前,這名稱也會在日志檔案、圖像檔案和生成的網頁檔案中用到

Target[myrouter]: port:community@hostname[:[snmpport][:[timeout][:[retries][:[backoff][:[version]][|name]]]]]

port 為myrouter的接口,community為團體名,hostname為主機名或ip,snmpport為服務端的snmp端口,不填則預設為 161,timeout預設為2s,首次查詢逾時值,retries為查詢失敗時重試次數,backoff,退進指數,首次查詢失敗時,重試時間由 timeout值除以這個指數來決定,預設為1,即每次重試的逾時值一樣,version,snmp版本。

其中snmpport完整文法為:remote_port[!local_address[!local_port]],如下面這些示例

somehost

somehost:161

somehost:161!192.168.2.4!4000 use 192.168.2.4 and port 4000 as source

somehost:!192.168.2.4 use 192.168.2.4 as source

somehost:!!4000 use port 4000 as source

如果團體名和主機名中有’@'或者’ ‘空格,請用’\'來轉義,如: Target[bla]: 2:stu\ pi\@d@router

MaxBytes

監測對象允許達到的最大值,對于路由器流量來說一般是接口每秒能承載的最大位元組數

Title

生成html檔案的标題

每個Target的可選配置項

PageTop

被加入到生成網頁頂部的資訊,這個可以有多行,’\n’可用來斷行,這個是在html檔案中的段行,其實多行隻要以空格開頭,這一行就會被看成上一個關鍵字以來的續行,Ms,要用<h1></h1>辨別

RouterUptime

監測對象開啟時間

RouterName

裝置名

MaxBytes1

同MaxBytes 為snmpv1專用

MaxBytes2

同MaxBytes 為snmpv2專用

PageFoot

加入到頁面底部的資訊,基本上同PageTop

AddHead

跟PageTop差不多,不過這是加入到</title>到</head>之間的, 如:

AddHead[myrouter]: <link rev="made" href="">

BodyTag

自定義<body>标簽, 如:

BodyTag[myrouter]: <BODY LEFTMARGIN="1" TOPMARGIN="1"

BACKGROUND="/stats/p_w_picpaths/bg.neo2.gif">

AbsMax

監測值超過MaxBytes值時,顯示的值,這個主要是為了避免監測對象傳回一些錯誤值

Unscaled

WithPeak

預設情況下隻是個平均值

Suppress

預設情況下mrtg繪制4個圖,d w m y,分别是day,week,monty,year,可用來控制圖個數, 如,不繪制年圖

Suppress: y

Extension

可配置生成檔案的字尾名

Directory

mrtg對每個監測對象生成的檔案的放置目錄,這個可覆寫WorkDir

XSize 和 YSize

控制mrtg繪制的圖形的大小,Xsize在20到600之間,YSize要大于20

XZoom 和 YZoom

控制mrtg繪制的圖形數度,放用于綻放, 如:

XZoom[myrouter]: 2.0

YZoom[myrouter]: 2.0

XScale 和 YScale

官方建議不要用,會導緻圖形很難看

Ytics 和 YTicsFactor

Ytics每個圖形顯示的line數目,預設為4

Factor

Step

坐标步長值,預設為5 * 60 s

PNGTitle

生成圖檔名

Options

growright,圖檔預設向左的,這個選項用來控制方向,注意沒有growleft

bits, 決定監測值是否除8perminute,除60

perhour, 除3600

noinfo,不顯示開啟時間及裝置名

nopercent,不顯示使用%比

transparent,設定背景gif圖透明

integer,在每個圖形下以數值形式顯示統計行[不加',']

Colours

更改預設的顔色方案

Background

更改預設的網頁背景色

YLegend, ShortLegend, Legend[1234]

YLegend,y軸标簽,注意:如果名太長mrtg會忽略的

ShortLegend,可看作機關,預設是’b/s’,這個在最大值,平均值,目前值顯示時用到

Legend[1234IO],Color中的顔色值說明語句