A デフォルト・マッピング

この付録では、Enterprise Managerアラート・データ・フィールドとMicrosoft SCOMアラート・データ・フィールドとの間のデフォルト・マッピングについて説明します。データはXML書式で、XSLTファイルではデータを1つの書式から別の書式に変換します。

フィールド・マッピングのカスタマイズについては、第4章の「マッピングのカスタマイズ」を参照してください。

この付録では、次の項目について説明します。

• データ変換ファイル

• createEvent操作

• updateEvent操作

• getNewAlertsおよびgetUpdatedAlerts操作

データ変換ファイル

XMLスタイル・シート（XSL）・ファイルには、2つのシステム間のマッピングが含まれています。これらのファイルは次のディレクトリにあります。

$ORACLE_HOME/sysman/connector/SCOM_Connector

表A-1は、マッピングを実行するXSLファイルと、それぞれの概要を示しています。

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

ファイル	説明
createEvent_request.xsl	Oracle Enterprise Managerアラート・データをcreateEvent操作用のMicrosoft SCOMアラートの書式に変換します。
updateEvent_request.xsl	Oracle Enterprise Managerアラート・データをupdateEvent操作用のMicrosoft SCOMアラートの書式に変換します。
getNewAlerts_response.xsl	Microsoft SCOMアラートの書式のデータをOracle Enterprise Managerアラートの書式に変換します。このファイルは、getNewAlertsポーリング操作に対するレスポンスを変換するために起動されます。
getUpdatedAlerts_response.xsl	Microsoft SCOMアラートの書式のデータをOracle Enterprise Managerアラートの書式に変換します。このファイルは、getUpdatedAlertsポーリング操作に対するレスポンスを変換するために起動されます。

この後の項では、各ファイルでのデフォルト・マッピングの詳細を説明します。

createEvent操作

Oracle Enterprise Manager Connectorフレームワークでは、Oracle Enterprise Managerでアラートが生成され、SCOM Connectorを起動するために構成された通知ルールがあるときには、createEvent操作を起動します。createEvent_request.xslは、Oracle Enterprise Managerの書式からSCOMアラートの書式へデータを変換するプロセスで起動されます。表A-2は、Microsoft SCOMアラートとOracle Enterprise Managerアラート間のデフォルト・フィールド・マッピングを示しています。

表A-2 createalert操作のマッピング

SCOMフィールド	SCOM属性タイプ	必須	Oracle Enterprise Managerアラート属性	値
Name	文字列	○	Metric Columnに設定します。	<MetricColumn>
Description	文字列	○	アラート・コンテキストの値は、「値」列で山カッコ内に示されます。	Oracle Enterprise Managerによって報告される受信アラート: Collection Time - <Collection Time> Target Type - <TargetType> Target Name - <TargetName> Metric Name - <MetricName> Metric Column - <MetricColumn> * Key Values - <KeyValues> Severity - <Severity> * Notification Rule - <NotificationRuleName> * URL - <EventPageURL> Message - <Message> 前にアスタリスク（*）の付いたフィールドは、対応するEnterprise Managerアラート・フィールドにデータがある場合にのみ存在します。
Priority	文字列	○	Oracle Enterprise Managerの重大度に基づく条件付きです。	Oracle Enterprise ManagerのSeverityがInformationの場合は、Lowに設定します。 Oracle Enterprise ManagerのSeverityがCriticalの場合は、Normalに設定します。 それ以外のOracle Enterprise ManagerのSeverityの値の場合は、Highに設定します。
Severity	文字列	○	Oracle Enterprise Managerの重大度に基づく条件付きです。	Oracle Enterprise ManagerのSeverityがInformationの場合は、Informationに設定します。 Oracle Enterprise ManagerのSeverityがCriticalの場合は、Errorに設定します。 それ以外のOracle Enterprise ManagerのSeverityの値の場合は、Warningに設定します。

updateEvent操作

Oracle Enterprise Manager Connectorフレームワークでは、Oracle Enterprise Managerでアラートが生成され、SCOM Connectorを起動するために構成された通知ルールがあるときには、updateEvent操作を起動します。updateEvent_request.xslは、Oracle Enterprise Managerの書式からSCOMアラートの書式へデータを変換するプロセスで起動されます。表A-3は、Microsoft SCOMアラートとOracle Enterprise Managerアラート間のデフォルト・フィールド・マッピングを示しています。

表A-3 updateEvent操作のマッピング

SCOMフィールド	SCOM属性タイプ	必須	Oracle Enterprise Managerアラート属性	値
Id	文字列	○	External Event Idに設定します。	<ExternalEventId>
Resolution State	文字列	○	Oracle Enterprise Managerの重大度に基づく条件付きです。	Oracle Enterprise ManagerのSeverityがClear、Unreachable End、Blackout End、Metric Error End、またはEndの場合は255（Closed）に設定します。 それ以外のOracle Enterprise ManagerのSeverityの値の場合は、0（New）に設定します。
Alert History	文字列	×	Oracle Enterprise Managerの重大度に基づく条件付きです。	Oracle Enterprise ManagerのSeverityがClearの場合、「Oracle Enterprise Manager cleared alert」に設定します。 Oracle Enterprise ManagerのSeverityがWarningの場合、「Oracle Enterprise Manager changed alert severity to warning」に設定します。 Oracle Enterprise ManagerのSeverityがCriticalの場合、「Oracle Enterprise Manager changed alert severity to critical」に設定します。 それ以外のOracle Enterprise ManagerのSeverityの値の場合は設定しません。

getNewAlertsおよびgetUpdatedAlerts操作

Oracle Enterprise Manager Connectorフレームワークでは、SCOM Connector用に構成されたポーリング・サイクルで、getNewAlerts操作を起動します。操作の1ステップは、Microsoft SCOM Webサービスに対してMicrosoft SCOMに新規のアラートがないか問い合せるリクエストを送信することです。レスポンスが返ってくると、Microsoft SCOMのアラート・データをOracle Enterprise Managerで新規のアラートを作成するのに必要な書式に変換するために、getNewAlerts_response.xslファイルが起動されます。

getNewAlerts操作が完了すると、Enterprise Manager ConnectorフレームワークではgetUpdatedAlerts操作が実行されます。getNewAlerts操作と同様に、Microsoft SCOM Webサービスに更新されたアラートがないか問い合せるリクエストを送信します。レスポンスが返ってくると、Microsoft SCOMのアラート・データをOracle Enterprise Managerでアラートを更新するのに必要な書式に変換するために、getUpdatedAlerts_response.xslファイルが起動されます。

表A-4は、Microsoft SCOMアラートとOracle Enterprise Managerアラート間のデフォルト・フィールド・マッピングを示しています。これらのマッピングは、新規および更新アラートに適用でき、常に同じであることが必要です。

表A-4 getNewAlertsおよびgetUpdatedAlerts操作のマッピング

Oracle Enterprise Managerアラート属性	属性タイプ	必須	SCOMアラート属性	値
key1	文字列	○	Microsoft SCOMのアラート識別子に設定します。	<Identifier>
message	文字列	○	アラートの値は、「値」列で山カッコ内に示されます。	Name — <Name> Computer Name — <NetbiosComputerName> Severity — <source> Object — <Severity> Rule Id — <MonitoringRuleId>
comment	文字列	○	アラートの値は、「値」列で山カッコ内に示されます。	Resolution State — <Status> Message — <Description>
producerID	文字列	×	デフォルト設定値。	SCOM
targetName	文字列	○	Microsoft SCOMのプリンシパル名に基づく条件付きです。	SCOMのプリンシパル名にデータが含まれる場合は、<PrincipalName>に設定します。 SCOMのプリンシパル名が空白または存在しない場合は、Unknownに設定します。
TargetType	文字列	×	デフォルト設定値。	scom_managed_host
username	文字列	×	デフォルトは値なし。
password	文字列	×	デフォルトは値なし。
metricName	文字列	○	SCOMアラートのソースに設定します。	<Source>
category	文字列	○	SCOMアラートのソースに設定します。	<Source>
value	文字列	○	トランザクション識別子に設定します。これはアラート・データの一部ではありません。トランザクション追跡のために、Webサービスによって提供されます。	<transactionID>
severity	文字列	○	Microsoft SCOMのステータスおよび重大度に基づく条件付きです。	SCOMのステータスが255（Closed）の場合は、Clearに設定します。 SCOMのステータスが255に設定されておらず、SCOMの重大度がInformationの場合、Informationalに設定します。 SCOMのステータスが255に設定されておらず、Microsoft SCOMの重大度がErrorの場合、Criticalに設定します。 SCOMのステータスが255に設定されておらず、SCOMの重大度にその他の値が指定されている場合、Warningに設定します。