SSLogger の使用例
内容
casp1032jp
内容
このセクションでは、複雑さが増加する 3 つのシナリオで SSLogger を使用する方法の詳細な例を示します。これらの例は、SSLogger を使用して異なるタイプの
CA Spectrum
統計をログに記録する方法を理解するのに役立ちます。例は、自分のシステムで実施することができ、自分で入力ファイルを作成して、例で使用されているものに独自のものとモデル ID 値を代入できるように設計されています。サンプルの出力ファイルも提供されます。おそらくほとんどのユーザが SSLogger を使用してネットワーク上の個々のポート（インターフェース）に関連付けられている統計をログに記録したいのだと思いますが、この例では、より単純なシナリオから始まり、ポートのログ記録まで進みます。独自の実稼働 SSLogger シナリオを設定する前に、これらの例を 3 つ連続して実施することを強くお勧めします。SSLogger のセットアップ
3 つの例を使用する前に、ここで説明するセットアップ手順を完了する必要があります。
SSLogger をセットアップする方法
- SpectroSERVER および OneClick を起動します。
- デバイスをモデリング（またはすでにモデリングしているものを選択）し、今後の参照用にデバイスの名前をメモします。
- CA SpectrumSSLogger ディレクトリに、「modelfile」という名前のテキスト ファイルを作成します。
- ファイルに以下を入力して、ファイルを［保存して閉じる］。#********************************************************************* # modelfile # # This file specifies devices to monitor. #********************************************************************* Create another text file called "datafile" in the SSLogger directory. Type the following into the file and then save and close the file. #********************************************************************* # datafile # # This file specifies device information to monitor. #*********************************************************************テキスト エディタで /SSLogger/.ssloggerrc を開き、SpectroSERVER の名前（vnm 名）およびモデル ファイルの名前とデータ ファイル名の反映させます。このファイルは、SSLogger を実行するためのデフォルトのパラメータを提供します。必要に応じて、コマンド ラインで別の値を入力し、vnm、modelfile、および datafile 設定をオーバーライドすることができます。listen_port= vnm=<your SpectroSERVER name> vnm_port= modelfile=modelfile datafile=datafile max_threads= thread_priority= debug_interval= max_oreq=
- vnmsh ディレクトリに移動し、以下のコマンドを入力することで、マシンの端末/コマンド プロンプト ウィンドウから、コマンド ライン インターフェース（CLI）を起動します。./connect以下の 3 つの例に関連する手順を実行する準備が整いました。
例 1 デバイス統計のログ記録
最初の例を完了するには、モデルおよびデータ ファイルを変更して、SSLogger を実行し、出力ファイルを分析する必要があります。
モデル ファイルの変更
モデル ファイルは、SSLogger のターゲットとするデバイス モデルまた統計をログ記録するデバイス モデルを指定します。この例では、デバイス モデルを 1 つだけ指定します。ただし、必要に応じて、何百または何千ものデバイスをこのファイル内に記載することができます。
モデル ファイルを変更する方法
- CA Spectrumvnmsh ディレクトリから、以下の CLI コマンドを入力します。./show models mname=<name of your model>指定されたモデル名から始まる名前のすべてのモデルのリストが表示され、モデル ハンドル、モデル名、モデル タイプ ハンドル、およびモデル タイプ名で各モデルが識別されます。多くの場合、CA Spectrumはモデルの名前に IP アドレスを使用します。以下のサンプル出力では、モデル名として IP アドレス 172.19.57.220 が使用される場合に表示されるリストを示しています。モデル ハンドル値 0x40001a のエントリはデバイスを表し、その他のモデルはそのデバイスのアプリケーションまたはポートを表します。0x400059 172.19.57.220_IC 0x230012 ICMP_App 0x400056 172.19.57.220_Do 0x230052 CtDownLoadApp 0x400022 172.19.57.220_FD 0xd80004 FddiMAC 0x40004b 172.19.57.220_St 0x590006 RMONApp 0x40005b 172.19.57.220_IP 0x230016 IP2_App 0x400057 172.19.57.220_RS 0x230046 RFC1317App 0x40005d 172.19.57.220_DS 0xc40006 DS1App1406 0x40001a 172.19.57.220 0x1c80018 2M46_04 0x40001f 172.19.57.220_Tr 0xd0031 CT_Tp_Appl 0x40004a 172.19.57.220_21 0xd000a CSIIfPort
- 得られるリストからデバイスを検索し、4 つのデバイス情報値すべてをセットアップするモデルに追加します。この例のデバイスの場合、モデル ファイルは次のように表示されます。#**************************************************************** # modelfile # # This file specifies devices to monitor. #**************************************************************** 0x40001a 172.19.57.220 0x1c80018 2M46_04
- 以下に示すように、セミコロンで 4 つのデバイス情報値を区切ります。#**************************************************************** # modelfile # # This file specifies devices to monitor. #**************************************************************** 0x40001a; 172.19.57.220; 0x1c80018; 2M46_04
データ ファイルの変更
データ ファイルは、値をログに記録する属性を指定します。この例では、以下の 3 つの属性を使用します。
- ipInReceives
- ipOutRequests
- sysUpTime
データ ファイルを構築する方法
- vnmsh ディレクトリから、モデル ファイルの 3 つ目の列からデバイス モデルのモデル タイプ ハンドルを使用して、以下の CLI コマンドを入力します。./show attributes mth=<your model type handle> flags=E外部（E）フラグが設定された指定されたモデル タイプの属性すべてが一覧表示されます。各属性について、リストには、属性 ID、属性名、属性タイプ、属性フラグ（複数可）が表示されます。以下のサンプル出力は、172.19.57.220 デバイスのモデル タイプ ハンドル 0x1c80018 が使用される場合に表示されるリストを示しています。0x10098 ipInReceives Counter E,R 0x10099 ipInHdrErrors Counter E,R 0x1009a ipInAddrErrors Counter E,R 0x1009b ipForwDatagrams Counter E,R 0x1009c ipInUnknownProtos Counter E,R 0x1009d ipInDiscards Counter E,R 0x1009f pInDelivers Counter E,R 0x100a0 ipOutRequests Counter E,R 0x100a1 ipOutDiscards Counter E,R 0x100a2 ipOutNoRoutes Counter E,R 0x101c1 icmpOutAddrMaskReps Integer E,R 0x10245 sysUpTime Time Ticks E,R,M,P 0x10b5a sysContact Text String E,R,W,M 0x10b5b sysName Text String E,R,W
- 生成した出力では、この例で対象となっている 3 つの属性（ipInReceives、ipOutRequests、および sysUpTime）を検索し、名前と ID を、モデルのモデル タイプ名と共にデータ ファイルに追加し、以下の例のように表示されるようにします。#**************************************************************** # datafile # # This file specifies device information to monitor. #**************************************************************** group: device_information sysUpTime ; 10 ; 0x0 ; 0x10245 ; .0 ipInReceives ; 10 ; 0x0 ; 0x10098 ; .0 ipOutRequests ; 10 ; 0x0 ; 0x100a0 ; .0 mtype: <model type name of your model> device_informationこのデータ ファイルの例では、グループは、属性のグループを参照する SSLogger ファイル キーワードです。グループにはどのような名前でも付けることができます。この場合、device_information グループには、3 つのターゲット属性が含まれており、それらに関する情報の列が 5 つあります。1 番目の列では、属性名を指定します。任意の名前を使用することができますが、手順 1 からの出力に表示されるCA Spectrum名を使用することをお勧めします。2 番目の列は、SSLogger に、属性に関連付けられた属性値をポーリングおよびログ記録する頻度（秒）を伝えます。10 秒ごとに 1 回というポーリング間隔は一般的に回数が多すぎますが、短時間で大量のデータを出力するため、この例で使用されます。ポーリング間隔は Rotate_log_interval と同じ値に設定することをお勧めします。3 番目の列では、その属性があるモデル タイプを指定します。0x0 は、デバイスモデル タイプを示します。後の例では、このフィールドを特定の属性のポートモデル タイプに設定します。4 番目の列では、CA Spectrum属性 ID を指定します 5 番目の列は、属性がリスト属性かどうかを示します。この場合、0 は属性がリスト属性ではないことを意味します。
SSLogger の実行
SSLogger を実行するには、SSLOGGER ディレクトリから、以下のコマンドを入力します。
./SSlogger
以下のようなメッセージが表示されます。
sslogger version 3.0rev0 -- built on Jul 3 2001 at 09:33:13 SSlogger started at: Fri Jul 27 10:36:55 2001
SSLogger 出力ファイルの tail
SSLogger の実行中に、「tail」コマンドを使用し、ファイル名を指定すると、出力ファイルを確認することができます。ファイル名には現在の日付が YYYYMMDD 形式で含まれ、その後に 2 桁の連番と .log 拡張子が続きます。たとえば、2001 年 9 月 12 日に、SSLogger によって作成された最初のログ ファイルの名前は、SSLog20010912_01.log となります。
注：
ログ ファイルの順序とクローズの方法の詳細については、Rotate_log_interval を参照してください。これが現在アクティブなログ ファイルと仮定すると、SSLOGGER ディレクトリから以下のコマンドを入力すると、ファイルの最後に追加された統計を表示することができます。
tail -f SSLog20010912_01.log
上記の tail コマンドのファイル名を SSLogger 出力ファイルの名前に置き換えてコマンドを実行すると、以下の例と同様に表示されます。
1 20010718; 10:51:43; 10:51:43; 0x40001a; -; 0x10245; 239765127 2 20010718; 10:51:43; 10:51:43; 0x40001a; -; 0x10098; 1152773 3 20010718; 10:51:43; 10:51:43; 0x40001a; -; 0x100a0; 1142885 4 20010718; 10:51:53; 10:51:53; 0x40001a; -; 0x10245; 239766128 5 20010718; 10:51:53; 10:51:53; 0x40001a; -; 0x10098; 1152774 6 20010718; 10:51:53; 10:51:53; 0x40001a; -; 0x100a0; 1142886 7 ...
出力ファイルには、情報の 7 つの列が含まれています。
- 最初の列は、日付を示します。
- 2 番目の列は、SSLogger が属性値を読み取る直前の時間を示します。
- 3 番目の列は、SSLogger が属性値を読み取った直後後の時間を示します。
- 4 番目の列は、デバイス モデル ハンドルを示します。
- 属性がリスト属性ではない場合、5 番目の列には「-」が表示されます。そうでない場合は、後の例で示されるように、テーブル インデックスが表示されます。
- 6 番目の列は、属性 ID を示しています。
- 7 番目の列は、属性値を示します。
注：
出力ファイルの内容の詳細については、「SSLogger 出力」を参照してください。例 2 リスト属性統計のログ記録
例 1 では、単一値のデバイス属性をログ記録しました。例 2 では、
リスト
属性または属性データのテーブルをログ記録する方法を示します。1 つ目の例と同様に、これはデータ ファイルを変更して、SSLogger を実行し、得られる出力ファイル データを確認することを意味しています。リスト属性統計のログ記録
この例では、以下の 2 つの属性を使用します。
- ifInOctets
- ifOutOctets
リスト属性統計をログに記録する方法
- CA Spectrumvnmsh ディレクトリから、モデル ファイルの 3 番目の列からデバイス モデルのモデル タイプ ハンドルを使用して、以下の CLI コマンドを入力します。./show attributes mth=<your model type handle> flags=ET「E」および「T」フラグを使用するため、このコマンドによって、外部（E）およびテーブル（T）フラグが設定されている指定されたモデル タイプの属性がすべて一覧表示されます。各属性について、リストには、属性 ID、属性名、属性タイプ、属性フラグ（複数可）が表示されます。以下のサンプル出力は、172.19.57.220 デバイスのモデル タイプ ハンドル 0x1c80018 が使用される場合に表示されるリストを示しています。0x100cd ifInOctets Counter E,R,[] 0x100ce ifInUcastPkts Counter E,R,[] 0x100cf ifInNUcastPkts Counter E,R,[] 0x100d0 ifInDiscards Counter E,R,[] 0x100d1 ifInErrors Counter E,R,[] 0x100d2 ifInUnknownProtos Counter E,R,[] 0x100d3 ifOutOctets Counter E,R,[] 0x100d4 ifOutUcastPkts Counter E,R,[]
- 生成した出力では、この例で対象となっている 2 つの属性（ifInOctets および ifOutOctets）を検索し、名前と ID をデータ ファイルに追加し、以下の例のように表示されるようにします。#**************************************************************** # datafile # # This file specifies device information to monitor. #**************************************************************** group: device_information sysUpTime ; 10 ; 0x0 ; 0x10245 ; .0 ipInReceives ; 10 ; 0x0 ; 0x10098 ; .0 ipOutRequests ; 10 ; 0x0 ; 0x100a0 ; .0 ifInOctets ; 10 ; 0x0 ; 0x100cd ; .1 ifOutOctets ; 10 ; 0x0 ; 0x100d3 ; .1 mtype: <model type name of your model> device_information注：新しい行の最後に、これらの属性がテーブルまたは情報を表していることを示す「.1」があります。「.0」を除く値は、属性がテーブル属性であることを示します。そのため、ドキュメント作成を目的とする場合は、「.1」の代わりに完全な OID を配置します。
- SSLogger を実行します。
- SSLogger 出力ファイルを tail します。再び、「tail」コマンドを使用し、ファイル名を指定すると、出力ファイルを確認することができます。このファイル名は、最初の例で使用した名前と同じものである必要があります（新しい出力ファイルを開く方法とタイミングの詳細については「SSLogger 出力」を参照してください）。これを行うには、SSLOGGER ディレクトリから、以下のコマンドを入力します。tail -f SSLog<current date in YYYYMMDD format>_01.log今度は、出力は以下のように表示されます。20010724; 10:17:26; 10:17:26; 0x40001a; 1; 0x100cd; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 1; 0x100d3; 0 20010724; 10:17:26; 10:17:26; 0x40001a; -; 0x10245; 291399900 20010724; 10:17:26; 10:17:26; 0x40001a; -; 0x10098; 1307231 20010724; 10:17:26; 10:17:26; 0x40001a; -; 0x100a0; 1297366 20010724; 10:17:26; 10:17:26; 0x40001a; 2; 0x100cd; 2041440626 20010724; 10:17:26; 10:17:26; 0x40001a; 2; 0x100d3; 2308773051 20010724; 10:17:26; 10:17:26; 0x40001a; 3; 0x100cd; 2794679535 20010724; 10:17:26; 10:17:26; 0x40001a; 3; 0x100d3; 2497597136 20010724; 10:17:26; 10:17:26; 0x40001a; 4; 0x100cd; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 4; 0x100d3; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 5; 0x100cd; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 5; 0x100d3; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 6; 0x100cd; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 6; 0x100d3; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 7; 0x100cd; 183630755 20010724; 10:17:26; 10:17:26; 0x40001a; 7; 0x100d3; 176510228 20010724; 10:17:26; 10:17:26; 0x40001a; 14; 0x100cd; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 14; 0x100d3; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 15; 0x100cd; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 15; 0x100d3; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 16; 0x100cd; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 16; 0x100d3; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 17; 0x100cd; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 17; 0x100d3; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 18; 0x100cd; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 18; 0x100d3; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 19; 0x100cd; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 19; 0x100d3; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 20; 0x100cd; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 20; 0x100d3; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 21; 0x100cd; 0 20010724; 10:17:26; 10:17:26; 0x40001a; 21; 0x100d3; 0注：5 番目の列は、テーブル属性データを表す行のテーブル インデックスを示します。
例 3 ポート統計のログ記録
この例では、ポートに関連する統計情報をログに記録する方法を示します。もう一度、データ ファイルを変更し、SSLogger を実行して、出力ファイルを確認します。モデル ファイルを変更したり、すべてのポート モデルのモデル ハンドルを指定する必要は
ありません
。ポート モデル ハンドルを指定する代わりに、ポート モデル タイプ
ハンドルおよび CA Spectrum
関係を指定します。また、この例では、ifInOctets および ifOutOctets 属性を使用します。ポート統計のログ記録
ポート統計をログに記録する方法
- vnmsh ディレクトリから、モデル ファイルの最初の列からデバイス モデルのモデル ハンドルを使用して、以下の CLI コマンドを入力します。./show children rel=HASPART mh=<your model handle>この CLI コマンドは、ターゲット デバイスに関連付けられているポート モデルを表示します。このコマンドを実行して、ターゲットとするポートのモデル タイプ ハンドルを決定する必要があります。この場合、すべてのポートは同じモデル タイプです。以下のサンプル出力は、最初の例から 0x40001a モデル ハンドルを使用して表示されるリストを示しています。MHandle MName MTypeHnd MTypeName Relation 0x40003f 172.19.57.220_1 0xd000a CSIIfPort HASPART 0x400040 172.19.57.220_2 0xd000a CSIIfPort HASPART 0x400041 172.19.57.220_3 0xd000a CSIIfPort HASPART 0x400042 172.19.57.220_5 0xd000a CSIIfPort HASPART
- 出力が数種類のポートを示す場合、1 つのポート モデル タイプを選択し、以下のコマンドでそのモデル タイプ ハンドルを使用します。./show attributes mth=<your port model type handle> flags=Eこれは、以下に示すように、指定されたポート モデル タイプに関連付けられた外部属性のリストを返します。0x10e3f ifAdminStatus Integer E,R,W,[] 0x10e40 ifOperStatus Integer E,R 0x10e41 ifInOctets Counter E,R 0x10e42 ifOutOctets Counter E,R 0x11315 ifInUcastPkts Counter E,R 0x11317 ifInNUcastPkts Counter E,R 0x11318 ifInDiscards Counter E,R 0x11319 ifInErrors Counter E,R 0x1131a ifInUnknownProtos Counter E,Rコマンド出力に属性 ifInOctets および ifOutOctets が表示される場合と表示されない場合があります。表示されない場合は、独自のものをいくつか選択し、この例に従うように使用します。
- port_information という新しいグループをデータ ファイルに追加し、属性名、モデル タイプ ハンドル（デバイス モデルを示す 0x0 ではなく）、およびそれぞれの属性の属性 ID を入力します。最後に、SSlogger_relation の情報と child_mtype_handles を追加して、データ ファイルが以下の例のように表示されるようにします。#**************************************************************** # datafile # # This is a sample data input file for sslogger. #**************************************************************** group: device_information sysUpTime ; 10 ; 0x0 ; 0x10245 ; .0 ipInReceives ; 10 ; 0x0 ; 0x10098 ; .0 ipOutRequests ; 10 ; 0x0 ; 0x100a0 ; .0 ifInOctets ; 10 ; 0x0 ; 0x100cd ; .1 ifOutOctets ; 10 ; 0x0 ; 0x100d3 ; .1 group: port_information ifInOctets ; 10 ; 0xd000a ; 0x10e41 ; .0 ifOutOctets ; 10 ; 0xd000a ; 0x10e42 ; .0 SSlogger_relation: HASPART child_mtype_handles: 0xd000a mtype: <model type name of your model> device_information port_informationSSlogger_relation キーワードは、SSLogger が従う必要がある、モデル ファイルで指定されたデバイスとデータ ファイルの属性行で指定されたモデル タイプのモデル間の関係を指定します。この例では、CA Spectrumがそのポート モデルを有するという関係であるため、このキーワードの値は HASPART です。注：CLI の「show relations」コマンドを使用して、すべてのCA Spectrum関係のリストを表示できます。child_mtype_handles キーワードは、SSLogger 出力ファイルの 4 番目の列の表示にのみ影響を与えます（以下のセクションの例を参照してください）。デフォルトでは、デバイス モデル ハンドルのみがこの列に表示されます。child_mtype_handles キーワードにポート モデル タイプ ハンドルを指定すると、出力ファイルの 4 番目列に、デバイス モデル ハンドルとポート モデル ハンドルの両方を表示するように SSLogger に指示します。
- SSLogger を実行します。
- 再び、「tail」コマンドを使用し、SSLog ファイルの名前を指定して、出力ファイルを確認します。このファイル名は、前の例で使用した名前と同じものである必要があります（新しい出力ファイルを開く方法とタイミングの詳細については「SSLogger 出力」を参照してください）。これを行うには、SSLOGGER ディレクトリから、以下のコマンドを入力します。tail -f SSLog<current date in YYYYMMDD format>_01.log出力は以下のサンプルと同様になるはずです。20010718; 14:40:56; 14:40:56; 0x40001a; -; 0x10245; 241140428 20010718; 14:40:56; 14:40:56; 0x40001a; -; 0x10098; 1159008 20010718; 14:40:56; 14:40:56; 0x40001a; -; 0x100a0; 1149142 20010718; 14:40:56; 14:40:56; 0x40001a:0x400040; -; 0x10e41; 1582426060 20010718; 14:40:56; 14:40:56; 0x40001a:0x400040; -; 0x10e42; 1808004560 20010718; 14:40:56; 14:40:56; 0x40001a:0x400041; -; 0x10e41; 2251080181 20010718; 14:40:56; 14:40:56; 0x40001a:0x400041; -; 0x10e42; 1999870610 20010718; 14:40:56; 14:40:56; 0x40001a:0x400042; -; 0x10e41; 0 20010718; 14:40:56; 14:40:56; 0x40001a:0x400042; -; 0x10e42; 0 20010718; 14:40:56; 14:40:56; 0x40001a:0x40003f; -; 0x10e41; 0 20010718; 14:40:56; 14:40:56; 0x40001a:0x40003f; -; 0x10e42; 0注：前述したように、4 番目の列に、デバイスおよびポート モデル ハンドルの両方が表示されます。