天天看点

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中的颜色值说明语句