SNMPXBAR(1) — NEWS-OS Programmer’s Manual
名称
snmpxbar − MIB 変数の値を監視しリアルタイムに棒グラフで表示する SNMP アプリケーション
形式
snmpxbar agent object [options]
解説
snmpxbar は MIB 変数の値をグラフィカルに表示するツールです。グラフは棒グラフで表 示されます。 監視の対象となるエージェント agent と MIB 変数 object をコマンドラインより指定してください。 snmpxbar で表示できるものは、カウンタ、ゲージ、整数、時間など、数値を返す MIB 変 数だけです。もし、数値を返さない MIB 変数を指定した場合、継続ができない ことを告げるエラーダイアログが表示されますので、その指示にしたがって終 了してください。新しく表示しようとした値がグラフの表示範囲を越えた場合、 snmpxbar は自動的に表示範囲を変更します。
agent エージェントを 133.138.1.1 のようにドット記法によるアドレスかホスト名で 指定してください。
object グラフに表示する MIB 変数を “_iso_org_dod_internet” を省略した 形式で指定してください。例えば、変数 “_iso_org_dod_internet_mgmt_mib_system_sysUpTime_0” の場合、省 略形 “_mgmt_mib_system_sysUpTime_0” を指定してください。 snmpxbar のウィンドウにはメニューバーがあり、それより動作状況の変更やオンライン マニュアルの表示などを指示することができます。以下にメニューバーの内容 を述べます。 ファイル(F)
制御...(C)
コントロールパネルがポップアップし、ポーリングインターバル、しきい値、 表示モード、ベルの設定を変更することができます。 ポーリングインターバルは、エージェントに対して、どれくらいの頻度で変数 の値を問い合わせるかを秒数で設定します。 ポーリングインターバルのデフォルトは 60 秒です。 MIB 変数の値がしきい値を越えると、カラーディスプレイを使用している場合、 しきい値から現在の値までが赤で表示されます。また、ベルが “on” に設定されている場合、ベルが鳴ります。しきい値のデフォルトは 10000 です。 表示モードはグラフの表示形式を設定します。 表示モードには “絶対値”、“差分値”、“平均値” の 3 種類があります。“絶対値” モードでは、MIB 変数の値をそのまま表 示します。“差分値” モードでは、一つ前の値との差分を表示します。 “平均値” モードでは、一つ前の値との差分をポーリングインターバル で割った値を表示します。表示モードのデフォルトは “絶対値” です。
終了(E)
snmpxbar を終了します。
ヘルプ(H)
バージョン...(V)
バージョン情報を表示します。
マニュアル...(M)
オンラインマニュアルを表示します。
オプション
snmpxbar は、標準の X ツールキットオプション、ならびに以下のオプションを使用する ことができます。 −interval seconds
−i seconds
整数 seconds (秒) をポーリングインターバルとします。これによって、 snmpxbar がエージェントに対して、どのくらいの頻度で変数の値を問い合わせるかを指 定できます。ポーリングインターバルのデフォルトは 60 秒です。
−threshold value
−t value
MIB 変数を監視する際のしきい値を、整数 value に設定します。 MIB 変数の値がしきい値を越えると、カラー表示が可能なディスプレイを使用 している場合、しきい値から現在の値までが赤で表示されます。 しきい値のデフォルトは 10000 です。
−abs
−diff
−av
グラフの表示形式を設定します。表示モードには “絶対値”、“差 分値”、“平均値” の 3 種類があります。 “絶対値” モードでは、MIB 変数の値をそのまま表示します。“差 分値” モードでは、一つ前の値との差分を表示します。“平均値” モードでは、一つ前の値との差分をポーリングインターバルで割った値を表示 します。 −abs が指定された場合、表示モードは “絶対値” に、 −diff が指定された場合、表示モードは “差分値”に、また、 −av が指定された場合、表示モードは “平均値” に設定されます。 表示モードのデフォルトは “絶対値” です。
−shift percent
−s percent
グラフの表示範囲の変更の大きさを表示範囲に対する割合 percent に設定します。この値は、新しく表示しようとした値が現在のグラフの表示範 囲を越えたときに使用されます。範囲変更の割合はデフォルトで 20 パーセン トです。
−xlabel string
−xl string
−l string
string で指定された文字列を、グラフに表示されるラベルとして使用します。複数の 単語を使用したい場合はクォートで囲んでください。 デフォルトのラベルは MIB 変数名です。
−community name
−c name
snmpxbar がエージェントにアクセスする際のコミュニティ名を name に設定します。コミュニティ名のデフォルトは “public” です。
−bell on/off
−b on/off
しきい値を越えたときにベルを鳴らすかどうかを指定します。 ベルのデフォルトは “on” です。
−help
snmpxbar に固有のオプションを表示します。
リソース
snmpxbar は 標準の X ツールキットに含まれるリソース名とクラス名、ならびに以下の アプリケーションリソースを使用することができます。示されている値は、デ フォルト値です。
Snmpxbar.interval: 60
ポーリングインターバルを指定します。
Snmpxbar.maxInterval: 600
ポーリングインターバルの最大値を指定します。
Snmpxbar.community: public
コミュニティ名を指定します。
Snmpxbar.mode: absolute
グラフの表示形式を指定します。表示形式は、“absolute”、 “difference”、“average” のいずれかを指定することができ ます。
Snmpxbar.threshold: 10000
しきい値を指定します。
Snmpxbar.maxThreshold: 999999999
しきい値の最大値を指定します。
Snmpxbar.minThreshold: −999999999
しきい値の最小値を指定します。
Snmpxbar.shift: 20
グラフの表示範囲の変更の大きさを表示範囲に対する割合で指定します。
Snmpxbar.bell: on
MIB 変数の値がしきい値を越えた場合、ベルを鳴らすかどうかを指定します。 “on”、“off” のいずれかを指定することができます。
例
エージェント 133.138.1.1 のインターフェース No.1 における 1 秒あたりの入力パケット数を監視する場 合 : % snmpxbar 133.138.1.1 _mgmt_mib_interfaces_ifTable_ifEntry_ifInUcastPkts_1 −av エージェント 133.138.1.1 への TCP コネクション数をコミュニティ名 “pub1” として 5 秒ごとに監視する場合 : % snmpxbar 133.138.1.1 _mgmt_mib_tcp_tcpCurrEstab_0 −c pub1 −i 5
バグ
白黒ディスプレイでは表示の変化がよくわからないことがあります。カラーディ スプレイのご使用をお薦めします。
関連ファイル
/etc/snmp.variables
/usr/sony/doc/SNMP
/usr/lib/X11/app-defaults/Snmpxbar
/usr/lib/X11/ja_JP.SJIS/app-defaults/Snmpxbar
/usr/lib/X11/ja_JP.EUC/app-defaults/Snmpxbar
参照
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