---
sourceDocument: 호주 IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/it-operations-management

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

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

# MID WebService 이벤트 수집기 컨텍스트 구성 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 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}`, <var class="keyword varname">여기서 {Name_of_Transform_Script}</var> 변수는 스크립트의 전체 이름이고 항상 텍스트로 시작합니다 <kbd class="ph userinput">: TransformEvents_</kbd>.{#configure-em-context-extension__p_non-json-format}  
예를 들어, 다음과 같은 값을 가정합니다.

* {MID_Server_IP}: 10.118.69.27
* {MID_Web_Server_Port}: 8097
* 변환 스크립트 이름: EventsToProcess

{#configure-em-context-extension__ul_asl_dyq_tfb}따라서 사용되는 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}`을 사용합니다.
  {#configure-em-context-extension__ph_date-format}
{#configure-em-context-extension__ul_wqh_3dw_b5b}

## 프로시저

1. 다음으로 이동 모두이벤트 관리통합MID 웹 서비스 이벤트 수신기.
2. MID WebService 이벤트 수집기 컨텍스트 목록에서 신규를 클릭합니다.
3. 양식에서 필드를 채웁니다.  
   {#configure-em-context-extension__table_od5_flc_bx__entry__2}{#configure-em-context-extension__ph_entry-name}{#configure-em-context-extension__ph_entry-short-desc}{#configure-em-context-extension__ph_entry-extension}{#configure-em-context-extension__ph_entry-status}{#configure-em-context-extension__ph_entry-execute-on}{#configure-em-context-extension__ph_entry-mid-server}{#configure-em-context-extension__ph_entry-executing-on}

   | 필드 | 설명 |
   |-|-|
   | 이름 | 이 수집기를 쉽게 식별하기 위한 고유한 이름입니다. |
   | 간단한 설명 | 이 수집기에 대한 간략하고 의미 있는 설명을 입력합니다. |
   | MID 웹 서버 확장 | 지정한 후 MID 웹 서버 확장을 시작합니다. 지원되는 인증 방법이 MID 웹 서버 확장의 인증 유형 필드에 나열됩니다. MID 웹 서버 확장을 구성하는 방법에 대한 자세한 내용은 [MID 웹 서버 구성을](https://servicenow-prod.fluidtopics.net/8m7VqPxp3k~GyRCmiM54uw "MID 웹 서버MID 서버 는 REST API를 개발하여 이벤트와 메트릭MID 서버을 전송할 수 있는 확장입니다. 이 확장은 MID WebService 이벤트 수신기 및 웹소켓 엔드포인트 확장과 같은 메트릭 인텔리전스다른 MID 서버 확장에서 활용됩니다에이전트 클라이언트 수집기.") 참조하십시오. |
   | 상태 | 이 필드에는 MID 웹 서버 확장의 상태가 자동으로 채워집니다. MID 웹 서버 확장이 시작될 때까지 이 필드는 비어있게 됩니다. MID 웹 서버 확장에 명령을 실행하면 다음 값 중 하나가 표시됩니다. * 시작됨: 수집기가 실행 중입니다. * 중지됨: 수집기가 실행되고 있지 않습니다. * 오프라인: 다운 MID 서버 되었습니다. * 오류: 수집기가 오류로 인해 실패했습니다(오류 메시지는 오류 메시지에 표시됨). * 경고: 런타임 예외가 발생했습니다. {#configure-em-context-extension__ul_entry-status} |
   | 다음에서 실행 | 특정 MID 웹 서버 확장에 정의된 특정 MID 서버 또는 특정 MID 서버 클러스터입니다. |
   | MID 서버 | 지정된 MID 웹 서버 확장에 정의된 특정 MID 서버 또는 특정 MID 서버 클러스터입니다. |
   | 다음에서 실행 중 | MID 웹 서버 확장이 실행되고 있는 이름 MID 서버 입니다. |
   [표 1. MID 웹 서비스 이벤트 수집기 컨텍스트 양식]

   {#configure-em-context-extension__table_od5_flc_bx}
4. 양식 제목을 마우스 오른쪽 버튼으로 클릭하고 저장을 클릭합니다. {#configure-em-context-extension__step_save}
{#configure-em-context-extension__step_save}
5. 관련 링크에서시작을 클릭하여 수집기를 시작합니다.  
   {#configure-em-context-extension__table_dhd_tjc_bx__entry__2}

   | 관련 링크 | 설명 |
   |-|-|
   | 시작 | 수집기가 실행 중이 아닐 경우 시작합니다. 이 작업은 애플리케이션이 있는 이벤트 관리 웹 서비스 API 엔드포인트가 에서 실행 중인지 확인합니다.MID 서버 |
   | 중지 | 구성된 MID 서버. 수집기가 실행 중이 아니라면 아무 작업도 수행되지 않습니다. |
   | 재시작 | 구성된 MID 서버. |
   | 매개변수 업데이트 | 업데이트된 매개변수를 수집기로 보냅니다. 컨텍스트 확장이 업데이트되면 이벤트 관리 MID 서버 매개변수도 업데이트됩니다. 수집기가 실행되고 있지 않을 때 이 컨트롤을 클릭하면 업데이트가 수행되지 않습니다. |
   [표 2. 컨텍스트 양식의 이벤트 관리 명령]

   {#configure-em-context-extension__table_dhd_tjc_bx} {#configure-em-context-extension__cmd_start}
{#configure-em-context-extension__steps_nd5_flc_bx}

## 예

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

JSON v2 형식의 이벤트 메시지가 .MID 서버 `jsonv2` URL을 사용하는 경우 스크립트 포함을 사용할 필요가 없습니다.
{#configure-em-context-extension__table_qzh_fyt_cy__entry__2}

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

{#configure-em-context-extension__table_qzh_fyt_cy}

기본 형식의 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_. 스크립트 이름은 <kbd class="ph userinput">변환</kbd> 헤더 매개변수로 지정해야 하며 항상 프리픽스 <kbd class="ph userinput">TransformEvents_</kbd>로 시작해야 합니다.

이 예시에서는 스크립트 이름이 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%\"
          }
       ]
    }'

**관련 태스크**   

* [확장 구성 MID 웹 서버](https://servicenow-prod.fluidtopics.net/8m7VqPxp3k~GyRCmiM54uw "MID 웹 서버MID 서버 는 REST API를 개발하여 이벤트와 메트릭MID 서버을 전송할 수 있는 확장입니다. 이 확장은 MID WebService 이벤트 수신기 및 웹소켓 엔드포인트 확장과 같은 메트릭 인텔리전스다른 MID 서버 확장에서 활용됩니다에이전트 클라이언트 수집기.")
* [BMC TrueSight에서 이벤트 수집](https://servicenow-prod.fluidtopics.net/qP7USqlo6xiJm_3RuoaYQQ "MID WebService 이벤트 수집기를 사용하면 이벤트 스트림 알림 기능을 활용하여 이전에 BMC ProactiveNet Performance Management(BPPM)로 알려졌던 BMC TrueSight Operations Management(TrueSight)에서 보낸 JSON 형식의 이벤트 메시지를 수집할 수 있습니다.")
* [Microsoft Azure Monitor에서 이벤트 수집](https://servicenow-prod.fluidtopics.net/N5d_N6r1ha1SD_nIJJIOoQ "MID WebServer 이벤트 수집기를 사용하면 포털에서 보낸 JSON 형식의 이벤트 메시지를 수집할 Microsoft Azure 수 있습니다.")
* [Google 클라우드 플랫폼에서 이벤트 수집](https://servicenow-prod.fluidtopics.net/rK0YTUhboeQPW~POBq1zjg "MID WebService 이벤트 수집기를 사용하면 에서 보낸 JSON 형식의 이벤트 메시지를 수집할 수 있습니다 GCP(Google Cloud Platform).")