액세스 로그

Classic/VPC 환경에서 이용 가능합니다.

버킷 액세스 로그 기능을 사용하면 버킷과 객체에 대한 요청 정보를 로그 파일로 저장하여 접근 이력을 확인하고 분석할 수 있습니다. 로그는 사용자가 지정한 버킷에 저장되며, 저장된 로그 파일을 통해 요청 시각, 요청 유형, 처리 결과 등의 정보를 확인할 수 있습니다.

버킷 액세스 로그 설정

액세스 로그는 지정한 저장 버킷에 저장되며 저장된 로그 파일의 용량에 따라 스토리지 이용 요금이 발생합니다. 버킷 액세스 로그 설정 방법은 다음과 같습니다.

1. 버킷 목록에서 버킷을 선택한 후 버킷 액세스 로그 설정 영역의 를 클릭해 주십시오.
2. 버킷 액세스 로그 설정 팝업 창에서 액세스 로그 설정을 활성화해 주십시오.
3. 액세스 로그 파일을 저장할 저장 버킷을 선택해 주십시오.
   • 저장 버킷 조건은 로그 저장 버킷 설정 조건 참조
4. 로그 파일을 구분하여 저장할 경로의 접두사인 로그 파일 Prefix를 입력해 주십시오.
   • <예시> logs/
5. 작성된 내용을 확인한 후 [확인] 버튼을 클릭해 주십시오.

로그 저장 버킷 설정 조건

로그 저장 버킷은 다음 조건을 충족해야 합니다.

여러 소스 버킷에서 하나의 로그 저장 버킷을 공통으로 사용할 수 있습니다.

로그 파일 저장 방식

액세스 로그는 요청 정보를 수집하여 로그 저장 버킷에 텍스트 파일로 전달합니다. 로그 파일은 UTF-8 형식으로 저장되며 압축되지 않습니다. 하나의 요청 정보는 한 줄로 기록됩니다.

로그 파일 이름 및 저장 경로

로그 파일의 객체 키는 설정한 Prefix와 키 형식에 따라 결정됩니다. 지원하는 키 형식은 다음과 같습니다.

SimplePrefix

{Prefix}YYYY-MM-DD-HH-mm-ss-{UniqueString}

PartitionedPrefix - EventTime

{Prefix}{AccountId}/{Region}/{Bucket}/YYYY/MM/DD/YYYY-MM-DD-00-00-00-{UniqueString}

PartitionedPrefix - DeliveryTime

{Prefix}{AccountId}/{Region}/{Bucket}/YYYY/MM/DD/YYYY-MM-DD-HH-mm-ss-{UniqueString}

각 항목의 의미는 다음과 같습니다.

로그의 요청 시각과 날짜별 저장 경로는 모두 한국 표준시(KST, UTC+9)를 기준으로 기록됩니다.

로그 파일 전달

액세스 로그는 실시간으로 저장되지 않으며, 요청 발생 후 일정 시간이 지나면 로그 저장 버킷에 전달됩니다.

• 로그 파일 전달에는 일반적으로 약 30분이 소요됩니다.
• 시스템 상태에 따라 로그 전달 시간이 달라질 수 있습니다.
• 로그 설정을 활성화하거나 변경 또는 해제한 경우 실제 반영까지 시간이 걸릴 수 있습니다.
• 로그 파일의 전달 순서는 요청 발생 순서와 일치하지 않을 수 있습니다.

로그가 기록되는 요청 범위

버킷 액세스 로그는 해당 버킷이 속한 리전으로 들어온 API 요청과 정적 웹사이트 호스팅 요청을 기록합니다. 요청 유형별 기록 여부는 다음과 같습니다.

다음과 같은 요청도 로그에 기록되지 않을 수 있습니다.

• 버킷을 특정할 수 없는 요청
• 인증 단계에서 거부되어 버킷을 식별할 수 없는 요청
• 로그 전달 과정에서 내부적으로 수행되는 GetBucketLogging 요청

DeleteObjects를 호출하면 다중 삭제 요청 자체는 REST.POST.MULTI_OBJECT_DELETE로 기록되지만, 삭제 대상 객체별 BATCH.DELETE.OBJECT 기록은 제공되지 않습니다.

로그 레코드 형식

로그 파일은 27개 필드로 구성됩니다. 하나의 요청 정보가 한 줄로 기록됩니다. 각 필드는 공백으로 구분되나, 일부 필드 값에는 공백이 포함될 수 있습니다. Time 필드는 []로, Request-URI, Referer, User-Agent 필드는 ""로 묶여 기록됩니다. 로그를 분석할 때는 [] 또는 ""로 묶인 값을 하나의 필드로 처리해야 합니다. 단순히 공백을 기준으로 분리하면 필드 수가 27개와 일치하지 않을 수 있습니다.

로그 필드

로그 레코드를 구성하는 필드는 다음과 같습니다.

요청 유형별 Operation

로그 레코드의 Operation 필드에는 수행한 요청에 해당하는 작업 유형이 기록됩니다.

주요 API별 Operation은 다음과 같습니다.

객체 복사 요청은 대상 객체의 쓰기 작업과 원본 객체의 읽기 작업이 각각 기록됩니다. 원본 객체의 읽기 작업은 REST.COPY.OBJECT_GET으로 구분됩니다.

로그 전달 실패 및 주의 사항

버킷 액세스 로그 설정이 활성화되어 있더라도 로그 저장 버킷의 상태에 따라 로그 파일이 정상적으로 전달되지 않을 수 있습니다.

로그 전달에 실패하더라도 소스 버킷의 액세스 로그 설정은 자동으로 해제되지 않으며, 별도의 실패 알림도 제공되지 않습니다. 단, 소스 버킷 자체를 삭제하면 로그 설정도 함께 삭제됩니다.