메뉴
Amazon Simple Storage Service
개발자 안내서 (API Version 2006-03-01)

서버 액세스 로그 형식

서버 액세스 로그 파일은 새 줄로 구분된 로그 레코드의 시퀀스로 구성됩니다. 각 로그 레코드는 하나의 요청을 표시하며 공백으로 구분된 필드로 구성됩니다. 다음은 6개 로그 레코드로 구성된 로그 예입니다.

Copy
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be mybucket [06/Feb/2014:00:00:38 +0000] 192.0.2.3 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be 3E57427F3EXAMPLE REST.GET.VERSIONING - "GET /mybucket?versioning HTTP/1.1" 200 - 113 - 7 - "-" "S3Console/0.4" - 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be mybucket [06/Feb/2014:00:00:38 +0000] 192.0.2.3 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be 891CE47D2EXAMPLE REST.GET.LOGGING_STATUS - "GET /mybucket?logging HTTP/1.1" 200 - 242 - 11 - "-" "S3Console/0.4" - 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be mybucket [06/Feb/2014:00:00:38 +0000] 192.0.2.3 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be A1206F460EXAMPLE REST.GET.BUCKETPOLICY - "GET /mybucket?policy HTTP/1.1" 404 NoSuchBucketPolicy 297 - 38 - "-" "S3Console/0.4" - 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be mybucket [06/Feb/2014:00:01:00 +0000] 192.0.2.3 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be 7B4A0FABBEXAMPLE REST.GET.VERSIONING - "GET /mybucket?versioning HTTP/1.1" 200 - 113 - 33 - "-" "S3Console/0.4" - 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be mybucket [06/Feb/2014:00:01:57 +0000] 192.0.2.3 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be DD6CC733AEXAMPLE REST.PUT.OBJECT s3-dg.pdf "PUT /mybucket/s3-dg.pdf HTTP/1.1" 200 - - 4406583 41754 28 "-" "S3Console/0.4" - 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be mybucket [06/Feb/2014:00:03:21 +0000] 192.0.2.3 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be BC3C074D0EXAMPLE REST.GET.VERSIONING - "GET /mybucket?versioning HTTP/1.1" 200 - 113 - 28 - "-" "S3Console/0.4" -

참고

아무 필드나 -로 설정하여 데이터를 알 수 없거나 사용할 수 없음 또는 해당 필드에 이 요청이 적용되지 않음을 표시할 수 있습니다.

다음 목록에서는 로그 레코드 필드에 대해 설명합니다.

버킷 소유자

원본 버킷의 정식 사용자 ID입니다.

입력 예

Copy
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
버킷

요청이 처리된 버킷의 이름. 시스템이 잘못된 양식의 요청을 수신하여 버킷을 결정할 수 없을 경우 해당 요청이 어떤 서버 액세스 로그에도 표시되지 않습니다.

입력 예

Copy
mybucket
시간

요청이 수신된 시간. strftime() 용어를 사용하는 형식은 [%d/%b/%Y:%H:%M:%S %z]입니다.

입력 예

Copy
[06/Feb/2014:00:00:38 +0000]
원격 IP

요청자의 명백한 인터넷 주소. 중간 프록시 및 방화벽이 요청 시스템의 실제 주소를 가릴 수 있습니다.

입력 예

Copy
192.0.2.3
요청자

요청자의 정식 사용자 ID 또는 인증되지 않은 요청의 -입니다. 요청자가 IAM 사용자일 경우 IAM 사용자가 속한 AWS 루트 계정과 함께 요청자의 IAM 사용자 이름이 이 필드에 반환됩니다. 이 식별자는 액세스 제어 목적으로 사용되는 것과 동일합니다.

입력 예

Copy
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
요청 ID

요청 ID는 Amazon S3가 각 요청을 고유하게 식별하기 위해 생성하는 문자열입니다.

입력 예

Copy
3E57427F33A59F07
작업

여기에 나열된 작업은 SOAP.operation, REST.HTTP_method.resource_type, WEBSITE.HTTP_method.resource_type 또는 BATCH.DELETE.OBJECT로 선언됩니다.

입력 예

Copy
REST.PUT.OBJECT

요청의 "키" 부분. URL로 인코딩되거나 작업에 키 파라미터가 없을 경우 "-".

입력 예

Copy
/photos/2014/08/puppy.jpg
요청-URI

HTTP 요청 메시지의 Request-URI 부분.

입력 예

Copy
"GET /mybucket/photos/2014/08/puppy.jpg?x-foo=bar HTTP/1.1"
HTTP 상태

응답의 숫자 HTTP 상태 코드.

입력 예

Copy
200
오류 코드

Amazon S3 오류 코드, 또는 오류가 없을 경우 "-".

입력 예

Copy
NoSuchBucket
보낸 바이트

HTTP 프로토콜 오버헤드를 제외한 보낸 응답 바이트 수, 영일 경우 "-".

입력 예

Copy
2662992
객체 크기

해당 객체의 총 크기.

입력 예

Copy
3462992
총 시간

서버 관점에서 요청이 플라이트 상태를 유지한 시간(밀리초). 이 값은 요청이 수신된 시간부터 응답의 마지막 바이트가 전송된 시간까지 측정됩니다. 클라이언트 관점의 측정값은 네트워크 지연 시간으로 인해 더 길 수 있습니다.

입력 예

Copy
70
반환 시간

Amazon S3가 요청을 처리하는 데 소비한 시간(밀리초). 이 값은 요청의 마지막 바이트가 수신된 시간부터 응답의 첫 바이트가 전송된 시간까지 측정됩니다.

입력 예

Copy
10
참조자

HTTP Referrer 헤더의 값(있는 경우). HTTP 사용자 에이전트(예: 브라우저)는 일반적으로 이 헤더를 요청 시 연결 또는 포함 페이지의 URL로 설정합니다.

입력 예

Copy
"http://www.amazon.com/webservices"
사용자 에이전트

HTTP User-Agent 헤더의 값.

입력 예

Copy
"curl/7.15.1"
버전 ID

요청의 버전 ID, 또는 작업에 versionId 파라미터가 없을 경우 "-".

입력 예

Copy
3HL4kqtJvjVBH40Nrjfkd

사용자 지정 액세 로그 정보

요청 URL에 사용자 지정 쿼리 문자열 파라미터를 추가하여 요청에 대한 액세스 로그 레코드에 저장할 사용자 지정 정보를 포함시킬 수 있습니다. Amazon S3는 "x-"로 시작하는 쿼리 문자열 파라미터를 무시하지만, 이들 파라미터를 요청에 대한 액세스 로그 레코드에 로그 레코드 Request-URI 필드의 일부로 포함시킵니다. 예를 들어 "s3.amazonaws.com/mybucket/photos/2014/08/puppy.jpg?x-user=johndoe"에 대한 GET 요청은 "s3.amazonaws.com/mybucket/photos/2014/08/puppy.jpg"에 대한 동일한 요청과 동일하게 작용하지만, 연결된 로그 레코드의 Request-URI 필드에 "x-user=johndoe" 문자열이 포함되는 점이 다릅니다. 이 기능은 REST 인터페이스에서만 사용할 수 있습니다.

확장 가능 서버 액세스 로그 형식 프로그래밍 고려 사항

수시로 각 줄의 끝에 새로운 필드를 추가하여 액세스 로그 레코드 형식을 확장할 수 있습니다. 서버 액세스 로그를 파싱하는 코드가 인식하지 못하는 후행 필드를 처리하도록 코드를 작성해야 합니다.

복사 작업을 위한 추가 로깅

복사 작업에는 GETPUT이 관련됩니다. 그러므로 복사 작업을 수행할 때 2개의 레코드가 로그됩니다. 위 표에서는 작업의 PUT 부분과 관련된 필드를 설명합니다. 아래 목록에서는 복사 작업의 GET 부분과 관련된 레코드의 필드에 대해 설명합니다.

버킷 소유자

복사 중인 객체가 저장되어 있는 버킷의 정식 사용자 ID입니다.

입력 예

Copy
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
버킷

복사 중인 객체가 저장되어 있는 버킷의 이름.

입력 예

Copy
mybucket
시간

요청이 수신된 시간. strftime() 용어를 사용하는 형식은 [%d/%B/%Y:%H:%M:%S %z]입니다.

입력 예

Copy
[06/Feb/2014:00:00:38 +0000]
원격 IP

요청자의 명백한 인터넷 주소. 중간 프록시 및 방화벽이 요청 시스템의 실제 주소를 가릴 수 있습니다.

입력 예

Copy
192.0.2.3
요청자

요청자의 정식 사용자 ID 또는 인증되지 않은 요청의 -입니다. 요청자가 IAM 사용자일 경우 IAM 사용자가 속한 AWS 루트 계정과 함께 요청자의 IAM 사용자 이름이 이 필드에 반환됩니다. 이 식별자는 액세스 제어 목적으로 사용되는 것과 동일합니다.

입력 예

Copy
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
요청 ID

요청 ID는 Amazon S3가 각 요청을 고유하게 식별하기 위해 생성하는 문자열입니다.

입력 예

Copy
3E57427F33A59F07
작업

여기에 나열된 작업은 SOAP.operation, REST.HTTP_method.resource_type, WEBSITE.HTTP_method.resource_type 또는 BATCH.DELETE.OBJECT로 선언됩니다.

입력 예

Copy
REST.COPY.OBJECT_GET

복사 중인 객체의 "키", 작업에 키 파라미터가 없을 경우 "-".

입력 예

Copy
/photos/2014/08/puppy.jpg
요청-URI

HTTP 요청 메시지의 Request-URI 부분.

입력 예

Copy
"GET /mybucket/photos/2014/08/puppy.jpg?x-foo=bar"
HTTP 상태

복사 작업 GET 부분의 숫자 HTTP 상태 코드.

입력 예

Copy
200
오류 코드

복사 작업 GET 부분의 Amazon S3 오류 코드, 또는 오류가 없을 경우 "-"

입력 예

Copy
NoSuchBucket
보낸 바이트

HTTP 프로토콜 오버헤드를 제외한 보낸 응답 바이트 수, 영일 경우 "-".

입력 예

Copy
2662992
객체 크기

해당 객체의 총 크기.

입력 예

Copy
3462992
총 시간

서버 관점에서 요청이 플라이트 상태를 유지한 시간(밀리초). 이 값은 요청이 수신된 시간부터 응답의 마지막 바이트가 전송된 시간까지 측정됩니다. 클라이언트 관점의 측정값은 네트워크 지연 시간으로 인해 더 길 수 있습니다.

입력 예

Copy
70
반환 시간

Amazon S3가 요청을 처리하는 데 소비한 시간(밀리초). 이 값은 요청의 마지막 바이트가 수신된 시간부터 응답의 첫 바이트가 전송된 시간까지 측정됩니다.

입력 예

Copy
10
참조자

HTTP Referrer 헤더의 값(있는 경우). HTTP 사용자 에이전트(예: 브라우저)는 일반적으로 이 헤더를 요청 시 연결 또는 포함 페이지의 URL로 설정합니다.

입력 예

Copy
"http://www.amazon.com/webservices"
사용자 에이전트

HTTP User-Agent 헤더의 값.

입력 예

Copy
"curl/7.15.1"
버전 ID

복사 중인 객체의 ID 또는 x-amz-copy-source 헤더가 복사 원본의 일부로 versionId 파라미터를 지정하지 않은 경우 "-".

입력 예

Copy
3HL4kqtJvjVBH40Nrjfkd