reference - MRTG 2.9.22設定リファレンス
MRTGの実行時のふるまいは、設定ファイルによって支配されています。 普通の設定ファイルはcfgmakerを使って生成することができます (cfgmakerマニュアルをチェックしてください)。しかし、もっと複雑な設定を するには、手でチューニングする必要があります。
このドキュメントではMRTGの全てのオプションについて解説します。
MRTGの設定ファイルの書き方は、以下のようにいくつかの簡単なルールに則っています。
キーワードは行の先頭から始まらなければなりません。
キーワード行に続いて空白から始まる行は、そのキーワード行に追加されます。
空行は無視されます。
#で始まる行はコメントです。
Include: file
を使って他のファイルを取り込むことができます。
例:
Include: base-options.inc
WorkDirはログファイルとWebページが生成される場所を指定します。
例:
WorkDir: /usr/tardis/pub/www/stats/mrtg
HtmlDirは、html (もしくはshtml、これについては後で触れますが) ファイル がどこにあるかを指定します。
注: WorkDirはHtmlDirやImageDir、LogDirの設定を上書きします。
例:
Htmldir: /www/mrtg/
ImageDirは画像ファイルがどこにあるかを指定します。このディレクトリは htmlディレクトリの下にある必要があります。
例:
Imagedir: /www/mrtg/images
LogDirはログがどこに蓄積されるかを指定します。これはHtmlDirディレクティブ で指定したディレクトリ以下にある必要はありません。
例:
Logdir: /www/mrtg/logs
fork可能なシステム(例えばUNIX)では、MRTGはデータをSNMP経由で取ってくる 時に、複数のインスタンスにforkすることができます。
遅延が大きい時や非常にたくさんのデバイスがあるといった時にはこの機能に よって、かなり速くなるでしょう。となりの部屋に置いてあるスイッチ1つに クエリを送るような場合には速くなったりすることはありません。
私が知っている限りではNTはforkすることができませんのでこのオプションは NT上では使えません。
例:
Forks: 4
ブラウザ(Netscape)に、何秒後にリロードすればいいかを指示します。 これが定義されていない場合、デフォルトは300秒(5分)です。
例:
Refresh: 600
どれくらい頻繁にMRTGを呼び出すか。デフォルトは5分です。 頻度を下げる場合、ここで指定します。これにより以下の 二つのことが行われます。
生成されたHTMLページに呼び出し間隔の正しい情報が含まれます。
生成されたHTMLページのMETAヘッダにより、キャッシュはこのページの 生存期間がわかります。
この例では、MRTGに10分おきに呼び出すと指示しています。 もし5分毎に呼び出すならこの行はコメントアウトすれば いいでしょう。
例:
Interval: 10
このスイッチを使うことで、MRTGはCERNやApacheサーバ用に HTMLやGIFファイルのexpirationタグを含む.metaファイルを生成します。 *.metaファイルは他のファイルと同じディレクトリに生成されますので、 利用するためにはapache.confや.htaccessといったファイルで 「MetaDir .」や「MetaFile on」としなければなりません。
注: Apache 1.2もしくはそれ以降のものを使っているなら、同じ効果を得るために mod_expireを利用することができます。。。htaccess.txtというファイルを参照してください。
例:
WriteExpires: Yes
通常、SNMPデバイスに対して「sysUptime」、「sysName」といったプロパティ について問い合わせますが、これらを持っていないものもあります。 MRTGがプロパティがないと文句を言うのを避けたい場合、NoMib2オプションを 指定してください。
基本的なMIB2属性を実装していないエージェントの例にはComputer Associatesの Unicenter TNG Agentsがあります。CAは、システム管理を補うために、自身のエージェント に加えてベースとなるOSのSNMPエージョントにも依存します。
例:
NoMib2: Yes
複数のSNMP変数を一つのリクエストでまとめて問い合わせることができない ようなSNMPの実装があります。設定ファイルでこのディレクティブを利用す れば、MRTGはリクエスト毎に一つの変数について問い合わせるようになります。
例:
SingleRequest: Yes
ターゲット毎のタイムアウトのオプションは別にして、snmpgetプロセスの振舞いを もっと深いところまで設定することも可能です。SnmpOptionsはオプションのハッシュ を受けつけます。今のところ以下のオプションをサポートしています。
timeout => $default_timeout, retries => $default_retries, backoff => $default_backoff, default_max_repetitions => $max_repetitions, lenient_source_port_matching => 0, lenient_source_address_matching => 1
オプションの後にくる値は現在のデフォルト値を示しています。 これらの設定はターゲット毎のタイムアウト設定を「上書きする」ことに 注意してください。
例:
SnmpOptions: retries => 2, only_ip_address_matching => 0
AS/400 SNMPは
SnmpOptions: lenient_source_port_matching => 1
と設定しない限り、MRTGで監視することができないようです。
MRTGのアイコンをワーキングディレクトリ(もしくはImageDir)とは別の 場所に集めておきたい場合、IconDir変数を使ってアイコンディレクトリ のURIを指定してください。
例:
IconDir: /mrtgicons/
指定されたMIBファイルをロードし、そのOIDをシンボル名として利用可能にします。 さらに効率を上げるため、MIBのキャッシュはWorkDirで保持されています。
例:
LoadMIBs: /dept/net/mibs/netapp.mib,/usr/local/lib/ft100m.mib
出力フォーマットを選択した言語に切り換えます(どの言語がサポートされているかは 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
例:
Language: danish
mrtg.cfgファイルでLogFormatを「rrdtool」に設定すると、 RRDtoolモードが有効になります。RRDtoolモードでは、MRTGはロギングをrrdtool に任せます。グラフやHTMLは14all.cgiにより、その場で生成されます。14all.cgiは contribのセクションで簡単なREADMEとともにあります。この機能は Rainer Bawidamann <bawidama@users.sourceforge.net>によって提供されました。 さらなる情報は彼のWebサイトhttp://www.wh-hms.uni-ulm.de/~widi/14all/ をチェックしてください。
例:
LogFormat: rrdtool
もしRRDtoolモードなのにrrdtool Perl モジュール(RRDs.pm)がperlが発見できる ところにインストールされていない場合、LibAddを使って正しいパスを与えます。
例:
LibAdd: /usr/local/rrdtool/lib/perl/
rrdtoolの実行可能ファイルが通常のPATH内に見つからない場合、 このパラメータを使って適切なパスを加えます。
例:
PathAdd: /usr/local/rrdtool/bin/
RunAsDaemonキーワードはデーモンモードでの運用を有効にします。 デーモンモードの目的は、MRTGを一度起動しておけばネイティブモードのように cronで定期的に起動する必要がない、ということです。これにより、設定ファイル のロードとパースが一回で済み計算機資源を節約できます。
デーモンモードでは、MRTG自身は測定間隔のタイミングにのみ責任があります。 従って、Intervalキーワードを適切な値に設定することが重要です。
デーモンモードを利用する時にはMRTGはcronで定期的に起動してはならないことに 注意してください。そうしないとそれぞれのプロセスが永遠に動くことになってし まいます。代わりに、MRTGをコマンドプロンプトもしくはシステムの起動スクリプト から起動するようにします。
MRTGを特定のユーザ/グループの権限で動かしたい場合(MRTGをrootで起動するのは お勧めできません)、コマンドラインの--user=ユーザ名と--group=グループ名の オプションを使います。
mrtg --user=mrtg_user --group=mrtg_group mrtg.cfg
デーモンモードでは、設定ファイルを変更した場合には、それを反映するために プロセスの再起動が必要なことにも注意してください。
UNIXでは、DaemonスイッチによりMRTGは設定ファイルをチェックした後、forkして バックグラウンドに行きます。Windows NTではMRTGのプロセスがコンソールから 切り離されるがNT/2000のシェルはその子供を待っているため、プログラムを 起動する時に特別な起動シーケンスを利用しなければなりません。
start /b perl mrtg mrtg.cfg
コマンドラインからMRTGを起動する時、パス情報も加えなければならないかもしれません。
例:
RunAsDaemon:Yes Interval:5
これの設定により、MRTGはデーモンとして動き、5分おきにデータを収集します。
監視するターゲットはそれぞれユニークな名前で同定できなければいけません。 この名前はターゲット毎のそれぞれのパラメータに付加されます。この名前はまた、 生成されるWebページ、ログファイルそしてイメージの名前にも使われます。
TargetキーワードによりMRTGに何を監視するのかを教えます。 Targetキーワードは広範なフォーマットの引数を取ります。
例:
Target[ezwf]: 2:public@wellfleet-fddi.ethz.ch
もしコミュニティ名に「@」や「 」が含まれているなら、これらの 文字は「\」でエスケープしなければなりません。
Target[bla]: 2:stu\ pi\@d@router
例:
Target[ezwf]: 2:public@router1:::::2
例:
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
特に、二つの異なるOIDそしてもしくは「&」によって分けられたインタフェース を図示する時などは、与えられたIPアドレスが同じターゲットのルータで使われて いることを確認してください。
--ifref=ipオプションによりcfgmakerにそのようなリファレンスを 作らせることができます。
例:
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.3.6.1.2.1.2.2.1.14/1.2.3.4:public@myrouter Target[ezwf]: ifInErrors/1.2.3.4&ifOutErrors/1.2.3.4:public@myrouter
そのようなリファレンスはcfgmakerに--ifref=descrオプションを付ける ことで生成可能です。
例:
Target[ezwf]: \My-Interface2:public@wellfleet-fddi.ethz.ch Target[ezci]: -\My-Interface2:public@ezci-ether.ethz.ch Target[ezwf]: 1.3.6.1.2.1.2.2.1.14\My-Interface2&1.3.6.1.2.1.2.2.1.14\My-Interface3:public@myrouter Target[ezwf]: ifInErrors\My-Interface2&ifOutErrors\My-Interface3:public@myrouter
もし記述に「&」、「:」、「@」、「 」といった文字が含まれているなら、 それらを使うことはできますが、次のようにバックスラッシュでエスケープ してください。
Target[ezwf]: \fun\: \ ney\&ddd:public@hello.router
cfgmakerを--ifref=nameオプションを付けて起動すればそのようなリファレンス が生成されます。
例:
Target[ezwf]: #2/11:public@wellfleet-fddi.ethz.ch Target[ezci]: -#2/11:public@ezci-ether.ethz.ch Target[ezwf]: 1.3.6.1.2.1.2.2.1.14#3/7&1.3.6.1.2.1.2.2.1.14#3/7:public@myrouter Target[ezwf]: ifInErrors#3/7&ifOutErrors#3/7:public@myrouter
もし記述に「&」、「:」、「@」、「 」といった文字が含まれているなら、 それらを使うことはできますが、次のようにバックスラッシュでエスケープ してください。
Target[ezwf]: #\: \ fun:public@hello.router
#は、それがその行の最初の非空白文字であった場合にはコメントであると解釈されるので 注意してください。
OIDと区切り文字「!」(IPアドレスオプションと同じ) の後に 物理アドレスを追記することによって、物理アドレスをあらゆる タイプのTarget定義に使用することができます。物理アドレスは 「0a-0-f1-5-23-18」(括弧は省略すること) のように「-」で区切って 指定します。ある種のルータはすべてのインタフェースに同じハードウェア Ethernetアドレスを使用するため 個別に認識することができません。MRTGはそういった問題を 察知し、警告を出します。
--ifref=ethというオプションを使用してcfgmakerにハードウェア アドレスを参照する設定ファイルを生成させることができます。
例:
Target[ezwf]: !0a-0b-0c-0d:public@wellfleet-fddi.ethz.ch Target[ezci]: -!0-f-bb-05-71-22:public@ezci-ether.ethz.ch Target[ezwf]: 1.3.6.1.2.1.2.2.1.14!0a-00-10-23-44-51&!0a-00-10-23-44-51:public@myrouter Target[ezwf]: ifInErrors!0a-00-10-23-44-51&ifOutErrors!0a-00-10-23-44-51:public@myrouter
--ifref=typeオプションを使用して、cfgmakerにこのような参照 を生成させることができます。
例:
Target[ezwf]: %13:public@wellfleet-fddi.ethz.ch Target[ezci]: -%13:public@ezci-ether.ethz.ch Target[ezwf]: 1.3.6.1.2.1.2.2.1.14%13&1.3.6.1.2.1.2.2.1.14%14:public@myrouter Target[ezwf]: ifInErrors%13&ifOutErrors%14:public@myrouter
community@router[:[port][:[timeout][:[retries][:[backoff][:version]]]]]
各パラメータの意味は以下の通り:
例:
3:public@router1:::::2
デフォルトと変わらない値は省略することが可能です。後に続くコロンも 省略することができます。
例:
Target[ezci]: 1:public@ezci-ether.ethz.ch:9161::4
これはUDPポート9161をリッスンしているSNMPエージェントが 理解しているezci-ether.ethz.ch上のインタフェース、 ifIndex 1の入出力オクテットカウンタを参照します。 デフォルトのタイムアウト (2.0秒) が使用されますが、 リトライ回数は4に設定されています。backoffの値はデフォルトです。
外部コマンドは4行の出力を返す必要があります:
最初の値の現在の状況。通常は「入力バイトのカウント」
2番目の値の現在の状況。通常は「出力バイトのカウント」
監視対象の稼働時間を示すストリング (人間が読めるフォーマットで)。
監視対象の名前を示すストリング
スクリプトが返す値によっては、Optionsキーワードに 'gauge'または'absolute'を使用する必要があります。
例:
Target[ezwf]: `/usr/local/bin/df2mrtg /dev/dsk/c0t2d0s0`
コマンドを囲むにはアポストロフィ (') ではなくバックティック (`) を使用するところを注意してください。
もしコマンド名にバックティックを使用したい場合には、 バックスラッシュでエスケープすることができます......
いくつかの文には数学的な式を用いることが可能です。 ISDNのふたつのBチャンネルや、より太い帯域を確保するためにひとつに 束ねられた複数のT1回線をまとめたりするのに使います。
例:
Target[ezwf]: 2:public@wellfleetA + 1:public@wellfleetA
* 4:public@ciscoF
監視されている2つの値が到達できる最大値。ルータの トラフィックを監視している場合、通常このポートが転送 可能なバイト/秒で指定します。
もしMaxBytesより高い数値が返された場合は無視されます。 詳細についてはAbsMaxセクションも読んでください。 MaxBytesは スケールされてないグラフのY軸の幅を算出 するのにも使用されます (Unscaledセクションを参照のこと)。
たいていの回線レートはビット/秒であることから、バイト/秒を 求めるにはその最大帯域幅(ビット)を8で割る必要があります。 これはスケールされないグラフが正確な情報を表示するのに 非常に重要なことです。それぞれT1 = 193000, 56K = 7000, Ethernet = 1250000 になります。MaxBytesの値は、ルータから有効なレスポンスが 返ってきたのかMRTGが判断するのに使用されます。
もし2つの監視対象の値に別々のMaxBytesの値を設定 したい場合には、MaxBytesの代わりにMaxBytes1とMaxBytes2を 使用する事が出来ます。
例:
MaxBytes[ezwf]: 1250000
グラフ表示用に生成されるHTMLページのタイトル。
例:
Title[ezwf]: 私たちの素晴らしい会社のためのトラフィック解析
生成されるHTMLページのトップに追加するもの。最初の欄が 空白になっている複数の行で構成する事が出来ます。
全ての行はHTMLページ内で一行にまとめられてしまうこと に注意してください。生成されるHTML内で改行して欲しい 場合には「\n」を使用してください。
例:
帯域使用率を複数のインタフェースから算出した場合、 ルータの稼働時間と名前がWebページに表示されない場合があります。
もしこれらのインタフェースが同一のルータ上にあり、 稼働時間も名前も表示させたい場合には、RouterUptime キーワードでそのコミュニティ名とアドレスを指定し直す 必要があります。
例:
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
MaxBytesと同じ、1つ目の値に適用。
MaxBytesと同じ、2つ目の値に適用。
生成されるHTMLページの下部に追加されるもの。最初の欄が 空白になっている複数の行で構成する事が出来ます。
全ての行はHTMLページ内で一行にまとめられてしまうこと に注意してください。生成されるHTML内で改行して欲しい 場合には「\n」を使用してください。
</BODY>タグの直前に追加されます。
例:
PageFoot[ezwf]: このページに関する質問は、 <A HREF="mailto:peter@x.yz";>Peter</A>までお寄せください
PageTopヘッダのように使用します。内容は</TITLE>と </HEAD>タグの間に追加されます。
例:
AddHead[ezwf]: <link rev="made" href="mailto:mrtg@blabla.edu";>
生成されるWebページに独自の<body ...>を使うことができます。
例:
BodyTag[ezwf]: <BODY LEFTMARGIN="1" TOPMARGIN="1"
BACKGROUND="/stats/images/bg.neo2.gif">
もし回線がコンプレッションを使用していたりフレームリレー などでMaxBytesを超えるトラフィックをハンドルする場合、 AbsMaxキーワードを使用して絶対的な最大値を指定することが できます。この設定はルータから返される非現実的な値を区別する ために必要になります。もしAbsMaxを設定しなかった場合、 rateupはMaxBytesより高い値をすべて無視します。
例:
AbsMax[ezwf]: 2500000
デフォルトではMaxBytesよりかなり低い数値でも表示されるように、 各グラフは垂直方向にスケーリングされます。Unscaled 変数でこれをやめさせることができます。この引数はストリングで、 スケールしたくないグラフを1文字で表したもの: d=day w=week m=month y=year を含みます。例では年毎、月毎の グラフでスケーリングを止めます。
例:
Unscaled[ezwf]: ym
デフォルトでグラフは監視している変数 - 通常 incoming / outgoing トラフィックの転送レートの平均値しか表示しません。 このオプションはMRTGに5分間の最高値を [w]eekly、[m]onthly そして[y]earlyグラフで表示させます。例では月毎と年毎の グラフが最高値と平均値を同時に表示するよう定義しています。
例:
WithPeak[ezwf]: ym
デフォルトではMRTGは4つのグラフを生成します。この オプションを使用して生成されるグラフを選択すること ができます。オプション値の文法は、前出の2つのオプション と同じです。この例では使用始めではしばらく何も表示されない 年毎のグラフを省略しています。
例:
Suppress[ezwf]: y
デフォルトではMRTGは .htmlファイルを生成します。この オプションを使用してMRTGに違う拡張子を使うよう指示する ことができます。例えば拡張しをphp3にすれば、PHPタグを 出力に含むことができます (データベース参照してルータ名を 呼び出すときなどに便利です)
例:
Extension[ezwf]: phtml
デフォルトではMRTGは生成するファイル全て(PNG、HTMLページ、ログ ファイル等)をWorkDirに置きます。
Directoryオプションが指定されている場合、ファイルは WorkDirの代わりにLog-、Image- や HtmlDir-などに格納 されます。(例えば下記のDirectoryオプションでは監視対象ezwfの ファイルを全て/usr/tardis/pub/www/stats/mrtg/ezwf/ ディレクトリ下 に置きます。)
既存のディレクトリを指定してください。MRTGはディレクトリを 作成しません。
例:
WorkDir: /usr/tardis/pub/www/stats/mrtg Directory[ezwf]: ezwf
注: Directoryオプションは「相対的」でなければなりません。 そうしない場合、悪いことが起こるでしょう。
デフォルトではMRTGのグラフは 100 x 400ピクセルです。(それに ラベルの分が追加されます)。例ではほぼ正方形のグラフを作成 します。
注: XSizeは20から600の間でなくてはなりません; YSizeは20より大きい 必要があります。
例:
XSize[ezwf]: 300 YSize[ezwf]: 300
より大きなピクセルでグラフを表示させたい場合には「Zoom」 することができます。
例:
XZoom[ezwf]: 2.0 YZoom[ezwf]: 2.0
もしグラフを実際に拡大・縮小させたいなら、XScaleとYScaleを 使用してください。(できることにはできますが、結果は正直なところ 不格好です) もしどなたか直したいと思われた方は: パッチの提供、 歓迎します。
例:
XScale[ezwf]: 1.5 YScale[ezwf]: 1.5
4つ以上の横罫線をグラフに表示させたい場合にはYTicsを使用して ください。これらの罫線のYLegendの値をスケールしたい場合に は、YTicsFactorを使用して下さい。YTicsのデフォルト値は 4で、YTicsFactorは1.0です。
例:
例えば 0から700の範囲の値を取得する場合、7本の線を 配置し、 0、100、200、300、400、500、600、700にする 代わりに0、1、2、3、4、5、6、7と表示させたいとしましょう。 その場合には:
YTics[ezwf]: 7 YTicsFactor[ezwf]: 0.01 と記述します。
グラフ内に表示させる数値に常にいくつか掛けたい場合 にはこのディレクティブを使用してそれを指定してください。
例:
Factor[as400]: 4096
デフォルトのステップ 5 * 60秒を変更します。 (まだよく試してません……)
例:
Step[ezwf]: 60
Optionsキーワードでブールスイッチを設定することが できます:
「gauge」や「absolute」オプションが指定されていない場合、MRTGは変数をカウンタとして扱い、現在とひとつ前の値の差を計測した時間で割って書きだす値を取得します。
上記と同じですが、「O」または2番目の変数が関係しているというところが違います。
例:
Options[ezwf]: growright, bits
接頭辞を計算する際に使用する乗数の数値を変更するオプションです。デフォルトは 1000 です。1kB = 1024B、1MB = 1024kBなどとしたい場合に使用します。
例:
kilo[ezwf]: 1024
デフォルトの乗数の接頭辞(,k,M,G,T,P)を変更します。ShortLegendタグは基本単位のみを定義します。 書式: カンマ区切りの接頭辞のリスト。2つの連続したカンマや文頭文末のカンマはその項目に接頭辞を付けません。 注: もし接頭辞がいらない場合、この行は空行にしてください。
例: nm/s (ナノメータ/秒) の速度を nm/hで表示。
ShortLegend[ezwf]: ナノメータ/時間 kMG[ezwf]: n,u,m,,k,M,G,T,P options[ezwf]: perhour
Coloursタグでデフォルトの色を変えることができます。 注: 4つすべての色が指定されている必要があります。色名 (以下の「Colx」) は凡例で表示される色の名前で、RBG値でグラフとHTML両方で使用される実際の色を指定します。
書式は: Col1#RRGGBB,Col2#RRGGBB,Col3#RRGGBB,Col4#RRGGBB になります。
重要: もしdorelpercentオプションを使用している場合には、5番目の 色名と値が必要になります: Col1#RRGGBB,Col2#RRGGBB,Col3#RRGGBB,Col4#RRGGBB,Col5#RRGGBB
例:
Colours[ezwf]: GREEN#00eb0c,BLUE#1000ff,DARK GREEN#006600,VIOLET#ff00ff
Backgroundで生成される HTMLページの背景色を指定することができます。
例:
Background[ezwf]: #a0a0a0a
以下のキーワードでグラフやHTMLドキュメント内の さまざまな凡例を書き換える事が可能です。
例: YLegend[ezwf]: ビット/秒 ShortLegend[ezwf]: b/s Legend1[ezwf]: 入力トラフィック ビット/秒 Legend2[ezwf]: 出力トラフィック ビット/秒 Legend3[ezwf]: 5分間で最大の入力トラフィック Legend4[ezwf]: 5分間で最大の出力トラフィック LegendI[ezwf]: In: LegendO[ezwf]: Out:
注意、もしLegendI や LegendOが
LegendO[ezwf]:
のように空行になっていた場合、対応するグラフ線は表示されません。
もし国際的な世界に住んでいるなら、グラフを違うタイムゾーンで 生成する必要があるかもしれません。これはTZ変数で設定されて います。Solarisのようなある種のオペレーティングシステムでは、 選択したタイムゾーンで時間を表示するために、localtimeをコール します。
例:
Timezone[ezwf]: Japan
TimezoneはJapan、Hongkong、GMT、GMT+1といった Solaris標準のタイムゾーンです。
デフォルトではMRTG (正確にはrateup)は月間グラフの週番号を フォーマットするのにstrftime(3)の'%W'オプションを使用します。 このフォーマットオプションの正確な解釈はシステム間で異なります。もし 週番号が間違っていることに気がついたら、そしてあなたのシステム がstrftime(3)ルーチンがサポートしているなら、違うオプションを 試すことができます。POSIX '%V'オプションがよく使われている ようです。
例:
Weekformat[ezwf]: V
新しくrrd ファイルを生成する際に影響します。初期状態では rrd ファイルは1日分の詳細データを保持します（加えて、1週間分の30分 のデータ、2ヶ月分の2時間のデータ、それに2年分の1日のデータを）。 このキーワードで、新しく作られるrrdファイルの基本となるインター バルを変更することができます。計算の際にこのインターバルを考える 必要があることを忘れないでください。
例：
RRDRowCount[ezwf]: 1600
cfgファイル内で外部のスクリプトを呼ぶ場合 (しきい値 や監視対象になっているスクリプト) 、SetEnv設定オプショ ンで環境変数を設定することによって、その外部スクリプト になんらかのデータを送ることができます。
例:
SetEnv[myrouter]: EMAIL="contact_email@someplace.net"
HOST="www.some_server.net"
URL="http://www.some_server.net/path/mrtg.html"
MRTGはさまざまな監視対象のしきい値の問題をチェックすることができ、外部スクリプトを呼ぶことによって問題解決の手助けをします(メールを送ったり、管理者のポケベルを鳴らしたり)。
しきい値のチェックは下記のパラメータで設定可能です:
ThreshDirを書き込み可能なディレクトリに設定することで、 MRTGはしきい値を超えた時のみ警告を発します。
例:
ThreshDir: /var/mrtg/thresh
入力(1つめの)パラメータで受けつけられる最小の値です。もしパラメータがこの値を割ったとき、ThreshProgIで指定してあるプログラムが走ります。もし値が「%」で終っている場合にはしきい値はMaxBytesと連動して定義されます。
入力(1つめの)パラメータで受けつけられる最大の値です。もしパラメータがこの値を超えたとき、ThreshProgIで指定してあるプログラムが走ります。もし値が「%」で終っている場合にはしきい値はMaxBytesと連動して定義されます。
この値は、以下で設定されるプログラムが呼び出される前に環境変数THRESH_DESCとして設定されます。プログラムはユーザーフレンドリな出力をするためにこの値を使用することができます。
ThreshMinIやThreshMaxIが破られた時に走るプログラムを定義します。MRTGは3つの引数を渡します: $router変数、破られたしきい値の値、それに現在のパラメータの値です。
(ThreshMinI と ThreshMaxI を基準にして) それまでThreshDirにあったファイルによると異常だったパラメータが、現在正常に戻った場合に走るプログラムを定義します。MRTGは3つの引数を渡します: $router変数、破られていないしきい値の値、それに現在のパラメータの値です。
*Iと同じ様に動作で出力(2番目の値)に作用します。
注、前述のSetEnvパラメータを使用して、しきい値用プログラムにより多くの情報を渡すことができます。
タイプの手間を省くために、「^」と呼ばれるターゲットを定義することができます。このターゲットに指定したテキストのキーワードは、記述されている行以下 すべてのTargetの該当するキーワードの文頭に追加されます。「$」も同様ですが、こちらは文末に追加します。
キーワードの値と文頭、文末に追加されるテキストの間には空文字が追加されることに注意して下さい。テキストで指定するキーワードには大変有効ですが、その他のキーワードではあまり役に立ちません。以下の「デフォルト」ターゲットの説明をご覧下さい。
例では、このファイルのこれ以下の行で定義されているTargetに対して、生成されるページすべてに一般的なヘッダと連絡先をMRTGが挿入するようにしています。
例:
PageTop[^]: <H1>どこにもないユニットのトラフィック統計</H1><HR> PageTop[$]: 質問はPeter Nortonまでお問い合わせ下さい<HR>
接頭・接尾辞の値を削除するには、以下のように空の値を指定してください。
PageTop[^]: PageTop[$]:
注: ローカルの値と接頭・接尾辞の間に通常空文字が追加されます。これを望まない場合には、$や^の最後に付けることによって空文字を除去する文字を NoSpaceChar設定オプションで定義することができます。
例:
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]: b.tolna.net Target[c]: c.tolna.net Target[d]: d.tolna.net
ターゲット名「_」はそのキーワードのデフォルト値を指定します。明示的なキーワードの値や、接頭接尾辞のキーワードが指定されていない場合、このデフォルト値が使用されます。
例:
YSize[_]: 150 Options[_]: growright,bits,nopercent WithPeak[_]: ymw Suppress[_]: y MaxBytes[_]: 1250000
デフォルト値を削除し「工場出荷時状態」に戻すには、以下のように空の値を設定します:
YLegend[_]:
設定ファイルの中にはデフォルト/接頭辞/接尾辞の値が複数指定してある場合があります。より後に指定してあるものが、設定ファイルの残りの行で前出の値を置き換えます。指定したキーワード/Targetペアで使用されるデフォルト/接頭辞/接尾辞の値は、設定ファイルの中で最初にその監視対象が出現した時に有効なものになります。
例:
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.somplace.edu.2のMaxBytesのデフォルトの値は、ターゲット名がmyrouter.somplace.edu.2最初に出現した時点で有効だった1250000が使用されます。
_lを追加したものになります)
.okを追加したものになります)
注: MRTG用のMessage DLLはありません。WindowsのイベントロッガーがMRTGがMessage DLLを持っていないという素敵なメッセージをすべてのイベントログへのエントリに関して表示します。もしWindowsユーザで協力してくださる方がいらっしゃいましたら、歓迎します。
WorkDir: /usr/tardis/pub/www/stats/mrtg Target[r1]: 2:public@myrouter.somplace.edu MaxBytes[r1]: 8000 Title[r1]: ISDNのトラフィック解析 PageTop[r1]: <H1>私たちのISDN回線の状況</H1>
WorkDir: /usr/tardis/pub/www/stats/mrtg Title[^]: トラフィック解析 PageTop[^]: <H1> PageTop[$]: の状況</H1><BR>お気づきの点はチーフに連絡して下さい。<HR>
MaxBytes[_]: 8000 Options[_]: growright
Title[isdn]: 私たちのISDN回線 PageTop[isdn]: 私たちのISDN回線 Target[isdn]: 2:public@router.somplace.edu Title[backb]: 私たちのキャンパスバックボーン PageTop[backb]: 私たちのキャンパスバックボーン Target[backb]: 1:public@router.somplace.edu MaxBytes[backb]: 1250000
# 以下の行は上記で定義されたデフォルトで前に # 追加される値を削除します
Title[^]: Title[isdn2]: バックアップISDN回線のトラフィック PageTop[isdn2]: 私たちのISDN回線 Target[isdn2]: 3:public@router.somplace.edu
Tobias Oetiker <oetiker@ee.ethz.ch> と多くの協力者達
花井 浩之、橋本 理央 <e2j@mrtg.jp>