新增 REST 外掛程式可讓您傳送 vRealize Operations Cloud 警示至另一個支援 REST 的應用程式,您可以在其中建置 REST Web 服務來接受這些訊息。或者,您也可以使用雲端 Proxy 進行通訊。

REST 外掛程式支援啟用整合,但不提供整合。根據目標應用程式,您可能需要某個媒介 REST 服務,或者某些其他會將 REST 警示輸出包含的警示和物件識別碼與目標應用程式中的識別碼相關聯的機制。

決定您要傳遞至目標應用程式的內容類型。如果您選取 application/json,則所傳送的 POST 或 PUT 呼叫的本體具有下列格式:包含了取樣資料。
{
   "startDate":1369757346267,
   "criticality":"ALERT_CRITICALITY_LEVEL_WARNING",
   "Risk":4.0,
   "resourceId":"sample-object-uuid",
   "alertId":"sample-alert-uuid",
   "status":"ACTIVE",
   "subType":"ALERT_SUBTYPE_AVAILABILITY_PROBLEM",
   "cancelDate":1369757346267,
   "resourceKind":"sample-object-type",
   "alertName":"Invalid IP Address for connected Leaf Switch",
   "attributeKeyID":5325,
   "Efficiency":1.0,
   "adapterKind":"sample-adapter-type",
   "Health":1.0,
   "type":"ALERT_TYPE_APPLICATION_PROBLEM",
   "resourceName":"sample-object-name",
   "updateDate":1369757346267,
   "info":"sample-info"
}
如果您選取 application/xml,則所傳送的 POST 或 PUT 呼叫的本體具有下列格式:
<alert>
  <startDate>1369757346267</startDate>
  <criticality>ALERT_CRITICALITY_LEVEL_WARNING</criticality>
  <Risk>4.0</Risk>
  <resourceId>sample-object-uuid</resourceId>
  <alertId>sample-alert-uuid</alertId>
  <status>ACTIVE</status>
  <subType>ALERT_SUBTYPE_AVAILABILITY_PROBLEM</subType>
  <cancelDate>1369757346267</cancelDate>
  <resourceKind>sample-object-type</resourceKind>
  <alertName>Invalid IP Address for connected Leaf Switch</alertName>
  <attributeKeyId>5325</attributeKeyId>
  <Efficiency>1.0</Efficiency>
  <adapterKind>sample-adapter-type</adapterKind>
  <Health>1.0</Health>
  <type>ALERT_TYPE_APPLICATION_PROBLEM</type>
  <resourceName>sample-object-name</resourceName>
  <updateDate>1369757346267</updateDate>
  <info>sample-info</info>
</alert>
備註: 若警示是由非度量違規所觸發,則會從 REST 輸出省略 attributeKeyID 且不予以傳送。

如果要求是做為 POST 處理,則針對 JSON 或 XML,Web 服務會傳回 HTTP 狀態碼 201,這表示已在目標處成功建立警示。如果要求是做為 PUT 處理,則會傳回 HTTP 狀態碼 202,這表示已在目標處成功接受警示。

必要條件

確保您瞭解在環境中如何以及在何處耗用和處理使用 REST 外掛程式所傳送的警示,並確保您有適當的連線資訊可用。

程序

  1. 在功能表中按一下管理,然後在左窗格中按一下管理
  2. 按一下輸出設定,然後按一下新增
  3. 外掛程式類型下拉式功能表中,選取 REST 通知外掛程式
    對話方塊即展開以包含 REST 設定。
  4. 或者,您可按一下使用 Proxy 核取方塊,然後從收集器/群組下拉式功能表中選取雲端 Proxy 以建立連線。
    備註: 如果您的郵件或 rest 伺服器位於 AWS 以外,則必須使用雲端 Proxy。
  5. 輸入執行個體名稱
    這是識別您在稍後設定通知規則時所選取的這個執行個體的名稱。
  6. 設定適合您環境的 Rest 選項。
    選項 說明
    URL

    將警示傳送到的 URL。URL 必須支援 HTTPS。當警示傳送至 REST Web 伺服器時,外掛程式會將 /{alertID} 附加至 POST 或 PUT 呼叫。

    使用者名稱

    目標 REST 系統上的使用者帳戶。

    密碼

    使用者帳戶密碼。

    內容類型

    指定警示輸出的格式。

    • application/json。使用 JavaScript Object Notation,以人類看得懂的文字傳輸警示資料。
    • application/xml。使用人類看得懂的 XML和機器可讀內容,傳輸警示資料。
    憑證指紋
    HTTPS 服務之公開憑證的指紋。SHA1 或 SHA256 演算法可擇一使用。
    備註: 必須在 vRealize Operations Cloud 中新增憑證指紋。
    連線計數

    限制傳輸到目標 REST 伺服器的同時警示數。使用此數目可確保要求不會對 REST 伺服器造成太大負擔。

  7. 按一下儲存
  8. 若要啟動此外掛程式的輸出警示服務,請選取清單中的執行個體,然後按一下工具列上的啟用

結果

針對輸出警示的此 REST 外掛程式執行個體已設定並在執行中。

後續步驟

建立使用 REST 外掛程式將警示傳送到在環境中支援 REST 的應用程式或服務的通知規則。請參閱 使用者案例:建立 vRealize Operations Cloud REST 警示通知