CA Performance Management との統合に関してイベントを設定する方法
内容
casp1032jp
内容
CA Spectrum r9.2.2 以降と CA Performance Management v2.0.00 以降の統合により、CA Spectrum がポーリングするイベントは XML ファイルで指定します。デフォルト XML ファイルの内容に基づいて、CA Spectrum は ThresholdViolation イベントを自動的にポーリングします。XML ファイルを変更しない場合、情報は、ThesholdViolation イベントについてのみ、イベント マネージャ データベースから取得されます。
イベント マネージャ データベースの任意のイベントをポーリングするように CA Spectrum を設定することもできます。そのためには、XML ファイルを変更し、CA Spectrum で他のイベント サポート ファイルをセットアップします。さらに、CA Spectrum が変更されたイベントを処理するには、デバイスまたはポートが CA Spectrum でモデリングされ、同期プロセスに組み込まれている必要があります。
特定のイベントをポーリングするように CA Spectrum を設定するには、以下の手順に従います。 完全な例を示します。
注:
ThresholdViolation イベントのみをポーリングする場合は、処理は必要ありません。開発者 ID の取得
CA Spectrum - CA Performance Management 統合のイベントを定義するときは、識別イベント コードを使用します。すべてのイベント コードの最初の 2 バイトには開発者 ID が含まれます。CA から登録済みの開発者 ID を取得して、イベントに一意のコードを指定できます。一意の開発者 ID を使用すると、OneClick において新しいコードを容易に認識でき、他の CA Spectrum イベント コードと競合する可能性を防ぐことができます。
CA から開発者 ID を取得するには、CA テクニカル サポートにお問い合わせください。
netqos-integration-application-config.xml ファイルの更新
netqos-integration-application-config.xml ファイルは次のディレクトリにあります。
$SPECROOT\tomcat\webapps\spectrum\WEB-INF\netqos\ config\container
イベントの定義
eventTypeManager bean は、CA Spectrum がポーリングするイベントを定義します。ThresholdViolation イベントへのエントリはデフォルトでファイルに表示されます。手動でさらにイベントを追加できます。
<bean id="eventTypeManager" class="com.ca.im.netqos.integration.event.type.EventTypeManager"> <property name="interestingEventTypes"> <map> <entry key="ThresholdViolation" value-ref="thresholdViolationAlarmCodes" /> <entry key="TestEvent" value-ref="TestEventAlarmCodes" /> </map> </property> <property name="alarmClearCodes"> <map> <entry key="ThresholdViolation" value="0x5c40009" /> <entry key="TestEvent" value="TestEventAlarmClearCode" /> </map> </property> </bean>
以下のプロパティ エレメントを更新し、CA Spectrum にはポーリングに含めることができるイベントを追加します。
- interestingEventTypesポーリングに含めるイベントのタイプを指定します。各エントリ エレメントは、特定のイベント タイプと、アラーム コードのマップ値を示します。ThresholdViolation エントリはデフォルトで含まれます。以下のようにエントリ エレメントを追加します。<entry key="TestEvent" value-ref="TestEventAlarmCodes" />
- TestEventイベント マネージャ データベースのイベントの名前を指定します。
- TestEventAlarmCodesこのイベントに対するアラームを示すマップの値を指定します。注:アラーム コードのマップについては、次のセクションで説明します。
- alarmClearCodesポーリングされるイベントのアラーム クリア コードを指定します。ThresholdViolation イベントのデフォルトのアラーム クリア コードは 0x5c40009 です。各イベントについて、以下のようにエントリ エレメントを追加します。<entry key="TestEvent" value="TestEventAlarmClearCode" />
- TestEventポーリング対象として追加されたイベントの名前を指定します。
- TestEventAlarmClearCodeイベントのアラーム クリア コードを指定します。
アラームの定義
アラーム マップは、特定のイベントと関連付けられるアラーム コード値を定義します。ポーリングされる各イベント(または各 interestingEventTypes エントリ)について、対応するアラーム マップを定義する必要があります。ThresholdViolation イベントのアラーム マップがデフォルトでファイルに表示されます。また、各カスタム イベントのアラーム マップを手動で追加する必要があります。
<bean id="thresholdViolationAlarmCodes" class="org.springframework.beans.factory.config.MapFactoryBean"> <property name="sourceMap"> <map> <entry key="1" value="0x5c40010" /> <entry key="2" value="0x5c40011" /> <entry key="3" value="0x5c40012" /> </map> </property> </bean> <bean id="testEventAlarmCodes" class="org.springframework.beans.factory.config.MapFactoryBean"> <property name="sourceMap"> <map> <entry key="alarmSev1" value="alarmCode1" /> <entry key="alarmSev2" value="alarmCode2" /> <entry key="alarmSev3" value="alarmCode3" /> </map> </property> </bean>
カスタム イベントのアラーム マップを追加するには、各イベントのビーン エレメントを追加し、以下の値を更新します。
- testEventAlarmCodes特定のイベントに対するアラーム コード マップ値を指定します。この値は interestingEventTypes エントリで設定されており、その値と一致する必要があります。
- alarmSev1 - alarmCode1、alarmSev2 - alarmCode2、alarmSev3 - alarmCode3特定のイベントに対するalarmSeverity-alarmCodeペアを指定します。たとえば、デフォルトの ThresholdViolation イベントの場合、Minor (1)、Major (2)、Critical (3) の各アラーム コードは、それぞれ 0x5c40010、0x5c40011、0x5c40012 です。
イベント処置ファイルの更新
イベント処置(EventDisp)ファイルは、netqos-integration-application-config.xml ファイルで設定されているイベントの処理方法を決定するために使用されます。イベント エントリはイベントを CA Spectrum イベント ファイルにマップします。
CA Spectrum と CA Performance Management の統合に関する EventDisp ファイルは、以下の場所にあります。
<$SPECROOT>\SS\CsVendor\netqos
デフォルトの ThresholdViolation イベントの場合、以下のエントリによってアラーム コードが個別の CA Spectrum イベント ファイルにマップされます。
#PC Threshold 0x5c40010 E 50 A 1,0x5c40010,107 0x5c40011 E 50 A 2,0x5c40011,107 0x5c40012 E 50 A 3,0x5c40012,107 0x5c40009 E 50 C 0x5c40010,107 C 0x5c40011,107 C 0x5c40012,107
各カスタム イベントに対し、新しいイベント マップ エントリをファイルに追加します。以下の例では、イベント コードに基づくアラームを生成またはクリアする構文を示します。
#New Event alarmCode1E 50 A 1, alarmCode1_filename,107 alarmCode2E 50 A 2, alarmCode2_filename,107 alarmCode3E 50 A 3, alarmCode3_filename,107 alarmClearCode4E 50 C alarmCode1,107 C alarmCode2,107 C alarmCode3,107
構文や例など、イベント処置ファイルの使用に関する詳細については、「」を参照してください。
イベント フォーマット ファイルの作成
イベント フォーマット ファイルには、OneClick の[イベント]タブでユーザに表示されるイベントに関するメッセージが含まれています。netqos-integration-application-config.xml ファイルで定義されている新しいイベントごとに、イベント フォーマット ファイルが必要です。このファイルにより、イベントが OneClick の[イベント]ビューで正しく表示されます。
ファイル名はアラーム コードと一致する必要があります(たとえば、アラーム コードが 0x5c40010 の場合のファイル名は「Event05c40010」)。また、ファイルは次のディレクトリに存在する必要があります。
<$SPECROOT>\SG-Support\CsEvFormat
ファイル フォーマットの例を以下に示します。
{d "%w- %d %m-, %Y - %T"} - {S 109} is reporting a minor threshold violation. Detail of Threshold Violation: 1) Incident Start Time: {D 111} 2) Event ID: {S 107} 3) Event Source: {S 113} 4) Alert Message: {S 76620} A corresponding minor Threshold Violation Alarm will be generated. (event [{e}])
詳細については、「」を参照してください。
想定される原因ファイルの作成
想定される原因ファイルでは、アラームの現象、想定される原因、推奨される是正処置が定義されています。アラームが OneClick の[アラーム]ビューに正しく表示されるように、新しいアラーム コードごとに想定される原因ファイルが必要です。
ファイル名はアラーム コードと一致する必要があります(たとえば、アラーム コードが 0x5c40010 の場合のファイル名は「Prob05c40010」)。また、ファイルは次のディレクトリに存在する必要があります。
<$SPECROOT>\SG-Support\CsPCause
ファイル フォーマットの例を以下に示します。
A minor threshold violation has occurred. SYMPTOMS: The monitored threshold has been exceeded. PROBABLE CAUSES: RECOMMENDED ACTIONS: Launch the "Performance View" to see incident details.
構文などの詳細については、「」を参照してください。
変更の展開
設定の変更をすべて行った後、SpectroSERVER サーバおよび OneClick サーバを再起動します。
イベント ポーリングにより、行った変更が反映されます。
例
次の例では、Event Manager データベースの特定のイベントをポーリングするように CA Spectrum を設定する方法を示しています。この例におけるイベントは、ルータ デバイスのメモリ使用量が多くなったときにそれを示します。
- CA Spectrum によってイベント マネージャ データベース内でポーリングするデバイスまたはポートを識別します。デバイスまたはポートが CA Spectrum でモデリングされていない場合は、エレメントをモデリングします。たとえば、特定のルータに固有のイベントを監視するには、CA Spectrum データベースにそのルータをモデリングする必要があります。
- CA Spectrum - CA Performance Management 統合で使用するための開発者 ID を CA テクニカル サポートから入手します。この例ではデフォルトの開発者 ID 値 0xffff を使用します。
- CA Spectrum がポーリングするイベントを識別します。たとえば、ルータ デバイスのメモリ使用量が高くなった状態を識別できます。この例では、このイベントを「RouterHighMemory」として参照します。
- XML ファイルを変更してイベントを定義します。
- 次のファイルを編集用に開きます。<$SPECROOT>\tomcat\webapps\spectrum\WEB-INF\netqos\config\container\netqos-integration-application-config.xml
- カスタム イベントを定義します。既存の eventTypeManager エレメントを次のように更新します。ポーリングするイベントのリストに RouterHighMemory イベントを追加します。アラーム マップ値を確立します。デフォルトのアラーム クリア コードを指定します。以下のコードでは、これらの変更を示します。アラーム クリア コードでは開発者 ID が使用されていることに注意してください。<bean id="eventTypeManager" class="com.ca.im.netqos.integration.event.type.EventTypeManager"> <property name="interestingEventTypes"> <map> <entry key="ThresholdViolation" value-ref="thresholdViolationAlarmCodes" /> <entry key="RouterHighMemory" value-ref="RouterHighMemoryAlarmCodes" /> </map> </property> <property name="alarmClearCodes"> <map> <entry key="ThresholdViolation" value="0x5c40009" /> <entry key="RouterHighMemory" value="0xffff0004" /> </map> </property> </bean>
- 次の新しいビーン エレメントを追加して、アラーム マップを定義します。<bean id="RouterHighMemoryAlarmCodes" class="org.springframework.beans.factory.config.MapFactoryBean"> <property name="sourceMap"> <map> <entry key="1" value="0xffff0001" /> <entry key="2" value="0xffff0002" /> <entry key="3" value="0xffff0003" /> </map> </property> </bean>
- ファイルを保存して閉じます。
- イベント処置ファイルを更新して、CA Spectrum が発生したイベントを処理する方法を指定します。
- 次のファイルを編集用に開きます。<$SPECROOT>\SS\CsVendor\netqos\EventDisp
- RouterHighMemory イベントに対する次のマップ エントリを追加します。#RouterHighMemory Event 0xffff0001E 50 A 1, 0xffff0001,107 0xffff0002E 50 A 2, 0xffff0002,107 0xffff0003E 50 A 3, 0xffff0003,107 0xffff0004E 50 C 0xffff0001,107 C 0xffff0002,107 C 0xffff0003,107
- ファイルを保存して閉じます。
- 次の命名規則(AlarmCode-EventFormatFile)を使用して、各アラーム コードのイベント フォーマット ファイルを作成します。
- 0xffff0001 - Eventffff0001
- 0xffff0002 - Eventffff0002
- 0xffff0003 - Eventffff0003
- 0xffff0004 - Eventffff0004
- 次のような内容のテキスト ファイルを作成します。{d "%w- %d %m-, %Y - %T"} - {S 109} is reporting a minor threshold violation. Detail of Threshold Violation: 1) Incident Start Time: {D 111} 2) Event ID: {S 107} 3) Event Source: {S 113} 4) Alert Message: {S 76620} A corresponding minor Threshold Violation Alarm will be generated. (event [{e}])注:Eventffff0004 を作成するときは、アラームがわかりやすいように適切な表現を使用してください。
- ファイルを次の場所に保存します。<$SPECROOT>\SG-Support\CsEvFormat
- アラーム コードごとにステップ a と b を繰り返します。
- 次の命名規則(AlarmCode-ProbableCauseFile)を使用して、各アラーム コードの想定される原因ファイルを作成します。
- 0xffff0001 - Probffff0001
- 0xffff0002 - Probffff0002
- 0xffff0003 - Probffff0003
- 0xffff0004 - Probffff0004
- 次のような内容のテキスト ファイルを作成します。A minor threshold violation has occurred. SYMPTOMS: The monitored threshold has been exceeded. PROBABLE CAUSES: RECOMMENDED ACTIONS: Launch the "Performance View" to see incident details.
- ファイルを次の場所に保存します。<$SPECROOT>\SG-Support\CsPCause
- アラーム コードごとにステップ a と b を繰り返します。
- SpectroSERVER サーバおよび OneClick サーバを再起動します。統合が完了すると、CA Spectrum は更新されたファイルを使用して RouterHighMemory イベントをポーリングし、指定されたようにイベントとアラームを生成します。