名称

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

形式

snmpxgraph [−[all|dual|single|log]] [−compress] [−xscale xl,xh] [−vars "v1 v2 ... vn"] [−date mmddyy] file(s)

解説

snmpxgraph は、xgraph を利用して snmppoll で集めたデータを グラフ表示するツールです。 入力ファイル（file(s)）は、圧縮形式の snmppoll が作り出す データファイルです。 これらのファイルは、−date オプションで指定されない限り カレントディレクトリに存在するものと仮定されます。 以下にコマンドラインから指定できるオプションを示します。 （括弧の中は、省略形です）

-date <日付> (-d)
このオプションと共に処理したい日付を指定してください。

-xpand (-x)
指定されたファイル名を、∗<arg>∗ の形に展開します。 date オプションと共に用いられます。 [例えば、"snmpxgraph -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)
全ての変数とエラーを対数座標でグラフ化します。 これは、エラー、パケット数、オクテット数等、単位の違う情報を 同時にグラフ化し、各情報の重要度を知る為に役立ちます。

-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 つのグラフが作成されます。

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

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

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

動作環境

当ツールは、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 ディレクトリに 置いてあります。

バグ

xgraph が、 Cannot plot non-positive Y values
when the logarithmic option is selected. なるエラーを返してくることがあります。 これは、入力データに ’0’ が含まれることによるものです。 入力データが無いときにもこのエラーがおきます。
実行時と終了時にプロセス番号が表示されてしまいます。

関連事項

snmppoll(1) xgraph(1) snmpgraph(1)

関連ファイル

/etc/snmp.varaibalesMIB データベース
/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.1C