REST Plug-in을 추가하면 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. vRealize Operations Manager의 왼쪽 창에서 관리 아이콘을 클릭합니다.
  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 서비스의 공용 인증서 지문입니다.

    연결 개수

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

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

결과

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

다음에 수행할 작업

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