Skip Headers
Oracle® Enterprise Manager Installation and Configuration Guide for Microsoft Systems Center Operations Manager Connector
Release 1.0.5.2.0

E14736-08
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

A Default Mappings

This appendix describes the default mappings between the Enterprise Manager alert data fields and the Microsoft SCOM alert data fields. The data is formatted in XML, and the XSLT files transform the data from one format to another.

For information on customizing the field mappings, see Section 4.1, "Customizing Mappings".

This appendix discusses the following topics:

Data Translation Files

XML Style Sheet (XSL) files contain the mappings between the two systems. These files are located in the following directory:

$ORACLE_HOME/sysman/connector/SCOM_Connector

Table A–1 lists the XSL files that perform the mappings and provides a summary of each.

Table A-1 XSL Files that Perform Mappings

File Description

createEvent_request.xsl

Transforms the Oracle Enterprise Manager alert data to the Microsoft SCOM alert format for the createEvent operation.

updateEvent_request.xsl

Transforms the Oracle Enterprise Manager alert data to the Microsoft SCOM alert format for the updateEvent operation.

getNewAlerts_response.xsl

Transforms data in the Microsoft SCOM alert format to the Oracle Enterprise Manager alert format. This file is invoked to transform the response for the getNewAlerts poll operation.

getUpdatedAlerts_response.xsl

Transforms data in the Microsoft SCOM alert format to the Oracle Enterprise Manager alert format. This file is invoked to transform the response for the getUpdatedAlerts poll operation.


The following sections provide details about the default mappings in each of the files.

createEvent Operation

The Oracle Enterprise Manager Connector Framework invokes the createEvent operation whenever an alert is generated in Oracle Enterprise Manager and a notification rule is configured to invoke the SCOM connector. createEvent_request.xsl is invoked during the process to transform the data from Oracle Enterprise Manager format to SCOM alert format. Table A–2 lists the default field mappings between the Microsoft SCOM alert and the Oracle Enterprise Manager alert.

Table A-2 createalert Operation Mappings

SCOM Field SCOM Attribute Type Req'd? Oracle Enterprise Manager Alert Attributes Value

Name

String

Yes

Set to the Metric Column.

<MetricColumn>

Description

String

Yes

Values from the alert context are listed in angle brackets in the Value column.

Received alert reported by 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>

Fields preceded with an asterisk ( * ) are only present if the corresponding Enterprise Manager alert field has data.

Priority

String

Yes

Conditional based on the Oracle Enterprise Manager severity.

Set to Low if Oracle Enterprise Manager Severity is Information.

Set to Normal if Oracle Enterprise Manager Severity is Critical.

Set to High for all other Oracle Enterprise Manager severity values.

Severity

String

Yes

Conditional based on the Oracle Enterprise Manager severity.

Set to Information if Oracle Enterprise Manager Severity is Information.

Set to Error if Oracle Enterprise Manager Severity is Critical.

Set to Warning for all other Oracle Enterprise Manager severity values.


updateEvent Operation

The Oracle Enterprise Manager Connector Framework invokes the updateEvent operation whenever an alert is generated in Oracle Enterprise Manager and a notification rule is configured to invoke the SCOM connector. updateEvent_request.xsl is invoked during the process to transform the data from Oracle Enterprise Manager format to SCOM alert format. Table A–3 lists the default field mappings between the Microsoft SCOM alert and the Oracle Enterprise Manager alert.

Table A-3 updateEvent Operation Mappings

SCOM Field SCOM Attribute Type Req'd? Oracle Enterprise Manager Alert Attributes Value

Id

String

Yes

Set to the External Event Id.

<ExternalEventId>

Resolution State

String

Yes

Conditional based on the Oracle Enterprise Manager severity

Set to 255 (Closed) if Oracle Enterprise Manager Severity is Clear, Unreachable End, Blackout End, Metric Error End, or End.

Set to 0 (New) for all other Oracle Enterprise Manager severity values.

Alert History

String

No

Conditional based on the Oracle Enterprise Manager severity.

Set to " Oracle Enterprise Manager cleared alert" if Oracle Enterprise Manager severity is Clear.

Set to " Oracle Enterprise Manager changed alert severity to warning" if Oracle Enterprise Manager severity is Warning.

Set to " Oracle Enterprise Manager changed alert severity to critical" if Oracle Enterprise Manager severity is Critical.

Not set for other Oracle Enterprise Manager severity values.


getNewAlerts and getUpdatedAlerts Operations

The Oracle Enterprise Manager Connector Framework invokes the getNewAlerts operation on the poll cycle interval configured for the SCOM connector. One step in the operation is to send a request to the Microsoft SCOM web service for new alerts in Microsoft SCOM. When the response comes back, the getNewAlerts_response.xsl file is invoked to transform the Microsoft SCOM alert data to the format required to create new alerts in Oracle Enterprise Manager.

After the getNewAlerts operation is complete, the Enterprise Manager Connector Framework performs the getUpdatedAlerts operation. Like the getNewAlerts operation, it sends a request to the Microsoft SCOM web service for updated alerts. When the response comes back, the getUpdatedAlerts_response.xsl file is invoked to transform the Microsoft SCOM alert data to the format required to update the alerts in Oracle Enterprise Manager.

Table A–4 lists the default field mappings between the Microsoft SCOM alert and the Oracle Enterprise Manager alert. These mappings are applicable to new and updated alerts, and must always be the same.

Table A-4 getNewAlerts and getUpdatedAlerts Operation Mappings

Oracle Enterprise Manager alert Attribute Attribute Type Req'd? SCOM Alert Attributes Value

key1

String

Yes

Set to the Microsoft SCOM alert identifier.

<Identifier>

message

String

Yes

Values from the alert are listed in angle brackets in the Value column.

Name — <Name>Computer Name — <NetbiosComputerName>Severity — <source>Object — <Severity>Rule Id — <MonitoringRuleId>

comment

String

Yes

Values from the alert are listed in angle brackets in the Value column.

Resolution State — <Status>Message — <Description>

producerID

String

No

Value defaulted.

SCOM

targetName

String

Yes

Conditional based on the Microsoft SCOM Principal Name.

Set to <PrincipalName> if the SCOM Principal Name contains data.

Set to Unknown if the SCOM Principal Name is blank or missing.

TargetType

String

No

Value defaulted.

scom_managed_host

username

String

No

Value defaulted to no value.

 

password

String

No

Value default to no value.

 

metricName

String

Yes

Set to the SCOM alert source.

<Source>

category

String

Yes

Set to the SCOM alert source.

<Source>

value

String

Yes

Set to the transaction identifier. This is not part of the alert data. It is provided by the web service for tracking transactions.

<transactionID>

severity

String

Yes

Conditional based on the Microsoft SCOM status and severity.

Set to Clear if the SCOM status is set to 255 (Closed).

Set to Informational if the SCOM status is not set to 255 and the SCOM severity is Information.

Set to Critical if the SCOM status is not set to 255 and the Microsoft SCOM severity is Error.

Set to Warning if the SCOM status is not set to 255 and any other SCOM severity value is specified.