メニュー
Amazon Simple Storage Service
開発者ガイド (API Version 2006-03-01)

サーバーアクセスログの形式

サーバーアクセスログファイルは、改行で区切られた一連のログレコードで構成されます。各ログレコードは 1 個のリクエストを表し、スペースで区切られたフィールドで構成されます。次に示すのは、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" -

注記

フィールドが「-」に設定されている場合、データが不明であるか利用できないこと、またはこのリクエストに該当しないフィールドであることを示します。

次の表は、ログレコードのフィールドについて説明しています。

フィールド名 エントリ例 コメント
Bucket Owner
Copy
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
ソースバケット所有者の正規ユーザー ID。
バケット
Copy
mybucket
リクエストの処理対象のバケットの名前。システムで受け取ったリクエストの形式に誤りがあり、バケットを特定できない場合、そのリクエストはサーバーアクセスログに表示されません。
時間
Copy
[06/Feb/2014:00:00:38 +0000]
リクエストを受け取った時刻。形式は strftime() の用語を使用し、[%d/%b/%Y:%H:%M:%S %z] になります。
Remote IP
Copy
192.0.2.3
リクエスタの表面上のインターネットアドレス。中間プロキシやファイアウォールにより、リクエストを作成したマシンの実際のアドレスが不明確になる場合があります。
リクエスタ
Copy
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
リクエスタの正規ユーザー ID。未認証リクエストの場合は「Anonymous」という文字列。 リクエスタが IAM ユーザーの場合、このフィールドは、リクエスタの IAM ユーザー名と IAM ユーザーが所属する AWS ルートアカウントと共に表示します。 この識別子は、アクセスコントロールに使用されるものと同じです。
リクエスト ID
Copy
3E57427F33A59F07
リクエスト ID は、各リクエストを一意に識別するために Amazon S3 によって生成される文字列です。
オペレーション
Copy
REST.PUT.OBJECT
ここに表示されているオペレーションは、SOAP.operationREST.HTTP_method.resource_typeWEBSITE.HTTP_method.resource_type または BATCH.DELETE.OBJECT と表示されます。
キー
Copy
/photos/2014/08/puppy.jpg
リクエストの URL エンコードされた「key」部分、オペレーションがキーパラメーターを取らない場合は「-」。
Request-URI
Copy
"GET /mybucket/photos/2014/08/puppy.jpg?x-foo=bar"
HTTP リクエストメッセージの Request-URI の部分。
HTTP status
Copy
200
レスポンスの HTTP ステータスの数値。
エラーコード
Copy
NoSuchBucket
Amazon S3 エラーコード。エラーがない場合は「-」。
Bytes Sent
Copy
2662992
送信されたレスポンスのバイト数(HTTP プロトコルオーバーヘッドを除きます)。ゼロの場合は「-」。
Object Size
Copy
3462992
該当するオブジェクトの合計サイズ。
Total Time
Copy
70
サーバーから見た、リクエストの転送中の時間数(ミリ秒単位)。これは、リクエストが受信されてから、レスポンスの最終バイトが送信されるまでの時間を計測した値です。クライアント側での計測値は、ネットワーク遅延により長くなる場合があります。
Turn-Around Time
Copy
10
Amazon S3 でリクエストの処理に要した時間数(ミリ秒単位)。これは、リクエストの最終バイトが受信されてから、レスポンスの先頭バイトが送信されるまでの時間を計測した値です。
Referrer
Copy
"http://www.amazon.com/webservices"
HTTP Referrer ヘッダーの値(存在する場合)。一般に、HTTP ユーザーエージェント(例: ブラウザ)はこのヘッダーをリクエスト作成時のリンクまたは埋め込みページの URL に設定します。
User-Agent
Copy
"curl/7.15.1"
HTTP User-Agent ヘッダーの値。
Version Id
Copy
3HL4kqtJvjVBH40Nrjfkd
リクエストのバージョン ID。オペレーションが versionId パラメーターを取らない場合は「-」。

カスタムアクセスログ情報

カスタムの query-string パラメーターをリクエストの URL に追加することで、カスタム情報をリクエストのアクセスログレコードに含めることができます。Amazon S3 では、「x-」で始まる query-string パラメーターは無視されますが、これらのパラメーターは、ログレコードの 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 部分に関連するフィールドを説明します。

t
フィールド名 エントリ例 コメント
Bucket Owner
Copy
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
コピーされたオブジェクトを格納するバケットの正規ユーザー ID。
バケット
Copy
mybucket
コピー対象のオブジェクトを格納するバケットの名前。
時間
Copy
[06/Feb/2014:00:00:38 +0000]
リクエストを受け取った時刻。形式は strftime() の用語を使用し、[%d/%B/%Y:%H:%M:%S %z] になります。
Remote IP
Copy
192.0.2.3
リクエスタの表面上のインターネットアドレス。中間プロキシやファイアウォールにより、リクエストを作成したマシンの実際のアドレスが不明確になる場合があります。
リクエスタ
Copy
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
リクエスタの正規ユーザー ID。未認証リクエストの場合は「Anonymous」という文字列。 リクエスタが IAM ユーザーの場合、このフィールドは、リクエスタの IAM ユーザー名と IAM ユーザーが所属する AWS ルートアカウントと共に表示します。 この識別子は、アクセスコントロールに使用されるものと同じです。
リクエスト ID
Copy
3E57427F33A59F07
リクエスト ID は、各リクエストを一意に識別するために Amazon S3 によって生成される文字列です。
オペレーション
Copy
REST.COPY.OBJECT_GET
ここに表示されているオペレーションは、SOAP.operationREST.HTTP_method.resource_typeWEBSITE.HTTP_method.resource_type または BATCH.DELETE.OBJECT と表示されます。
キー
Copy
/photos/2014/08/puppy.jpg
コピー対象のオブジェクトの「key」部分。オペレーションがキーパラメーターを取らない場合は「-」。
Request-URI
Copy
"GET /mybucket/photos/2014/08/puppy.jpg?x-foo=bar"
HTTP リクエストメッセージの Request-URI の部分。
HTTP status
Copy
200
コピーオペレーションの GET 部分の HTTP ステータスの数値。
エラーコード
Copy
NoSuchBucket
コピーオペレーションの GET 部分の Amazon S3 エラーコード。エラーがない場合は「-」。
Bytes Sent
Copy
2662992
送信されたレスポンスのバイト数(HTTP プロトコルオーバーヘッドを除きます)。ゼロの場合は「-」。
Object Size
Copy
3462992
該当するオブジェクトの合計サイズ。
Total Time
Copy
70
サーバーから見た、リクエストの転送中の時間数(ミリ秒単位)。これは、リクエストが受信されてから、レスポンスの最終バイトが送信されるまでの時間を計測した値です。クライアント側での計測値は、ネットワーク遅延により長くなる場合があります。
Turn-Around Time
Copy
10
Amazon S3 でリクエストの処理に要した時間数(ミリ秒単位)。これは、リクエストの最終バイトが受信されてから、レスポンスの先頭バイトが送信されるまでの時間を計測した値です。
Referrer
Copy
"http://www.amazon.com/webservices"
HTTP Referrer ヘッダーの値(存在する場合)。一般に、HTTP ユーザーエージェント(例: ブラウザ)はこのヘッダーをリクエスト作成時のリンクまたは埋め込みページの URL に設定します。
User-Agent
Copy
"curl/7.15.1"
HTTP User-Agent ヘッダーの値。
Version Id
Copy
3HL4kqtJvjVBH40Nrjfkd
コピー対象のオブジェクトのバージョン ID。x-amz-copy-source ヘッダーでコピー元の一部として versionId パラメーターを指定しなかった場合は「-」。