名称

snmpgraph − snmppoll で集めたデータをプロットするツール

形式

snmpgraph [−all|[dual,single,log]] [−compress] [−[echo|verbose]] [−[graph|xscale]] [−noprint] [−plotter] [−vars] [−[date|Dailysave|Dailyplot] mmddyy] file(s)

解説

snmpgraph は、各インターフェースについて、管理対象となっている変数のグラフを 作成するツールです。 グラフは、各インターフェース毎に指定された変数について作成されます。 入力ファイルは、圧縮形式の snmppoll のデータファイルです。 これらのファイルは、−date で指定されない限りカレントディレクトリに 存在するものと仮定されます。 −Dailysave オプションや、−Dailyplot オプションを指定した ときは、入力ファイル名は省略することができます。 以下にコマンドラインから指定できるオプションを示します。 （括弧の中は、省略形です）

-date <日付> (-d)
このオプションと共に処理したい日付を指定してください。 ファイル名が指定された場合、それが処理対象となります。

-xpand (-x)
指定されたファイル名を、∗<arg>∗ の形に展開します。 date オプションと共に用いられます。 [例えば、"snmpgraph -date 021289 -xpand nyu col-cnl alb-" は、.../data/021289/ ディレクトリの、 col-nyu.t1.Z nyu-blan.eth.Z nyu-col.t1.Z nyu-lan.eth.Z nyu-rock.t1.Z nyu-rpi.t.Z rock-nyu.t1.Z rpi-nyu.t1.Z col-cnl.t1.Z alb-lan.eth.Z alb-rpi.ds0.Z を対象ファイルとします。]

-log (-l)
全ての変数とエラーを対数座標でグラフ化します。 これは、エラー、パケット数、オクテット数等、単位の違う情報を 同時にグラフ化し、各情報の重要度を知る為に役立ちます。 各エラーは、以下に示す 1 文字で、示されます。

Transmit        Receive         Interface
F  framing      f  framing      s  selftest
U  underrun     o  overrun      m  maintenance
C  DCD          c  crc
T  CTS          a  abort
S  DSR

-single (-s)
変数ごとにグラフを作成します。 このオプションを使用すると、InOctets, OutOctets, InUcastPkts, OutUcastPkts の 4 つのページがインターフェース毎に作成されることになります。

-dual (-d)
1 つのページに 2 つの変数についてのグラフを作成します。 (eg. In and Out Octets, or In and Out Packets) インターフェース毎に、オクテット数のページと、パケット数のページの 2 ページが 作成されます。

-all (-a)
このオプションは、single, dual, log の各オプションが指定されたのと同じです。 各インターフェースについて 7 つのグラフが作成されます。

-echo (-e)
当プログラム内の各ループで、入力ファイル名とインターフェース名を表示します。

-verbose (-v)
当プログラムの実行を、csh で ’set verbose’ したのと同様に、 エコーバックします。

-compress (-Z)
入力ファイルを処理しながら、圧縮します。

-noprint (-np)
プロットプログラムを呼びだすためのデータとコマンド群を作成しますが、 実際にプロットプログラムを呼びだすことまではしないモードです。 このモードでは、当プログラムが終了してもプロットデータは削除されません。

-vars <変数群>
グラフ化したい変数群を指定します。 (有効なのは、single モードのときだけです)

-graph <フィルター名>
グラフ化するのに使用するプログラムを指定します。 通常は、graph が使用されます。

-xscale <"最小値 最大値">
 X 軸のスケールを指定します。

-plotter <フィルター名> (-p)
プロットプログラムを指定します。 通常は、psplot が使用されます。

-Dailysave <日付> (-DS)
このオプションでは、指定された日付のデータを処理して、 あとはプロットするばかりのデータと、シェルスクリプトを PLOTDIR で指定されたディレクトリに格納します。 プロットは、実行されません。

-Dailyplot <日付> (-DP)
PLOTDIR にすでに格納されているデータをプロットします。 日付のみを指定した場合は、全てのインターフェースが、 ファイル名も指定された場合は、それらのファイルが処理対象となります。

環境変数

This script is currently set up to use the psplot output device; this may be altered within the script for those of you who do not have access to this software.  当ツールは、snmppoll から得られる以下の MIB 変数値を対象とします。

_mgmt_mib_interfaces_ifTable_ifEntry_ifInOctets_
_mgmt_mib_interfaces_ifTable_ifEntry_ifOutOctets_
_mgmt_mib_interfaces_ifTable_ifEntry_ifInUcastPkts_
_mgmt_mib_interfaces_ifTable_ifEntry_ifOutUcastPkts_
_private_enterprise_proteon_xface_comsl_recv-overruns_
_private_enterprise_proteon_xface_comsl_recv-aborts_
_private_enterprise_proteon_xface_comsl_recv-crc-errors_
_private_enterprise_proteon_xface_comsl_recv-framing-errors_
_private_enterprise_proteon_xface_comsl_xmit-underruns_
_private_enterprise_proteon_xface_comsl_xmit-framing-errors_
_private_enterprise_proteon_xface_comsl_xmit-no-dcd-errors_
_private_enterprise_proteon_xface_comsl_xmit-no-cts-errors_
_private_enterprise_proteon_xface_comsl_xmit-no-dsr-errors_
_private_enterprise_proteon_xface_generic_maint-failed_
_private_enterprise_proteon_xface_generic_selftest-failed_

関連ファイル

plot.1.awk
この awk スクリプトは、1 日のデータを要約し、 各変数・エラー毎に、graph(1g) の入力形式の中間ファイルを作成します。 この中間ファイルには、各データポイント・変数名を示すラベル等が含まれます。 注意: plot.1.awk スクリプトは、makeawk スクリプトによって、 Begin00, End00, Var00, Err00 の各パーツから 生成できます。これらは、Report_Root/plot/bin/sedawk ディレクトリに 置いてあります。

plot.2.awk
this awk script determines when a poll period has been missed, and alters the per variable/errors data file so that the missing period will show as a break when the line is graph. 当スクリプトは、グラフ上のラベルを生成することも受け持ちます。

yscale.awk
この awk スクリプトは、 Y 軸に関して値の範囲を計算し、 X・Y 座標軸の ラベルを生成します。

yscale.l.awk
yscale と似ていますが、こちらは Y 軸を常用対数座標とするような ラベルを生成します。

バグ

log10: 符号エラーをグラフプログラムが返してくることがあります。 これは、入力データに ’0’ が含まれることによるものです。 入力データが無いときにもこのエラーがおきます。

関連事項

snmppoll(1) graph(1g) plot(1g) snmpxgraph(1)

関連ファイル

/etc/snmp.variablesMIB データベース
/usr/sony/doc/SNMPSNMP 関連ドキュメントのあるディレクトリ

参照

J.D. Case, J.R. Davin, M.S. Fedor, M.L. Schoffstall, Simple Network Management Protocol, Request for Comments 1157, Network Information Center, SRI International, Menlo Park, California, May, 1990.  M.T. Rose, K. McCloghrie, Structure of Management Information, Request for Comments 1155, Network Information Center, SRI International, Menlo Park, California, May, 1990.  K. McCloghrie, M.T. Rose, Management Information Base, Request for Comments 1156, Network Information Center, SRI International, Menlo Park, California, May, 1990.  M.T. Rose, Editor Management Information Base: MIB-II, Request for Comments 1158, Network Information Center, SRI International, Menlo Park, California, May, 1990. 

NEWS-OSRelease 4.2.1R