상태 로그 분석에 대한 REST API 통합 설정

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 4분

    • 에서 처리할 상태 로그 분석수 있도록 로그 데이터를 인스턴스에 스트리밍하기 ServiceNow 위한 통합을 설정합니다.

    시작하기 전에

    • 애플리케이션이 인스턴스에 설치되고 프로비저닝되었는지 상태 로그 분석 확인합니다. 자세한 내용은 설치 상태 로그 분석 (HLA) 문서를 참조하십시오.
    • 서비스 인스턴스를 사용할 수 있는지 확인합니다.
    • AI 엔진이 실행 중인지 상태 로그 분석 확인합니다.
    • 로그 수집 기능이 활성화된 상태로 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 주소를 사용하여 연결할 수 있습니다.
    주:
    REST API 통합은 수신 데이터에 대해 UTF-8 인코딩만 지원합니다.

    필요한 역할: evt_mgmt_admin

    이 태스크 정보

    ITOM AIOps 구성 센터에서 액세스할 수 있는 의 통합 시작 패드 서비스 운영 작업 공간를 통해 통합을 설정합니다. AIOps 구성 센터는 AIOps 기능을 한 곳에서 구성하고 관리할 수 있는 중앙 집중식 작업 공간입니다. 통합 설정 프로세스는 의 클래식 인터페이스 상태 로그 분석에서 수동 데이터 입력을 설정하는 것에 비해 구현 시간을 단축합니다. 자세한 내용은 ITOM용 서비스 운영 작업 공간의 통합 Launchpad 문서를 참조하십시오.

    프로시저

    1. 다음으로 이동 작업 공간 > 서비스 운영 작업 공간.
    2. 탐색 창의 아래쪽에서 AIOps 구성 센터 아이콘 ITOM AIOps 구성 센터 아이콘을 선택합니다.
      ITOM AIOps 구성 센터 페이지가 나타납니다. 구성 센터는 중앙 집중식 작업 공간입니다. 이를 사용하여 한 곳에서 AIOps 기능을 구성하고 관리합니다.
    3. 통합 섹션의 통합에서 통합 추가를 선택합니다.
      통합 시작 패드가 나타납니다.
    4. 통합 찾아보기 탭의 검색 필드에 REST를 입력합니다.
    5. REST API 통합 타일을 선택합니다.
      주:
      모든 필수 조건을 충족하기 전에 통합 설정을 시작하면 메시지가 나타납니다. 설정을 취소하고 먼저 이전 요구 사항을 완료할 수 있습니다. 또는 초안 모드에서 계속하고 나중에 요구 사항을 완료할 수 있습니다. 모든 필수 조건을 완료할 때까지 통합을 활성화할 수 없습니다.
    6. 상세 정보 제공 양식의 필드에 내용을 입력합니다.
      필드에 대한 설명은 REST API 통합 구성 필드 문서를 참조하십시오.
    7. 다음을 선택합니다.
    8. 설정 지침 화면에서 제공된 URL을 클립보드에 복사합니다.

      URL의 형식은 http://(MID_SERVER_IP):(MID_WEB_SERVER_PORT)/ap1/mid/hla/raw이며, 여기서 /aps/mid/hla/raw 는 엔드포인트입니다. HLA 이 (가) (MID_SERVER_IP) 및 (MID_WEB_SERVER_PORT) 를 상세 정보 제공 양식에서 구성한 값으로 대체했습니다.

    9. 다음 중 하나를 수행합니다.
      • 구성을 시작하기 전에 모든 필수 구성 요소를 완료한 경우 활성화를 선택합니다.

        통합이 성공적으로 활성화되면 개요 탭이 표시됩니다. 통합 Launchpad의 설치된 통합 탭에서 통합 타일을 사용할 수 있습니다.

      • 이전 요구 사항을 모두 완료하지 않은 경우 초안 저장을 선택합니다.

        시스템은 통합을 초안으로 저장합니다.통합 Launchpad 이는 설치된 통합 탭의 작업 대기 아래에 표시됩니다. 필요 조건을 완료하고 나중에 통합을 활성화할 수 있습니다. 자세한 내용은 상태 로그 분석에서 초안 통합 활성화 문서를 참조하십시오.

    다음에 수행할 작업

    API 클라이언트에 로그 메시지를 전송하도록 지시합니다 MID 서버.
    1. API 클라이언트에서 다음 매개변수를 사용하여 요청을 구성합니다.
      • HTTP 메서드: POST.
      • URL: 설정 지침 화면에서 복사한 URL입니다.
      • 인증: 필수 인증 자격 증명입니다. 예를 들어 기본 인증(사용자 이름 및 암호)입니다.
        주:
        인증 방법은 MID 웹 서버에 구성된 방법과 동일해야 합니다.
      • 헤더: 페이로드 형식과 일치하도록 Content-Type 헤더를 설정합니다.
        • JSON의 경우: application/json.
        • 원시 텍스트의 경우: text/plain.
      • 본문: JSON 또는 원시 텍스트의 로그 페이로드입니다.
    2. 요청을 보냅니다.

      성공적인 응답은 페이로드 MID 서버 를 수신했음을 나타냅니다. 가 MID 서버 로그 메시지를 처리하면 데이터 입력이 REST 프로토콜을 사용하여 로그 메시지를 인스턴스로 ServiceNow 스트리밍합니다.