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

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 3분

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

    시작하기 전에

    • 애플리케이션이 인스턴스에 설치되고 프로비저닝되었는지 상태 로그 분석 확인합니다. 자세한 내용은 설치 상태 로그 분석 (HLA) 문서를 참조하십시오.
    • 서비스 인스턴스를 사용할 수 있는지 확인합니다.
    • AI 엔진이 실행 중인지 상태 로그 분석 확인합니다.
    • 로그 수집 기능이 활성화된 상태로 MID 서버 설치 및 구성되어 있는지 확인합니다. 자세한 내용은 MID Server system requirements 문서를 참조하십시오.

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

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

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

    • MID 서버 IP 주소가 NAT(Network Address Translation), 부하 분산 장치 또는 유사한 디바이스를 MID 서버 통해 노출되는 경우 네트워크 외부에 있는 에이전트와 같은 Filebeat 외부 클라이언트가 연결할 수 있는 공용 IP 주소가 있어야 합니다. 개인 IP 주소는 인터넷을 통해 라우팅할 수 없으므로 공용 IP가 없으면 이러한 외부 클라이언트는 해당 주소로 구성된 경우에도 연결할 MID 서버 수 없습니다. MID 서버 속성에서 공용 IP 주소가 있는 mid.public_ip 속성을 값으로 추가합니다. 자세한 내용은 MID 서버 속성 만들기를 참조하십시오.
      주:
      MID 서버 및 외부 클라이언트가 동일한 네트워크에 있는 경우 공용 IP가 필요하지 않으며 개인 IP 주소를 사용하여 연결을 설정할 수 있습니다.
    주:
    REST API 통합은 수신 데이터에 대해 UTF-8 인코딩만 지원합니다.

    필요한 역할: evt_mgmt_admin

    프로시저

    1. 다음으로 이동 작업 공간 > 서비스 운영 작업 공간.
    2. 왼쪽 창에서 통합 시작 패드 아이콘을 선택합니다. 통합 시작 패드 아이콘.
    3. 통합 찾아보기 탭의 검색 필드에 REST를 입력합니다.
    4. REST API 통합 타일을 선택합니다.
      주:
      모든 필수 조건을 충족하기 전에 통합 설정을 시작하면 메시지가 나타납니다. 설정을 취소하고 이전 요구 사항을 먼저 완료하거나, 초안 모드에서 계속 진행하여 나중에 완료할 수 있습니다. 모든 필수 조건이 충족될 때까지 통합을 활성화할 수 없습니다.
    5. 상세 정보 제공 양식의 필드에 내용을 입력합니다.
      필드에 대한 설명은 REST API 통합 구성 필드 문서를 참조하십시오.
    6. 다음을 선택합니다.
    7. 설정 지침 화면에서 제공된 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) 를 상세 정보 제공 양식에서 구성한 값으로 대체했습니다.

    8. 초안 저장을 선택합니다.
    9. 활성화를 선택하여 통합을 활성화합니다.
      주:
      모든 통합 필요 조건을 이행한 경우에만 구성된 통합을 활성화할 수 있습니다.
    10. 옵션: 초안 모드에서 통합을 설치한 경우 나중에 다음 단계를 수행하여 활성화합니다.
      1. 통합 필수 조건을 완료합니다.
      2. 통합 Launchpad 설치된 통합 탭의 작업 대기 아래에서 통합을 찾아 선택합니다.
      3. 설정 지침 화면에서 활성화를 선택하여 통합을 활성화합니다.

    결과

    통합이 활성화되고 개요 화면이 표시됩니다. 통합에 대한 타일은 의 설치된 통합 탭에서 사용할 수 있습니다 통합 Launchpad.

    다음에 수행할 작업

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

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