跳至主要内容

轉遞事件到 REST Web 服務

您可以配置 Lenovo XClarity Orchestrator,將特定事件轉遞至 REST Web 服務。

開始之前

小心
將資料轉遞至此服務時,不會建立安全連線。資料是透過明文通訊協定傳送。

關於此作業

如果啟用了資源型存取控制,可轉遞的資料將僅限於您可以使用存取控制清單存取的資源。如果您不是已獲指派預先定義監督者角色之群組的成員,則必須為您建立的轉遞器指派一個或多個存取控制清單。如果要傳送所有您可以存取的資源的資料,請選取與資源相關聯且可供您使用的所有存取控制清單。如果您是已獲指派預先定義監督者角色之群組的成員,則可以選擇傳送所有資源的資料,也可以選擇指派存取控制清單以限制資源。

一般資料轉遞過濾器用於根據事件碼、事件類別、事件嚴重性、服務類型和產生事件的資源,定義您要轉遞的事件範圍。請確定已經建立要用於此轉遞器的事件和資源過濾器(請參閱建立資料轉遞過濾器)。

下列範例顯示轉遞至 REST Web 服務的資料預設格式。轉遞資料時,雙方括弧中的詞組都是要更換成實際值的屬性。
{\"msg\":\"[[EventMessage]]\",\"eventID\":\"[[EventID]]\",\"serialnum\":
\"[[EventSerialNumber]]\",\"senderUUID\":\"[[EventSenderUUID]]\",\"flags\":
\"[[EventFlags]]\",\"userid\":\"[[EventUserName]]\",\"localLogID\":
\"[[EventLocalLogID]]\",\"systemName\":\"[[DeviceFullPathName]]\",\"action\":
[[EventActionNumber]],\"failFRUNumbers\":\"[[EventFailFRUs]]\",\"severity\":
[[EventSeverityNumber]],\"sourceID\":\"[[EventSourceUUID]]\",
\"sourceLogSequence\":[[EventSourceLogSequenceNumber]],\"failFRUSNs\":
\"[[EventFailSerialNumbers]]\",\"failFRUUUIDs\":\"[[EventFailFRUUUIDs]]\",
\"eventClass\":[[EventClassNumber]],\"componentID\":\"[[EventComponentUUID]]\",
\"mtm\":\"[[EventMachineTypeModel]]\",\"msgID\":\"[[EventMessageID]]\",
"sequenceNumber\":\"[[EventSequenceID]]\",\"timeStamp\":\"[[EventTimeStamp]]\",
\"args\":[[EventMessageArguments]],\"service\":[[EventServiceNumber]],
\"commonEventID\":\"[[CommonEventID]]\",\"eventDate\":\"[[EventDate]]\"}"

程序

若要將資料轉遞至 REST Web 服務,請完成下列步驟。

  1. XClarity Orchestrator 功能表列上,按一下監視 (監視圖示) > 轉遞,然後按一下左側導覽窗格中的資料轉遞器以顯示資料轉遞器卡片。
  2. 按一下建立圖示 (新增圖示),以顯示建立資料轉遞器對話框。
  3. 指定轉遞器名稱和選擇性描述。
  4. 按一下狀態切換開關,以選擇啟用或停用轉遞器。
  5. 選取 REST 做為轉遞器類型。
  6. 按一下配置,然後填寫通訊協定特定資訊。
    • 輸入 REST 伺服器的主機名稱或 IP 位址。
    • 輸入用於轉遞事件的埠。預設值為 80
    • 輸入轉寄站所在的資源路徑(例如,/rest/test)以張貼事件。
    • 選取 REST 方法。這可能是下列其中一個值。
      • PUT
      • POST
    • 選取用於轉遞事件的通訊協定。這可能是下列其中一個值。
      • HTTP
      • HTTPS
    • 輸入要求的逾時期間(單位秒)。預設值為 30 秒。
    • 如果需要鑑別,請選取下列其中一個鑑別類型。
      • 基本。使用指定的使用者 ID 及密碼鑑別指定的伺服器。
      • 權杖。使用指定的權杖標頭名稱和值鑑別指定的伺服器。
  7. 按一下過濾器,然後您可以選擇性地選取要用於此轉遞器的過濾器。

    您最多可以選取一個事件過濾器和一個資源過濾器。

    如果您未選取過濾器,則會轉遞所有資源(裝置、資源管理器和 XClarity Orchestrator)產生的所有事件的資料。

    在此標籤中,您也可以選擇轉遞排除的事件,方法是將排除的事件切換開關設定為

  8. 按一下存取控制清單,然後選取您要與此轉遞器關聯的一個或多個存取控制清單。

    如果啟用了資源型存取控制,則必須選取至少一個存取控制清單。

    提示
    已獲指派預先定義監督者角色之群組的成員使用者可以選擇性地選取符合所有內容,而不是選取存取控制清單,如此轉遞的資料便不受限制。
  9. 按一下建立,以建立轉遞器。

在您完成之後

您可以在資料轉遞器卡片上執行下列動作。

  • 選取狀態欄中的切換開關,以啟用或停用選取的轉遞器
  • 按一下編輯圖示 (編輯圖示),以修改選取的轉遞器。
  • 按一下刪除圖示 (刪除圖示),以移除選取的轉遞器。