본문으로 건너뛰기

REST 웹 서비스에 이벤트 전달하기

Lenovo XClarity Orchestrator을 구성하여 REST 웹 서비스로 특정 이벤트를 전달할 수 있습니다.

시작하기 전에

주의
이 서비스에 데이터를 전달할 때 보안 연결이 설정되지 않았습니다. 데이터가 일반 텍스트 프로토콜을 통해 전송됩니다.

이 작업 정보

리소스별 액세스 제어를 사용하도록 설정한 경우, 액세스 제어 목록을 사용하여 액세스할 수 있는 리소스에 대한 데이터만 전달합니다. 미리 정의된 감독자 역할이 할당된 그룹의 구성원이 아닌 경우 생성한 전달자에 하나 이상의 액세스 제어 목록을 할당해야 합니다. 액세스할 수 있는 모든 리소스에 대한 데이터를 보내려면 사용 가능한 연결된 액세스 제어 목록을 모두 선택합니다. 감독자 역할이 할당된 그룹의 구성원인 경우 모든 리소스에 대한 데이터를 보내도록 선택하거나 액세스 제어 목록을 할당하여 리소스를 제한할 수 있습니다.

공통 데이터 전달 필터는 이벤트 코드, 이벤트 클래스, 이벤트 심각도, 서비스 유형 및 이벤트를 생성한 리소스를 기반으로, 전달하고자 하는 이벤트의 범위를 정의하는 데 사용됩니다. 이 이벤트 전달자에 사용할 이벤트 및 리소스 필터가 이미 만들어져 있는지 확인하십시오(데이터 전달 필터 만들기 참조).

다음 예에서는 REST 웹 서비스에 전달되는 데이터의 기본 형식을 보여줍니다. 이중 대괄호 사이의 단어는 데이터가 전달될 때 실제 값으로 교체되는 특성입니다.
{\"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 웹 서비스에 데이터를 전달하려면 다음 단계를 완료하십시오.

  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. 만들기를 클릭하여 전달자를 만듭니다.

완료한 후에

데이터 전달자 카드에서 다음 작업을 수행할 수 있습니다.

  • 상태 열에서 토글을 선택하여 선택한 전달자를 사용 또는 사용 안 함으로 설정합니다
  • 편집 아이콘(편집 아이콘)을 클릭하여 선택한 전달자를 수정합니다.
  • 삭제 아이콘(삭제 아이콘)을 클릭하여 선택한 전달자를 제거합니다.