使用 Universal Connector

更新日期: 2009年7月

適用於: Operations Manager 2007 R2, Operations Manager 2007 SP1

Universal Connector 設計成可透過連接器服務,將 Operations Manager 2007 R2 警示傳送到可部署在 Windows 作業系統或支援之 UNIX 與 Linux 平台的任何遠端系統。本節提供必要的通訊資訊和範例警示格式,讓遠端系統的系統管理員或開發人員能夠使用 Universal Connector 啟用 Operations Manager 2007 R2 警示轉寄。

警示通訊週期與需求

在安裝及設定 Universal Connector 後,此服務便會進入執行狀態,而且可以使用設定連接器中說明的設定,將 Operations Manager 2007 R2 警示轉寄到遠端系統。Operations Manager 2007 R2 警示是以手動方式轉寄,或是以控制連接器轉寄所述的產品連接器訂閱來轉寄。

遠端系統的系統管理員或開發人員必須實作整合邏輯,才能從 Interop Provider 儲存在遠端系統伺服器的 Operations Manager 2007 R2 警示或警示更新檔案,傳送資料到遠端系統。這項程序也可以包括從遠端系統提供檔案給 Interop Provider,以通知來自 Operations Manager 2007 R2 的警示和警示更新。若遠端系統針對來自 Operations Manager 2007 R2 警示的事件張貼更新,此程序也應該從遠端系統提供檔案給 Interop Provider。這個傳送程序還包括將遠端系統已知的欄位或內容名稱和值轉譯或對應至 Operations Manager 2007 R2 所使用的欄位或內容名稱和值。您可以從 EventType 欄位在所有訊息中都是必要項目,可用來判定訊息是新警示、新警示通知、警示更新、警示更新通知,還是遠端系統更新。

請參閱附錄 D - Universal Connector,取得所需整合邏輯的 PowerShell 範例。

Interop 連接器警示生命週期

從 Operations Manager 2007 R2 轉寄到遠端系統的警示和警示更新中,包含 [Universal 連接器設定] 對話方塊之 [警示欄位] 索引標籤中指定的欄位。下表顯示從 Operations Manager 2007 R2 轉寄之警示和更新中包含的必要欄位。表中顯示的是清除 [警示欄位] 索引標籤中的所有可選欄位後,警示和警示更新中仍然會回報的欄位。另外,此表格也顯示在來自遠端系統的通知和更新中,必須傳回給 Operations Manager 2007 R2 的欄位。

最少或必要的警示、更新與通知欄位

訊息類型 最少或必要欄位

新增 Operations Manager 警示

AlertID
EventType=0
ManagementGroupName
優先順序
ResolutionState
狀態

Operations Manager 警示的更新

AlertID
EventType=1
ManagementGroupName
優先順序
ResolutionState
狀態

遠端系統新增警示通知

AlertID
EventID
EventType=2
ManagementGroupName

遠端系統警示更新通知

AlertID
EventID
EventType=3
ManagementGroupName

Operations Manager 警示的遠端系統更新

AlertID
EventType=1
ManagementGroupName

從遠端系統傳回的通知訊息中,只有 EventID 欄位會寫入 Operations Manager 2007 R2 資料庫。該欄位中的值會寫入該項警示的 TicketID 欄位。

從遠端系統傳回的更新中,下列訊息欄位可以寫入 Operations Manager 2007 R2 資料庫:

以下是傳入及送出 Universal Connector 訊息的資料夾或目錄 (相對於 Interop Provider 安裝目錄)。Windows 作業系統或 UNIX 平台的這些路徑都相同。遠端系統傳回的檔案名稱必須是 <檔名>.xml (適用於 Windows 作業系統) 或 <檔名>.evt (適用於 UNIX 和 Linux 平台)。

Interop Provider 從 Operations Manager 2007 Universal Connector 接收訊息的路徑:


          %提供者安裝目錄%\UnvEvents\FromOpsMgr

Interop Provider 從遠端系統接收訊息的路徑:


          %提供者安裝目錄%\UnvEvents\%管理群組%

警示訊息格式

下列範例顯示從連接器服務轉寄到遠端系統之 Interop Provider 的簡單警示訊息。在 Windows 作業系統上,此警示必須以 XML 格式 (*.xml) 傳送,而在 UNIX 和 Linux 平台上則必須以文字檔中的內容 (*.evt) 傳送。在各種類型的平台中,將通知或更新訊息從 Interop Provider 傳回給 Operations Manager 2007 R2 時,訊息的格式必須與轉寄到 Interop Provider 時所用的格式相同。

note附註
警示訊息格式可以在 [Universal 連接器設定] 對話方塊中設定成 XML 或 EVT。XML 是 Windows 作業系統的預設值,而 EVT 則是 UNIX 平台的預設值。

XML 格式

下列範例 Operations Manager 2007 R2 警示是以 XML 格式轉寄至 Windows 作業系統上的遠端系統。


<?xml version="1.0" standalone="yes"?>

<UNVEvent> <AlertId>4be9ec63-c23b-4aa0-806a-0e91d84cd33f</AlertId> <Category>Custom</Category> <ComputerDomain>YourCorpDomain</ComputerDomain> <ConnectorId>fae610c9-9403-4b5e-b5d6-a81575b35f1f</ConnectorId> <ConnectorStatus>Pending</ConnectorStatus> <Description>evt created by Microsoft</Description> <EventId>102</EventId> <EventType>1</EventType> <LastModifiedByNonConnector>11/7/2008 10:00:01 PM</LastModifiedByNonConnector> <MaintenanceModeLastModified>1/1/1900 12:00:00 AM</MaintenanceModeLastModified> <ManagementGroupName>YourCorpMgGrp</ManagementGroupName> <ModifiedBy>YourCorpDomain\admin</ModifiedBy> <MonitoringObjectId>39e8d0dc-45d2-3dc3-ace0-1731b3078218</MonitoringObjectId> <MonitoringObjectPath>YourCorpMgGrp.YourCorpDomain.com</MonitoringObjectPath> <MonitoringRuleId>894b1b8d-2162-62f3-a286-abd7cdcb2582</MonitoringRuleId> <Priority>Normal</Priority> <ProblemId>2811d1fd-1299-4f37-9c47-9b23ffa9fb1f</ProblemId> <ResolutionState>New</ResolutionState> <Severity>Error</Severity> <StateLastModified>10/30/2008 5:00:01 PM</StateLastModified> <TimeAdded>11/6/2008 7:55:23 PM</TimeAdded> <TimeOfLastEvent>11/7/2008 10:00:01 PM</TimeOfLastEvent> <TimeResolutionStateLastModified>11/6/2008 7:59:59 AM</TimeResolutionStateLastModified> </UNVEvent>

內容文字檔格式

下列範例 Operations Manager 2007 R2 警示會以文字檔格式的內容轉寄至 UNIX 或 Linux 平台上的遠端系統。

AlertId=1b11d523-1b91-40e3-a318-43d810d7951f Category=Custom ComputerDomain=YourCorpDomain ConnectorId=fae610c9-9403-4b5e-b5d6-a81575b35f1f ConnectorStatus=Pending Description=evt created by Microsoft EventId=102 EventType=1 LastModifiedByNonConnector=11/7/2008 10:00:01 PM MaintenanceModeLastModified=1/1/1900 12:00:00 AM ManagementGroupName=YourCorpMgGrp ModifiedBy=YourCorpDomain \admin MonitoringObjectId=39e8d0dc-45d2-3dc3-ace0-1731b3078218 MonitoringObjectPath=OpsMgr01.YourCorpDomain.com MonitoringRuleId=894b1b8d-2162-62f3-a286-abd7cdcb2582 Priority=Normal ProblemId=d2ff0b6b-c27e-477f-bb05-a3d2988387af ResolutionState=New Severity=Error StateLastModified=10/30/2008 5:00:01 PM TimeAdded=11/6/2008 7:55:23 AM TimeOfLastEvent=11/7/2008 10:00:01 PM TimeResolutionStateLastModified=11/6/2008 7:59:59 AM

顯示: