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

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 8분
  • 외부 소스 MID 서버의 이벤트 메시지를 .

    시작하기 전에

    이벤트 관리 커넥터(sn_em_connector) 플러그인이 ServiceNow AI 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 웹 서비스 이벤트 수집기 컨텍스트 양식
      필드 설명
      이름 이 수집기를 쉽게 식별하기 위한 고유한 이름입니다.
      간단한 설명 이 수집기에 대한 간략하고 의미 있는 설명을 입력합니다.
      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
    

    MID 웹 서버 API 키를 사용하여 JSON v2 형식 이벤트 메시지를 보여주는 예
    주:
    아래에서 텍스트를 복사하여 붙여넣으면 숨겨진 문자도 복사될 수 있으며 예기치 않은 결과가 나타날 수 있습니다.
    
    curl --location -g --request POST 'http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/jsonv2' \
    --header 'Accept: application/json' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: key <mid_webserver_api_key>' \
    --data-raw '{
       "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%\"
          }
       ]
    }'