CA Spectrum - 10.3.2 - Japanese - Japan

CA Spectrum イベントへの非 SNMP アラート データのマップ

内容
casp1032jp
内容
非 SNMP アラート データを
CA Spectrum
 イベントにマップする場合、2 つの方法を使用できます。最初の方法では、XML を使用して
CA Spectrum
 イベントを作成します。効率的で簡単に実行できるこの方法をお勧めします。
プログラムでイベントを
CA Spectrum
 に送信することもできます。この方法の場合、
CA Spectrum
 アプリケーション プログラミング インターフェースについてより深く理解する必要があります。
XML を使用する
CA Spectrum
 イベントの作成
Southbound ゲートウェイでは、XML ファイルからのデータに基づいて
CA Spectrum
 イベントを作成するための sbgwimport ツールが提供されます。Southbound ゲートウェイの DTD ファイル .sbgwimport.dtd で提供される XML エレメントを使用して、アラートのデータをマークアップします。XML ファイルを作成したら、sbgwimport ツールを実行します。このツールは、XML ファイル内のデータからイベントを作成し、サードパーティ システムを表す EventAdmin モデルに送信します。Southbound ゲートウェイは、sbgwimport ツールを実行しているホストの IP アドレスに基づき、サードパーティ システムを表す EventAdmin モデルを識別します。サードパーティ システムを表す EventAdmin モデルがまだ存在しない場合は、新しい EventAdmin モデルが自動的に作成されます。
注：
 このツールを使用するには、XML についてと、DTD の機能についての実用的な知識が必要です。
アラート データをフォーマットするための XML ファイルの作成
Southbound ゲートウェイでは .sbgwimport.dtd ファイルが提供されます。このファイルは SS-Tools ディレクトリにあります。DTD は、XML 入力ファイルの作成に使用できるエレメントを定義します。DTD では、Import エレメントと Event エレメントという 2 つのエレメントが定義されています。
Import エレメントはルート エレメントです。XML 構文ルールは、ルート エレメントが最も外側のエレメントであり、XML ファイルの先頭および終わりを示すことを指定します。そのため、Import エレメントは、入力ファイルのその他の XML エレメントを囲みます。Import エレメントには、Event エレメントという 1 つの子エレメントがあります。任意の数の Event エレメントが Import エレメント内に存在できます。
属性
一連の属性を使用してアラート データをフォーマットする際に Event エレメントが使用されます。これらの属性で、
CA Spectrum
 に送信されるイベントを定義します。eventType 属性と eventAdminName 属性を除き、これらすべての属性は、イベント データ テンプレートの特定のフィールドに対応しています。イベント データ テンプレートに対応する属性は、イベント データ テンプレートで指定されたイベント変数 ID を引き継ぎます。その後、イベント変数 ID はイベント形式ファイルで使用できます。以下のリストに、利用可能なすべての属性を定義します。
  • eventType
    イベント データ テンプレートの変数 ID： N/A
    必須の属性。この属性の値は、イベントに割り当てられた 16 進数のイベント コードである必要があります。イベント コードは、開発者 ID と、この特定のイベントを一意に識別する番号で構成された 16 進数です。開発者 ID は、イベント コードの前半を構成します。イベント コードの後半は単なる一意の番号です。この一意の番号を生成し、管理して、開発者 ID のイベント コードが繰り返されないようにすることができます。
  • uniqueId1- uniqueId6
    イベント データ テンプレートの変数 ID： 1 - 6
  • targetName
    イベント データ テンプレートの変数 ID： 7
    注： 
    CA Spectrum
     で属性の値とモデル名のマッチング時に大文字と小文字を考慮しない場合は、属性 targetNameIgnoreCase を使用できます。
  • targetAddress
    イベント データ テンプレートの変数 ID： 8
  • eventModelName
    イベント データ テンプレートの変数 ID： 10
  • eventAdminName
    イベント データ テンプレートの変数 ID： N/A
    イベントを送信するシステムを表す EventAdmin モデルがまだ存在しない場合にのみ使用されます。この EventAdmin モデルが存在しない場合、
    CA Spectrum
     は EventAdmin モデルを作成し、モデル名としてこの属性の値を使用します。
    新しい EventAdmin モデルの作成時にこの値が指定されていない場合、
    EventAdmin_<HostName>
     がモデル名として使用されます。ここで、
    <HostName>
     は sbgwimport ツールを実行しているホスト コンピュータの名前です。
    EventAdmin モデルが存在する場合、
    CA Spectrum
     は eventAdminName 属性の値を無視します。sbgwimport ツールを実行すると、このシステムに対する EventAdmin モデルが存在するため、eventAdminName 属性の値が使用されなかったことを示すメッセージが表示されます。
  • networkAddress
    イベント データ テンプレートの変数 ID： 13
  • macAddress
    イベント データ テンプレートの変数 ID： 14
  • 製造元
    イベント データ テンプレートの変数 ID： 15
    この属性は、アラート ソースの製造元で設定できます。定義されている場合、イベント形式ファイルでこの属性の値を参照できます。
  • targetNameIgnoreCase
    イベント データ テンプレートの変数 ID： 16
  • userDefined_101- userDefined_120
    イベント データ テンプレートの変数 ID： 101-120
    これらの属性は、ユーザ固有のデータを定義する場合に使用できます。定義されている場合、イベント形式ファイルでこれらの値をそれぞれ参照できます。統合のために必要な場合は、DTD にユーザ定義の属性をさらに追加することができます。その場合は、120 より大きい整数値を使用する必要があります。
アラート データ XML ファイルのサンプル
3 つのイベントを作成するサンプルの XML ファイルを以下に示します。
<?xml version="1.0" standalone="no"?>
<!DOCTYPE Import SYSTEM ".sbgwimport.dtd">
<Import>
   <Event eventType = "0x3c80000" uniqueId1 = "xyzLocation" 
    uniqueId2 = "abcPortNumber" eventAdminName = "MyTestAdmin"
    modelClass = "Router"
    userDefined_101 = "Test Application Name" />
   <Event eventType = "0x3c80004" uniqueId1 = "xyzLocation"
    uniqueId2 = "defPortNumber"
    eventAdminName = "MyTestAdmin" />
   <Event eventType = "0x3c80004" targetAddress = "10.253.29.1"
    eventAdminName = "MyTestAdmin" />
</Import>
最初のイベントには、eventType 属性で定義された 0x3c80000 のイベント コードがあります。属性の uniqueId1 と uniqueId2 は、このイベントのソースを識別するために使用されます。アラート ソースの一意の識別子として xyzLocation_abcPortNumber を作成するために、これらの属性は連結されます。イベントを受信する EventAdmin モデルは MyTestAdmin という名前です。イベントを送信するデバイスは、modelClass 属性を使用してルータとして識別されます。user_Defined_101 属性は、他のフィールドのいずれかで記述されていないデータを送信するために使用されます。
2 番目のイベントには、0x3c80004 のイベント コードがあります。属性の 'uniqueId1' と 'uniqueId2' は、このイベントのソースを識別します。一意のアラート ソースの識別子として
 '
xyzLocation_defPortNumber_ClientID0x56FF' を作成するために、これらの属性は連結されます。イベントを受信する EventAdmin モデルは 'MyTestAdmin' という名前です。
3 番目のイベントにも、0x3c80004 のイベント コードがあります。属性 targetAddress は、10.253.29.1 の IP アドレスを持つ既存の
CA Spectrum
 デバイス モデルにイベントを指示します。イベントを受信する EventAdmin モデルは 'MyTestAdmin' という名前です。
sbgwimport ツールの実行
XML ファイルを作成したら、sbgwimport ツールを実行できます。
注：
 Southbound ゲートウェイは、インポート ツールを実行するホスト コンピュータの IP アドレスに基づいて、サードパーティ システムを表す EventAdmin モデルを識別するため、サードパーティ ホストから sbgwimport ツールを実行できます。サードパーティ ホストからインポート ツールを実行するには、ツールとそのサポート ファイルのすべてをそのホストに移動します。手順については、「分散 SpectroSERVER 管理者」を参照してください。
インポート ツールを実行するには、以下の構文を使用します。
sbgwimport  - vnm v_name inputfile
  • v_name
    CA Spectrum
     サーバの名前を指定します。
  • inputfile
    XML ファイルの名前を指定します。
注：
 状況によっては（Linux の場合など）、sbgwimport ツールは実際の IP アドレスではなく、localhost のアドレス（127.0.0.1）を返すことがあります。その場合は、必要な EventAdmin モデルを識別するためにインポート ツールで使用する IP アドレスを指定します。
特定の IP アドレスを使用して sbgwimport ツールを実行するには、以下の構文を使用します。
sbgwimport -vnm v_name input_file -localIP IP address
  • IP アドレス
    IP アドレスを指定します。

Content feedback and comments