《MRTG配置文档》由会员分享，可在线阅读，更多相关《MRTG配置文档（23页珍藏版）》请在金锄头文库上搜索。
1、MRTG 2.16.2 配置参考手册-1(完成 60%左右了,翻译 ing)翻译完了，终于松口气。-2009.2.3欢迎转载。更希望大家一起来修正里面的错误，能给我发个邮件说下就更感激不尽了。Email：ZHLMRTG 运行时的行为是由一个配置文件控制的。这个配置文件可以用 cfgmaker生成。（请参考 cfgmaker 的手册）。但是更加详细精巧的配置还是需要手工进行的。这篇文档介绍了 mrtg 使用的所有配置选项。语法MRTG 配置文件语法遵循一些简单的规则：* 管检测必须在一行的开头。* 在一个关键词行之后的以空格开头的每一行都是关键词行的后继行。* 空行被忽略。* 以#开头的行是注释
2、行。* 你可以使用 Include: file 的形式把其它的文件导入配置文件。例子：include: base-option.inc如果被包含的文件被相对路径指定，包括当前目录和包含主配置文件的目录都会被搜索。全局配置关键词WorkDirWorkDir 指定日志文件和网页文件的生成文件。例子：WorkDir: /usr/tardis/pub/www/stats/mrtg可选全局关键词HtmlDirHtmlDir 指定 html（或者 shtml，这个会在以后被支持）生成的位置。注意：WorkDir 会覆盖 htmldir 和 imagedir、logdir 的设置。例子：Htmldir：/w
3、ww/mrtg/ImageDirImageDir 指定存放生成的图片的文件夹。这个文件夹应该设置在 html 文件夹内。例子：Imagedir：/www/mrtg/imagesLogDirLogDir 指定存放日志的文件夹.这不必放在 htmldir 文件夹内.例子:Logdir：/www/mrtg/logsForks( UNIX only)在支持 Fork 的系统之中（例如 UNIX）,当 mrtg 需要通过 snmp 获取数据的时候，它能 fork 自己成为多个实例。在高延迟或者存在大量设备的情况下，这能极大的提高效率。如果你的那台交换机就在隔壁，那它可能不会提高你的查询速度。据我所知，N
4、T 不能 fork，所以这项功能在 NT 中不能使用。例子：forks： 4EnableIPv6当把值设置为 yes 时，如果相应的库文件存在（请参考 mrtg-ipv6 手册页），那么 IPv6 就可以启用了。这样 IPv6 功能就启用了，mrtg 就能够和基于 IPv6 的路由器及其它对象的snmp 进行通讯，它们可能使用了 IPv6 来指定地址。如果 IPv6 被启用并且对象是一个主机名，mrtg 将尝试解析主机名为 IPv6 地址，并且如果失败了，再解析为 IPv4 地址。注意如果指定了 IPv4 地址或者设置了主机名，但是没有设置 IPv6 地址，mrtg将仅使用 IPv4；mrtg
5、 如果使用 IPv6 通讯失败，将不会使用 IPv4。这是设计中实现的。注意现在许多的路由器没有支持基于 IPv6 的 SNMP。这些路由器将使用IPv4Only 选项。IPv6 默认是关闭的。例子：EnableIpv6：yes-EnableSnmpV3当这一项参数化设置为 yes 的时候，将使用 Net:SNMP 模块替代SNMP_SESSION 模块来生成 snmp 请求。如果 snmpv3 参数被设置了，这将允许使用 SNMPv3。SNMPv3 默认是关闭的。例子：EnableSnmpV3：yes-Refresh浏览器应该多长时间重新加载页面？如果没有指定的话，默认使 300 秒（5 分
6、钟）。例子：Refresh:600-Interval你多长时间调用一次 mrtg 呢？默认是 5 分钟。如果频率比较低的话，你应该在这里指定。这将完成两个任务：生成的 HTML 页面包含正确的关于间隔的信息.在生成的 HTML 页面中包含正确的 META 设置.下面的例子我们让 mrtg 每 10 分钟运行一次。如果你让 mrtg 每 5 分钟运行一次，你可以注释掉这一行。例子：Interval：10注意：除非你使用 rrdtool，你不要把间隔设置的小于 5 分钟。如果你使用rrdtool，你可以用这样的格式来设置时间间隔Interval:MMSS甚至可以设置间隔为 1 秒。然而还是要注意，
7、间隔的设置会影响 rrdtool 和 mrtg对于数据库的初始化。如果以后你改变了间隔的设置，所有已经存在的数据库将保持初始化时候的解析度。也要注意你的 mrtg-rrd 的 web 前端是否支持这种设置。-MaxAgeMRTG 非常的以来计算机的时间。如果时间设置有错误，特别是比当前时间快很多，会引起 mrtg 把日志文件中的数据当成过期数据来处理。为了避免这样的情况发生，你可以对日志文件指定最大容忍时间来进行“合理性检查”，如果文件看上去很老了，mrtg 先不会操作这个文件，而是发出抱怨（警告），给你一个机会来检查原因。例子：MaxAge:7200上面的例子中 mrtg 将不会更新过期两小
8、时的数据（7200 秒）。-WriteExpires这个选项将使得 mrtg 为 CERN 和 Apache（其中包含 Expirations 标签的）生成.meta 文件。这些*.meta 文件将会在与其它文件相同的目录里面创建，为了能够保证它正常运行，你将需要在 Apache.conf 或者.htaccess 文件设置“MetaDir.”和“MetaFiles on”。注意：如果你运行的是 Apache-1.2 或者更新版本，你能够使用 mod_expire 来达到同样的效果.请参考 htaccess.txt。例子：WriteExpires:yes-NoMib2正常情况下我们会查询设备的“
9、sysUptime”（运行时间）和“sysName”（系统名称）。但是一些设备没有这些信息。如果你想避免 mrtg 生成相关警告，请设置 nomib2 选项。一个不提供基本的 mib2 属性信息的例子是 Computer Associates - Unicenter TNG 代理。CA 除了使用它自己的代理外还依赖 OS 的 SNMP 代理来提供系统管理功能。例子：NoMib：yes-SingleRequest一些 SNMP 实现不能支持一次查询多个 snmp 变量。设置这个参数可以强迫 mrtg每次只查询一个变量。例子：SingleRequest：yes-SnmpOptions除了每个监控对
10、象的超时选项可设置外，你还能够更详细的配置 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选项后面的值是默认值。注意这些设置会覆盖每个监控对象的超时设置。每个监控对象的
11、 SnmpOptions将会覆盖全局设置.这个关键词主要是为了在SNMPv3 中使用.16bit 的请求 id 是对 SMC 堡垒路由器进行请求查询的唯一方法.例子:SnmpOptions: retries = 2, only_ip_address_matching = 0注意 AS/400 的 snmp 似乎不太配合 mrtg,除非这样设置:SnmpOptions: lenient_source_port_matching = 1-IconDir如果你想把 mrtg 的图标保存在某个文件夹中,既不是工作目录,也不是imageDir,那么使用这个选项来定义 icon 的目录.例子:IconDi
12、r: /mrtgicons/-LoadMIBs加载指定的 MIB 文件并让其中的 OID 可以用字符名字引用.为了获得更好的效率,mrtg 在 WorkDir 中维护一个 MIB 缓存.例子:LoadMIBs: /dept/net/mibs/netapp.mib,/usr/local/lib/ft100m.mib-Language使用这个选项来产生指定语言的结果(检查翻译目录来查看你的 mrtg 支持多少种语言.在这个目录中你还能找到一些说明,关于怎样支持新的语言.)目前支持下面几种语言:big5 brazilian bulgarian catalan chinese croatian cze
13、ch danish dutch eucjp french galician gb gb2312german greek hungarian icelandic indonesia iso2022jp italian korean lithuanian malay norwegian polishportuguese romanian russian russian1251 serbian slovak slovenian spanish swedish turkish ukrainian例子:Language:danish-LogFormat设置这个选项的值为 rrdtool 就启用了 rrd
14、tool 模式.在这种模式中,mrtg 依靠rrdtool 来做日志.请参考 mrtg-rrd.例子:LogFormat:rrdtool-LibAdd如果你使用了 rrdtool 模式并且你的 rrdtool 的 perl 模块(RRDs.pm)不能被perl 自身找到,你可以使用这个选项来提供相应的路径.例子:LibAdd: /usr/local/rrdtool/lib/perl/-PathAdd如果 rrdtool 的可执行部分在正常的PATH中不能被找到,你可以使用这个关键词来给你的 PATH 增加一个适合的目录.例子:PathAdd: /usr/local/rrdtool/bin/-RunAsDaemon这个参数启用 daemon 模式来运行 mrtg。守护模式就是指 MRTG 只运行一次，而不是反复的运行（因为它是使用 cron 运行的。）这会节省计算资源的，因为只在开始的时候对配置文件进行一次加载和分析。使用 daemon 模式，MRTG 自己对时间间隔进行控制。因此为“interval”选项设置一个合适的值是很重要的。如果你想让 mrtg 以某个特定的用户和组来运行（不推荐使用 root 身份运行mrtg），那么在命令行运行 mrtg 时请使用-user 和-group 参数。例子：mrtg -user=mrtg_user -group=mrtg_group mrt
