Amazon S3 데이터 입력 구성 필드

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기5분

    • Amazon S3 데이터 입력 구성 양식의 필드에 대한 설명입니다.

    기본 구성

    필드 설명
    이름 새 데이터 입력의 이름입니다. 이 필드는 필수입니다.
    설명 데이터 입력에 대한 설명입니다.
    다음에서 실행 특정 MID 서버 또는 MID 서버 클러스터를 사용할지 여부를 결정하는 옵션입니다.

    이 기능은 ServiceNow Store에서 제공되는 상태 로그 분석 애플리케이션(버전 26.0.17 - 2023년 2월 이후)에서 지원됩니다.
    MID

    (다음에서 실행 필드가 특정 MID 서버로 설정된 경우에만)

    Amazon S3의 로그 데이터를 가져오는 MID 서버입니다.
    주:
    • 기본 인증을 지원하는 MID 서버만 선택할 수 있습니다. mTLS를 지원하는 MID 서버는 목록에 표시되지 않습니다.
    • 단일 MID 서버에 로그를 스트리밍하는 최대 데이터 입력 수의 기본값은 10입니다. MID 서버 속성에서 이 수를 수정할 수 있습니다.
    • 선택한 MID 서버에 대해 로그 수집이 활성화되지 않은 경우 상태 로그 분석가 로그 수집을 자동으로 활성화합니다.
    이 필드는 필수입니다.
    MID 서버 클러스터

    ( 실행 위치 필드가 MID 서버 클러스터)

    로그 데이터를 끌어오는 대상인 MID 서버 클러스터입니다.

    데이터 입력은 MID 서버가 실패할 때까지 클러스터의 단일 MID 서버에서 실행됩니다. 그런 다음, 시스템은 구성된 순서에 따라 모든 데이터 입력 작업을 클러스터에서 사용 가능한 다음 MID 서버로 이전합니다.

    이 기능은 ServiceNow Store에서 제공되는 상태 로그 분석 애플리케이션(버전 26.0.17 - 2023년 2월 이후)에서 지원됩니다.

    주:
    • 상태 로그 분석는 페일오버 MID 서버 클러스터만 지원합니다. 이러한 클러스터에서는 페일오버 보호를 위해 여러 개의 MID 서버가 함께 그룹화됩니다. 데이터 입력 양식에서 클러스터를 선택할 때 MID 서버 클러스터 목록에는 페일오버 클러스터만 표시됩니다.
    • MID 서버 클러스터에는 기본 인증을 지원하는 MID 서버만 포함되어야 합니다. mTLS는 로그 수집에 지원되지 않습니다.
    • 클러스터의 MID 서버별로 로그 수집을 활성화해야 합니다. 활성 MID 서버에 대해 로그 수집이 활성화되지 않은 경우 상태 로그 분석가 로그 수집을 자동으로 활성화합니다.
    • 단일 MID 서버에 로그를 스트리밍하는 최대 데이터 입력 수의 기본값은 10입니다. 클러스터에 데이터 입력이 10개 미만인 MID 서버가 하나 이상 있는 경우 MID 서버가 다운된 경우에도 클러스터는 용량 확인을 통과합니다.
    MID 서버 클러스터에 대한 자세한 내용은 MID 서버 클러스터 구성을 참조하십시오.

    이 필드는 필수입니다.
    서비스 인스턴스 로그 데이터를 바인딩할 서비스 인스턴스입니다.
    주:
    관련 서비스 인스턴스가 없는 경우 생성 서비스 인스턴스 을 클릭하고 CI를 추가합니다. 새 서비스 인스턴스의 상태를 운영으로 설정하십시오.
    이 필드는 필수입니다.

    다음 필드에는 읽기 전용 정보가 표시됩니다.

    필드 설명
    상태 데이터 입력의 상태입니다.
    전송 로그 데이터를 스트리밍하는 데 사용하는 프로토콜입니다.

    이 데이터 입력이 Amazon S3를 사용하여 로그 데이터를 인스턴스로 스트리밍합니다.
    소스 수 이 데이터 입력이 생성한 로그 소스의 수입니다.
    사용 중지 시간 데이터 입력이 중지되거나 실패한 시간입니다.
    마지막 로그 시간 데이터 입력에서 로그가 마지막으로 스트리밍된 시간입니다.
    오류 메시지 스트리밍 오류입니다.

    이 필드는 자동으로 채워집니다. 스트리밍 오류가 발생한 경우에만 표시됩니다.
    표 1. 쿼리 설정 탭
    필드 설명 예
    시작/끝 데이터를 읽을 시작 및 종료 날짜와 시간입니다.
    • 시작: 이 날짜 및 시간보다 오래된 데이터는 읽지 않습니다.
      주:
      이 값을 과거 날짜로 설정하면 읽어야 할 데이터 양이 많아 정체가 발생할 수 있습니다.
    • 끝: 이 날짜 및 시간 이후의 데이터는 읽지 않습니다. 실시간 데이터를 얻으려면 이 날짜를 먼 미래로 설정하십시오.
    이 필드는 필수입니다.
    		 시작: 현재 - 1주

    끝: 2300-01-01 15:59:59
    버킷 이름 스트리밍할 Amazon S3 버킷입니다.

    이 필드는 필수입니다.

    		 my-s3-bucket
    프리픽스 가져올 객체의 프리픽스입니다. 데이터 입력은 이 프리픽스로 시작하는 객체만 가져옵니다. 이 필드는 일반적으로 버킷에 있는 특정 폴더만 가져오기 위해 사용됩니다. /only/this/folder/
    Include 시스템에서 패턴 일치를 수행할 때 포함할 파일 또는 객체입니다. .*include-me.*
    제외 시스템에서 패턴 일치를 수행할 때 제외할 파일 또는 객체입니다. .*skip-me.*
    표 2. 전송 탭
    필드 설명
    AWS 자격 증명 AWS 자격 증명 목록(aws_credentials.list)을 참조하는 필드입니다. 목록에는 AWS 액세스 및 비밀 접근 키가 포함되어 있습니다.
    AWS 영역 Amazon S3 버킷이 있는 AWS 지역입니다(예: us-west-1).

    AWS 지역 목록은 https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html#concepts-regions 문서를 참조하십시오.

    이 필드는 필수입니다.

    고급 구성

    표 3. 고급 구성 양식
    필드 설명 기본값
    익명 기본 자격 증명이 있는 경우 이를 무시하면서 자격 증명 없이 Amazon S3 버킷에 강제로 액세스하는 옵션입니다. False
    통과 버킷의 각 디렉터리에 액세스하는 옵션입니다. False
    마지막 수정 시간을 기준으로 정렬된 객체 버킷의 객체가 시간별로 정렬된 경우 객체를 가져오는 옵션입니다. False
    연결 시간 제한 AWS 연결을 구축하려는 시도의 시간이 초과되기까지 대기할 시간(밀리초)입니다. 100
    Threadpool 크기 버킷에서 파일을 다운로드하는 동시 허용 스레드 수입니다. 1
    버퍼 크기 다운로드 버퍼의 크기(바이트)입니다. 100MB
    소켓 시간 제한 설정한 연결을 통한 데이터 전송 시간이 초과되기까지 대기할 시간(밀리초)입니다. 10000
    파일에 대한 최대 재시도 실패할 경우 파일 처리를 재시도하는 최대 횟수입니다. 10
    기본 시간대 로그에 특정 시간대 정보가 없는 경우의 기본 시간대입니다. UTC
    하위 샘플 삭제 비율 함께 배치하는 이벤트의 개수로, 그 중 하나를 삭제하게 됩니다. 이 설정은 가져온 이벤트 수를 줄이는 데 사용됩니다. -1
    하위 샘플 수신 비율 함께 배치하는 이벤트의 개수로, 그 중 하나만 제외하고 모두 삭제하게 됩니다. 이 설정은 수신 이벤트 수를 줄이는 데 사용됩니다. -1
    속도 제한 이 데이터 입력이 처리하는 초당 최대 이벤트 수입니다. -1
    최대 길이(byte) 이벤트의 최대 길이(바이트)입니다. 32766
    문자 인코딩 이 데이터 입력에 대한 문자 인코딩입니다. UTF-8
    절전 모드 간격 쿼리에서 이벤트가 반환되지 않은 경우 다시 쿼리하기까지 대기하는 시간 간격(초)입니다. 60
    폴링 간격 새 이벤트를 폴링하기까지 대기하는 시간 간격(초)입니다. 0
    큐가 가득 찬 경우 삭제 MID 서버에 부하가 있는 경우 로그를 삭제하도록 선택하는 옵션입니다. False