REST 플러그인을 추가하면 vRealize Operations Manager 경고를 이러한 메시지를 받아들이도록 REST 웹 서비스를 구축한 다른 REST 지원 애플리케이션에 보낼 수 있습니다.

REST Plug-In은 통합 사용을 지원할 뿐이며 통합을 제공하지는 않습니다. 대상 애플리케이션에 따라 중재 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>
참고: 경고가 메트릭 이외의 위반으로 인해 발동될 경우 attributeKeyID이(가) REST 출력에서 제거되고 전송되지 않습니다.

요청이 POST로 처리되는 경우 JSON 또는 XML에 대해 웹 서비스는 HTTP 상태 코드 201을 반환하며 이 코드는 경고가 대상에서 생성되었음을 나타냅니다. 요청이 PUT으로 처리되는 경우 HTTP 상태 코드 202를 반환하며 이 코드는 경고가 대상에서 받아들여졌음을 나타냅니다.

사전 요구 사항

REST Plug-in을 사용하여 보낸 경고가 환경에서 사용 및 처리되는 방법과 위치를 알고 있으며 적절한 연결 정보를 사용할 수 있는지 확인합니다.

프로시저

  1. 메뉴에서 관리를 클릭한 후 왼쪽 창에서 관리를 클릭합니다.
  2. 아웃바운드 설정을 클릭하고 추가를 클릭합니다.
  3. 플러그인 유형 드롭다운 메뉴에서 REST 알림 플러그인을 선택합니다.
    REST 설정을 포함하여 대화상자가 확장됩니다.
  4. 인스턴스 이름을 입력합니다.
    이 인스턴스를 식별하고 나중에 알림 규칙을 구성할 때 선택하는 이름입니다.
  5. 환경에 맞게 REST 옵션을 구성합니다.
    옵션 설명
    URL

    경고를 보낼 URL입니다. URL은 HTTPS를 지원해야 합니다. 경고가 REST 웹 서버로 전송되면 이 플러그인이 /{alertID}를 POST 또는 PUT 호출에 추가합니다.

    사용자 이름

    대상 REST 시스템의 사용자 계정입니다.

    비밀번호

    사용자 계정 비밀번호입니다.

    콘텐츠 유형

    경고 출력에 대한 형식을 지정합니다.

    • Application/json. 경고 데이터가 JSON(JavaScript Object Notation)을 사용하여 사람이 읽을 수 있는 텍스트로 전송됩니다.
    • Application/xml. 경고 데이터가 사람뿐 아니라 시스템에서도 읽을 수 있는 콘텐츠인 XML을 사용하여 전송됩니다.
    인증서 지문

    HTTPS 서비스의 공용 인증서 지문입니다. SHA1 또는 SHA256 알고리즘을 사용할 수 있습니다.

    연결 개수

    대상 REST 서버에 보내는 동시 경고 수를 제한합니다. 이 값을 사용하여 요청으로 인한 REST 서버 작업량이 너무 많아지지 않도록 합니다.

  6. 저장을 클릭합니다.
  7. 이 플러그인에 대한 아웃바운드 경고 서비스를 시작하려면 목록에서 인스턴스를 선택하고 도구 모음에서 사용을 클릭합니다.

결과

이 아웃바운드 경고를 위한 REST Plug-in 인스턴스가 구성되어 실행됩니다.

다음에 수행할 작업

REST Plug-in을 사용하여 경고를 환경 내의 REST 사용 애플리케이션 또는 서비스에 보내는 알림 규칙을 생성합니다. 사용자 시나리오: vRealize Operations Manager REST 경고 알림 생성을 참조하십시오.