Amazon Simple Storage Service
개발자 안내서 (API 버전 2006-03-01)

서버 액세스 로그 형식

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

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입니다. 정식 사용자 ID는 또 다른 형식의 AWS 계정 ID입니다. 정식 사용자 ID에 대한 자세한 내용은 AWS 계정 식별자를 참조하십시오. 계정의 정식 사용자 ID를 찾는 방법에 대한 정보는 계정 정식 사용자 ID 찾기를 참조하십시오.

입력 예

79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
버킷

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

입력 예

mybucket
시간

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

입력 예

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

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

입력 예

192.0.2.3
요청자

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

입력 예

79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
요청 ID

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

입력 예

3E57427F33A59F07
작업

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

입력 예

REST.PUT.OBJECT

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

입력 예

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

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

입력 예

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

응답의 숫자 HTTP 상태 코드.

입력 예

200
오류 코드

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

입력 예

NoSuchBucket
보낸 바이트

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

입력 예

2662992
객체 크기

해당 객체의 총 크기.

입력 예

3462992
총 시간

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

입력 예

70
반환 시간

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

입력 예

10
참조자

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

입력 예

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

HTTP User-Agent 헤더의 값.

입력 예

"curl/7.15.1"
버전 ID

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

입력 예

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입니다. 정식 사용자 ID는 또 다른 형식의 AWS 계정 ID입니다. 정식 사용자 ID에 대한 자세한 내용은 AWS 계정 식별자를 참조하십시오. 계정의 정식 사용자 ID를 찾는 방법에 대한 정보는 계정 정식 사용자 ID 찾기를 참조하십시오.

입력 예

79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
버킷

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

입력 예

mybucket
시간

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

입력 예

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

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

입력 예

192.0.2.3
요청자

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

입력 예

79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
요청 ID

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

입력 예

3E57427F33A59F07
작업

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

입력 예

REST.COPY.OBJECT_GET

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

입력 예

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

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

입력 예

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

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

입력 예

200
오류 코드

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

입력 예

NoSuchBucket
보낸 바이트

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

입력 예

2662992
객체 크기

해당 객체의 총 크기.

입력 예

3462992
총 시간

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

입력 예

70
반환 시간

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

입력 예

10
참조자

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

입력 예

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

HTTP User-Agent 헤더의 값.

입력 예

"curl/7.15.1"
버전 ID

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

입력 예

3HL4kqtJvjVBH40Nrjfkd