REST API 데이터 입력 구성

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 소요 시간: 2분
  • 로그 데이터를 JSON 형식으로 ServiceNow 인스턴스에 스트리밍할 수 있도록 REST API 데이터 입력을 구성합니다.

    시작하기 전에

    • 로그 MID 서버 수집 기능이 활성화된 설치 및 구성되어 있는지 확인합니다. 자세한 내용은 MID Server system requirements 문서를 참조하십시오.

      로그 수집 기능이 활성화된 MID 서버 구성입니다.

      중요사항:
      상태 로그 분석는 IPv6를 지원하지 않습니다. 애플리케이션을 사용하려면 MID 서버를 IPv4로 구성합니다.

      MID 웹 서버 컨텍스트 양식의 다음에서 실행 필드에서 특정 MID 서버를 선택하고 클러스터 옵션은 선택하지 않습니다. MID 서버 필드에서 끌어온 로그 데이터의 행선지인 특정 MID 서버를 선택합니다.

    • 외부 클라이언트와 외부 클라이언트가 동일한 네트워크에 MID 서버 있지 않는 한 MID 서버 공용 IP 주소가 있어야 합니다. 이는 IP가 NAT(네트워크 주소 변환), 부하 분산 장치 또는 이와 유사한 장치를 통해 노출되는 경우에 필요합니다. 공용 IP 주소를 사용하면 네트워크 외부에 있는 에이전트와 같은 Filebeat 외부 클라이언트가 에 연결할 수 있습니다 MID 서버. 개인 IP 주소는 인터넷을 통해 라우팅할 수 없습니다. 공용 IP가 없으면 외부 클라이언트가 해당 주소로 구성되어 있더라도 연결할 MID 서버 수 없습니다. MID 서버 속성에서 공용 IP 주소가 있는 mid.public_ip 속성을 값으로 추가합니다. 자세한 내용은 MID 서버 속성 만들기를 참조하십시오. MID 서버 외부 클라이언트와 외부 클라이언트가 동일한 네트워크에 있으면 개인 IP 주소를 사용하여 연결할 수 있습니다.

    필요한 역할: evt_mgmt_admin

    이 태스크 정보

    이 확장은 외부 로그 소스에서 MID 서버로 보낸 로그 메시지를 처리합니다. MID 서버가 메시지를 처리한 다음 인스턴스에 전달합니다.

    MID 서버에 로그 메시지를 스트리밍하려면 URL이 http://{MID_SERVER_IP}:{MID_WEB_SERVER_PORT}/api/mid/hla/raw 형식으로 되어 있어야 하며, 이때 엔드포인트는 /api/mid/hla/raw입니다.

    프로시저

    1. 다음으로 이동 모두 > 상태 로그 분석 > 데이터 입력 > 데이터 입력.
    2. 데이터 입력 페이지에서 새로 만들기를 선택합니다.
    3. REST API 데이터 입력을 선택합니다.
    4. 양식의 필드에 내용을 입력합니다.
      필드에 대한 설명은 REST API 데이터 입력 구성 필드 문서를 참조하십시오.
      주:
      REST API 통합은 수신 데이터에 대해 UTF-8 인코딩만 지원합니다.
    5. 제출을 선택합니다.

    결과

    데이터 입력 구성 프로세스가 완료되었습니다. 상태 로그 분석에서 데이터 입력 테이블에 데이터 입력 기록을 추가하고 데이터 입력 기록에 구성 파일을 첨부합니다. 데이터 입력이 JSON 형식으로 로그 데이터를 ServiceNow 인스턴스로 스트리밍하기 시작합니다.

    다음에 수행할 작업

    데이터 입력이 스트리밍 데이터인지 확인하십시오.