イベント・テンプレートの使用

4 イベント・テンプレートの使用

この章では、IBM Tivoli Netcool/OMNIbus REST Connectorに付属しているデフォルトのイベント・テンプレートについて説明します。

イベント・テンプレートは、Enterprise Managerイベント属性をNetcool/OMNIbusアラート属性にマップするXML変換スタイル・シートです。

Netcool/OMNIbus RESTイベント・コネクタには、Netcool/OMNIbusシステムでのイベント作成および更新操作用の事前定義済イベント・テンプレートが含まれています。特定の要件を満たすためにこれらのテンプレートをカスタマイズできます。事前に作成されているこれらのテンプレートは、カスタマイズする前にバックアップすることをお薦めします。

この章では、以下のトピックについて説明します。

デフォルトのテンプレート

この項では、Enterprise Managerイベント・データ・フィールドとNetcool/OMNIbusアラート・データ・フィールドとの間のデフォルト・マッピングについて説明します。

XMLスタイル・シート(XSL)・ファイルには、2つのシステム間のマッピングが含まれています。これらのファイルは、Enterprise Managerへのコネクタのインストールでインストールした自己更新アーカイブにあります。

「表4-1」は、マッピングを実行するXSLファイルをリストし、それぞれのサマリーを提供します。

表4-1 マッピングを実行するXSLファイル

ファイル	説明
`createEvent_request.xsl`	Oracle Enterprise Managerイベント・データをcreateEvent操作用のIBM Netcool/OMNIbusアラートの書式に変換します。
`updateEvent_request.xsl`	Oracle Enterprise Managerイベント・データをupdateEvent操作用のIBM Netcool/OMNIbusアラートの書式に変換します。

イベントの作成用テンプレート

Oracle Enterprise Manager Connectorフレームワークでは、Oracle Enterprise Managerでイベントが生成されるたびにcreateEvent操作が呼び出され、Netcool/OMNIbusコネクタを呼び出すように構成されたルールがあります。このプロセス中に、データをOracle Enterprise Managerの書式からNetcool/OMNIbusアラートの書式に変換するために、createEvent_request.xslが呼び出されます。「表4-2」は、IBM Tivoli Netcool/OMNIbusアラートとOracle Enterprise Managerイベントの間のデフォルトのフィールド・マッピングを示しています。

表4-2 Netcool/OMNIbusフィールド名

Netcool/OMNIbusフィールド名	値
識別子	イベント`EventId`フィールドに設定されます。
Node	イベント`TargetName`フィールドに設定されます。
NodeAlias	イベント`TargetName`フィールドに設定され、その後に`Target_Host`プロパティ情報が続きます。
マネージャ	Oracle Enterprise Managerとハードコードされます。
エージェント	イベント`NotificationRuleName`フィールドに設定されます。
Summary	イベント`Message`フィールドに設定されます。
Severity	重大度のマッピングに指定されているイベント重大度に基づいて重大度を設定します。
AlertGroup	イベント`EventCategory`フィールドに設定されます。
AlertKey	`EventClass`フィールドに設定され、その後にイベント`EventName`フィールドが続きます。
FirstOccurence	イベント`ReportedDate`フィールドに設定されます。
LastOccurrence	イベント`ReportedDate`フィールドに設定されます。
URL	イベント`EventURL`フィールドに設定されます。
タイプ	問題

イベントの更新用テンプレート

Oracle Enterprise Managerコネクタ・フレームワークは、Oracle Enterprise Managerでイベントが更新され、Netcool/OMNIbus RESTイベント・コネクタを起動するように構成されたルールがある場合に、updateEvent操作を起動します。updateEvent_request.xslは、Oracle Enterprise Manager形式からNetcool/OMNIbusアラート形式にデータを変換するプロセス中に起動されます。「表4-3」は、IBM Netcool/OMNIbusアラートとOracle Enterprise Managerイベントの間のデフォルトのフィールド・マッピングを示しています。

表4-3 イベント・テンプレート・マッピングの更新

Netcool/OMNIbusフィールド名	値
Severity	重大度のマッピングに指定されているイベント重大度に基づいて重大度を設定します。
Summary	イベント`Message`フィールドに設定されます。
LastOccurrence	イベント`ReportedDate`フィールドに設定されます。

重大度のマッピング

Netcool/OMNIbusアラート重大度は、Enterprise Managerイベント重大度値に基づいて設定されます。「表4-4」は、Netcool/OMNIbusでアラートを作成するときに使用される値を示しています。

表4-4 Netcool/OMNIbusアラート重大度マッピング

イベント重大度が次の場合	アラート重大度に設定する値
クリア	0
情報	1
マイナー警告	2
警告	2
クリティカル	5
致命的	5

イベント・マッピングのカスタマイズ

即時利用可能なイベント・テンプレートが要件を満たしていない場合は、それらを変更できます。変更するには、既存のテンプレートのいずれかを基本テンプレートとして使用することをお薦めします。イベント・テンプレートを新しいファイルにコピーし、新しいイベント・テンプレートを変更および登録します。

テンプレートは、EM CLIコマンドを使用するかわりに、Enterprise Managerで直接編集することもできます。

詳細は、「テンプレートの編集」と「テンプレートのリストア」を参照してください。

ほとんどの場合、イベント・テンプレートを変更するとき、マッピングの変更のみが行われることがあります。次の例では、このコンセプトについて説明しています。

「Example 4-5 IBM Tivoli Netcool/OMNIbusで警告重大度を'5'に設定」

警告の重大度を緊急度が高いに変更するテンプレートを作成するには、テンプレートの次の属性を重大度変数から変更します:

<xsl:when test="emcf:SystemAttributes/emcf:SeverityCode = 'WARNING'">2</xsl:when>

変更後:

<xsl:when test="emcf:SystemAttributes/emcf:SeverityCode = 'WARNING'">5</xsl:when>

「Example 4-2 タイプを「問題」から「情報」に変更」

IBM Tivoli Netcool/OMNIbusのイベントのみを問題として報告せず、情報として報告する場合は、Type fieldというラベルのセクションを見つけて、次の変更を行います:

<number name="Type">13</number>

テンプレートは細かくカスタマイズできます。複雑な変更は、XSLTに習熟したユーザーのみが行うことをお薦めします。

イベント・ルールをフィルタとして使用して、適切なイベント・テンプレートをイベントに関連付けることができます。イベント・テンプレートは必要な数だけ作成できます。