名称

snmpxperf -  MIB 変数の値をリアルタイムにプロットする SNMP アプリケーション

形式

snmpxperf agent object [options]

解説

Snmpxperf は、MIB 変数の値をグラフィカルに表示するツールです。 また MIB オブジェクトの値の変化をトレース表示する事もできます。 agent と MIB object をコマンドラインで指定して下さい。 Snmpxperf は、カウンター・ゲージ・整数・時間など、 数値を返してくる MIB 変数だけを表示できます。 数値を返さない MIB オブジェクトを指定すると、 標準エラー出力にエラーメッセージを表示しなにもプロットしません。 Snmpxperf は、X-Windows version 11 上で動作します。

agent:
モニターしたいエージェントを指定します。 192.33.4.44 のように、ドットで区切った表記法かホスト名で指定して下さい。

object:
グラフにプロットしたい MIB 変数名を指定します。 表示される画面には、以下に示すような、 snmpxperf をコントロールするボタンがあります。 QUIT:

snmpxperf を終了します。

Interval xxxxs:

現在のポーリングインターバル（秒）が表示されます。 このボタンは、表示されるだけです。

+1:

このボタンをマウスの任意のボタンでクリックすると、 ポーリングインターバルが 1 秒増やされます。 ポーリングインターバルの最大値は、9999 秒です。 "Interval" ボタンボックスには、新しいポーリングインターバルが表示されます。

-1:

このボタンをマウスの任意のボタンでクリックすると、 ポーリングインターバルが 1 秒減らされます。 ポーリングインターバルの最小値は、1 秒です。 "Interval" ボタンボックスには、新しいポーリングインターバルが表示されます。

SNMP オプション

これらのオプションは、SNMP の環境を設定します。 グラフの表示をコントロールする為のオプションもあります。 -rate

これが指定されると、 snmpxperf オブジェクトの値の変化をプロットします。

-xlabel ’label string’
-xl ’label string’

文字列 ’label string’ を、グラフの X 軸の下に表示します。 複数の単語を使用したいときは、引用符で囲んで下さい。

-interval pollint
-i pollint

整数 pollint（秒）を、ポーリングインターバルとします。 これによって、 snmpxperf がエージェントに対して、オブジェクトの値のポーリング間隔を 指定できます。

-community community_name
-c community_name

snmpxperf がエージェントにアクセスするときのコミュニティ名を community_name とします。

-scale scalefactor
-s scalefactor

整数 scalefactor で、グラフの Y 軸スケールの 初期値 を指定します。 Snmpxperf は、エージェントから返ってきた値が、現在の表示領域をはみだした場合、 自動的にグラフの Y 軸スケールを変更します。

X-WINDOW オプション

以下は、X-window のオプションです。 これらのオプションは、X-window で習慣的に使われている形式になるべく近く 作ってあります。 いくつかの設定に必要な項目を、.Xdefaults に指定することにより 入力する項目を少なくできます。/usr/sony/doc/SNMP/Xdefaults.sample をご参照ください。 -display host:display

snmpxperf をリモート X サーバーで走らせる為に使用します。 ディスプレイは、例えば rebel:0.0 のように、標準的な X の形式で指定して下さい。

-font fontname
-fn fontname

使用するフォントを指定します。 snmpxperf は、使用するフォントに合わせて自動的に自分自身のサイズを調整します。

-geometry {width}x{height}[+x+y]

 X で標準的な形式で、ウィンドウのジオメトリを指定します。 snmpxperf は、指定されたジオメトリの妥当性をチェックします。 不正な値が指定された場合、 snmpxperf は、フォントの大きさから妥当と思われる値を計算します。 例えば、100 桁、66 行の大きさのウィンドウを左上隅から (50, 75) の 位置に表示したい場合は、-geometry 100x66+50+75 と指定して下さい。

-borderwidth bwidthnum
-bw bwidthnum

ウィンドウを取り囲むボーダーの幅を、整数 bwidthnum ピクセルにします。

-name iconname
-title iconname

snmpxperf ウィンドウがアイコン化された時のラベルを、iconname にします。

-reverse
-rv

フォアグラウンドカラーとバックグラウンドカラーを反転させます。

-color {on,off}

カラー表示にしたいときは、-color on、白黒のときは、-color off を 指定します。

-background bgcolor
-bg bgcolor

バックグラウンドカラーを指定します。

-foreground fgcolor
-fg fgcolor

フォアグラウンドカラーを指定します。

-border bordercolor
-bd bordercolor

ボーダーカラーを指定します。

-graph [graphcolor]
-gc [graphcolor]

グラフの表示色を指定します。

X リソースの使い方

Snmpxperf コマンドラインオプションと、$HOME/.Xdefaults ファイルから、 ローカルリソースデータベースを作成します。 コマンドラインオプションは、.Xdefaults 内に記述されている パラメーターに常に優先します。 以下に、 snmpxperf で使用できるパラメーターを、.Xdefaults に記述する形式で示します。 示されている値は、デフォルト値です。

snmpxperf.display:0.0
snmpxperf.font:6x10
snmpxperf.geometry:NULL  (as big as font dictates)
snmpxperf.borderwidth:2
snmpxperf.name:snmpxperf
snmpxperf.reverseVideo:off
snmpxperf.color:off
snmpxperf.background:NavyBlue
snmpxperf.foreground:white
snmpxperf.bordercolor:red
snmpxperf.graphcolor:yellow
snmpxperf.rate:off
snmpxperf.xlabel:Time
snmpxperf.interval:60
snmpxperf.community:public
snmpxperf.yscale:10

例

エージェント 192.33.4.20 のインターフェース 1 における、 1 秒あたりのパケット数をモニターする場合： snmpxperf 192.33.4.20 _mgmt_mib_interfaces_ifTable_ifEntry_ifInUcastPkts_1 -rate エージェント 128.145.44.44 への、TCP コネクションの数を、 カラーで、コミュニティ名 "pub1" として、5 秒毎にモニターする場合： snmpxperf 128.145.44.44 _mgmt_mib_tcp_tcpCurrEstabs_0 -color on -c pub1 -i 5

バグ

snmpxperf は、リソースデータベースを作成するときに、環境変数 XENVIRONMENT を参照しません。 Snmpxperf は、 X サーバーでユーザーがオプションを定義する為に使用される RESOURCE_MANAGER プロパティを利用できません。 大きな文字のフォントを使用すると、 snmpxperf のウィンドウが、画面より大きくなることがあります。 そのような場合、ウィンドウは、クリッピングされます。

関連ファイル

/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.1C