MID WebService 이벤트 수집기 컨텍스트 구성

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 6분
  • 외부 소스의 이벤트 메시지를 MID 서버로 밀어넣는 URL 메서드를 제공하도록 MID WebService 이벤트 수집기를 구성합니다.

    시작하기 전에

    이벤트 관리 커넥터(sn_em_connector) 플러그인이 Now Platform 인스턴스에 설치되어 있는지 확인합니다.

    필요한 역할: evt_mgmt_admin

    이 태스크 정보

    외부 소스에서 MID 서버로 이벤트 메시지를 푸시하기 위한 URL의 기본 형식은 http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/jsonv2입니다. 이 URL은 우수한 성능을 제공합니다.

    외부 소스에서 jsonv2 형식이 아닌 이벤트 메시지를 밀어넣으려고 할 때 URL 형식은 http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/inbound_event?Transform={Name_of_Transform_Script}입니다. 여기서 {Name_of_Transform_Script} 변수는 스크립트의 전체 이름이고 항상 TransformEvents_ 텍스트로 시작합니다.

    예를 들어, 다음과 같은 값을 가정합니다.
    • {MID_Server_IP}: 10.118.69.27
    • {MID_Web_Server_Port}: 8097
    • 변환 스크립트 이름: EventsToProcess
    따라서 사용할 URL은 http://10.118.69.27:8097/api/mid/em/inbound_event/TransformEvents_EventsToProcess 입니다.
    주:
    • http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/{transform_script_name} 형식의 URL도 지원됩니다.
    • 이벤트의 날짜 형식은 yyyy-M-d h:mm:ss입니다.

      날짜가 다른 형식으로 되어 있는 이벤트를 수신하는 경우에는 수신 이벤트의 날짜 형식에 적합한 {transform_script_name}을 사용해야 합니다. 그렇지 않으면 이벤트가 제대로 처리되지 않습니다.

      예를 들어, 2019년 6월 27일 오전 11시 25분에 2019/06/27/ 11:25:00 a 날짜 형식으로 이벤트가 도착한 경우, 수신된 이벤트의 형식과 일치하도록 yyyy/MM/dd/ HH:mm:ss a 날짜 형식의 {transform_script_name}을 사용하십시오.

    프로시저

    1. 다음으로 이동 모두 > 이벤트 관리 > 통합 > MID 웹 서비스 이벤트 수신기.
    2. MID WebService 이벤트 수집기 컨텍스트 목록에서 새로 생성을 클릭합니다.
    3. 양식의 필드에 내용을 입력합니다.
      표 1. MID WebService 이벤트 수집기 컨텍스트 양식
      필드 설명
      이름 이 수집기를 쉽게 식별하기 위한 고유한 이름입니다.
      간단한 설명 이 수집기에 대한 간략하고 의미 있는 설명을 입력합니다.
      MID 웹 서버 확장 지정한 후 MID 웹 서버 확장을 시작합니다. 지원되는 인증 방법이 MID 웹 서버 확장의 인증 유형 필드에 나열됩니다. MID 웹 서버 확장을 구성하는 방법에 대한 자세한 내용은 MID 웹 서버 구성을 참조하십시오.
      상태 이 필드는 자동으로 MID 웹 서버 확장의 상태로 채워집니다. MID 웹 서버 확장이 시작될 때까지 이 필드는 비어있게 됩니다. MID 웹 서버 확장에 명령을 실행한 후 다음 값 중 하나가 표시됩니다.
      • 시작됨: 수집기가 실행 중입니다.
      • 중지됨: 수집기가 실행되고 있지 않습니다.
      • 오프라인: MID 서버가 다운되었습니다.
      • 오류: 오류로 인해 수집기가 실패했습니다(오류 메시지는 오류 메시지에 표시됨).
      • 경고: 런타임 예외가 발생했습니다.
      다음에서 실행 지정된 MID 웹 서버 확장에 정의된 특정 MID 서버 또는 특정 MID 서버 클러스터입니다.
      MID 서버 지정된 MID 웹 서버 확장에 정의된 특정 MID 서버 또는 특정 MID 서버 클러스터입니다.
      다음에서 실행 중 MID 웹 서버 확장이 실행되고 있는 MID 서버의 이름입니다.
    4. 양식 제목을 마우스 오른쪽 버튼으로 클릭하고 저장을 클릭합니다.
    5. 관련 링크에서 시작을 클릭하여 수집기를 시작합니다.
      표 2. 이벤트 관리 컨텍스트의 명령 양식
      관련 링크 설명
      시작 수집기가 실행 중이 아닐 경우 시작합니다. 이 작업은 이벤트 관리 애플리케이션을 통해 웹 서비스 API 엔드포인트가 MID 서버에서 실행 중인지 확인합니다.
      중지 구성된 MID 서버에서 실행 중인 수집기를 중지합니다. 수집기가 실행 중이 아니라면 아무 작업도 수행되지 않습니다.
      재시작 구성된 MID 서버에서 수집기를 중지했다가 다시 시작합니다.
      매개변수 업데이트 업데이트된 매개변수를 수집기로 보냅니다. 이벤트 관리 MID 서버 컨텍스트 확장이 업데이트될 때 매개변수도 업데이트됩니다. 수집기가 실행되고 있지 않을 때 이 컨트롤을 클릭하면 업데이트가 수행되지 않습니다.

    JSON v2 형식 이벤트 메시지를 변환하기 위한 URL 사용 표시

    JSON v2 형식 이벤트 메시지가 MID 서버로 전송된다고 가정합니다. jsonv2 URL을 사용하는 경우 스크립트 포함을 사용할 필요가 없습니다.

    표 3. JSON v2 예시의 데이터
    필드
    MID_Server_IP 10.218.64.27
    MID_Web_Server_Extension_Port 8097
    이벤트 메시지 형식 jsonv2

    기본 URL 형식(http://<my-instance>.service-now.com/api/global/em/jsonv2)으로 된 변수를 앞의 테이블 값(http://10.218.64.27:8097/api/global/em/jsonv2)으로 바꿉니다.

    jsonv2 형식이 아닌 메시지를 밀어넣는 URL 예시

    외부 소스에서 jsonv2 형식이 아닌 이벤트 메시지를 밀어넣으려고 할 때 URL 형식은 http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/inbound_event/Transform={Name_of_Transform_Script}입니다. 여기서 {Name_of_Transform_Script} 변수는 스크립트의 전체 이름이고 항상 TransformEvents_ 텍스트로 시작합니다. 이 스크립트 이름은 변환 헤더 매개변수로 지정되어야 하며, 항상 TransformEvents_ 프리픽스로 시작해야 합니다.

    이 예시에서는 스크립트 이름을 EventsToProcess로 가정하므로 URL은 http://10.138.64.27:8097/api/mid/em/inbound_event/TransformEvents_EventsToProcess입니다.

    JSON v2 형식 이벤트 메시지를 보여주는 예시
    주:
    아래에서 텍스트를 복사하여 붙여넣으면 숨겨진 문자도 복사될 수 있으며 예기치 않은 결과가 나타날 수 있습니다.
    
    curl -v -H "Accept: application/json" -H "Content-Type: application/json" -X POST --data "{
        "records":
        [ {
             \"source\" : \"Simulated\",
            \"node\" : \"nameofnode\",
            \"type\" : \"High Virtual Memory\",
            \"resource\" : \"C:\",
            \"severity\" : \"5\",
            \"description\" : \"Virtual memory usage exceeds 98%\",
            \"ci_type\":\"cmdb_ci_app_server_tomcat\",
            \"additional_info\":\"{\\\"name\\\":\\\"My Airlines\\\"}\"
          },
          {
          \"source\" : \"Simulated\",
          \"node\" : \"01.myairlines.com\",
          \"type\" : \"High CPU Utilization\",
          \"resource\" : \"D:\",
          \"severity\" : \"5\",
          \"description\" : \"CPU on 01.my.com at 60%\"
          }
       ]
    }" -u UserName:Password http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/jsonv2