メニュー
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

ソースバケット所有者の正規ユーザー ID。

エントリ例

Copy
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
バケット

リクエストの処理対象のバケットの名前。システムで受け取ったリクエストの形式に誤りがあり、バケットを特定できない場合、そのリクエストはサーバーアクセスログに表示されません。

エントリ例

Copy
mybucket
時間

リクエストを受け取った時刻。形式は strftime() の用語を使用し、[%d/%b/%Y:%H:%M:%S %z] になります。

エントリ例

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

リクエスタの表面上のインターネットアドレス。中間プロキシやファイアウォールにより、リクエストを作成したマシンの実際のアドレスが不明確になる場合があります。

エントリ例

Copy
192.0.2.3
リクエスタ

リクエスタの正規ユーザー ID。認証されていないリクエストの場合は - です。リクエスタが IAM ユーザーの場合、このフィールドは、リクエスタの IAM ユーザー名と IAM ユーザーが所属する AWS ルートアカウントと共に表示します。 この識別子は、アクセスコントロールに使用されるものと同じです。

エントリ例

Copy
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
リクエスト ID

リクエスト ID は、各リクエストを一意に識別するために Amazon S3 によって生成される文字列です。

エントリ例

Copy
3E57427F33A59F07
オペレーション

ここに表示されているオペレーションは、SOAP.operationREST.HTTP_method.resource_typeWEBSITE.HTTP_method.resource_type または BATCH.DELETE.OBJECT と表示されます。

エントリ例

Copy
REST.PUT.OBJECT
キー

リクエストの URL エンコードされた「key」部分、オペレーションがキーパラメーターを取らない場合は「-」。

エントリ例

Copy
/photos/2014/08/puppy.jpg
Request-URI

HTTP リクエストメッセージの Request-URI の部分。

エントリ例

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

レスポンスの HTTP ステータスの数値。

エントリ例

Copy
200
エラーコード

Amazon S3 エラーコード。エラーがない場合は「-」。

エントリ例

Copy
NoSuchBucket
Bytes Sent

送信されたレスポンスのバイト数(HTTP プロトコルオーバーヘッドを除きます)。ゼロの場合は「-」。

エントリ例

Copy
2662992
Object Size

該当するオブジェクトの合計サイズ。

エントリ例

Copy
3462992
Total Time

サーバーから見た、リクエストの転送中の時間数(ミリ秒単位)。これは、リクエストが受信されてから、レスポンスの最終バイトが送信されるまでの時間を計測した値です。クライアント側での計測値は、ネットワーク遅延により長くなる場合があります。

エントリ例

Copy
70
Turn-Around Time

Amazon S3 でリクエストの処理に要した時間数(ミリ秒単位)。これは、リクエストの最終バイトが受信されてから、レスポンスの先頭バイトが送信されるまでの時間を計測した値です。

エントリ例

Copy
10
Referrer

HTTP Referrer ヘッダーの値(存在する場合)。一般に、HTTP ユーザーエージェント(例: ブラウザ)はこのヘッダーをリクエスト作成時のリンクまたは埋め込みページの URL に設定します。

エントリ例

Copy
"http://www.amazon.com/webservices"
User-Agent

HTTP User-Agent ヘッダーの値。

エントリ例

Copy
"curl/7.15.1"
Version Id

リクエストのバージョン ID。オペレーションが versionId パラメーターを取らない場合は「-」。

エントリ例

Copy
3HL4kqtJvjVBH40Nrjfkd

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

カスタムの 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 部分に関連するフィールドを説明します。

Bucket Owner

コピーされたオブジェクトを格納するバケットの正規ユーザー ID。

エントリ例

Copy
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
バケット

コピー対象のオブジェクトを格納するバケットの名前。

エントリ例

Copy
mybucket
時間

リクエストを受け取った時刻。形式は strftime() の用語を使用し、[%d/%B/%Y:%H:%M:%S %z] になります。

エントリ例

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

リクエスタの表面上のインターネットアドレス。中間プロキシやファイアウォールにより、リクエストを作成したマシンの実際のアドレスが不明確になる場合があります。

エントリ例

Copy
192.0.2.3
リクエスタ

リクエスタの正規ユーザー ID。認証されていないリクエストの場合は - です。リクエスタが IAM ユーザーの場合、このフィールドは、リクエスタの IAM ユーザー名と IAM ユーザーが所属する AWS ルートアカウントと共に表示します。 この識別子は、アクセスコントロールに使用されるものと同じです。

エントリ例

Copy
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
リクエスト ID

リクエスト ID は、各リクエストを一意に識別するために Amazon S3 によって生成される文字列です。

エントリ例

Copy
3E57427F33A59F07
オペレーション

ここに表示されているオペレーションは、SOAP.operationREST.HTTP_method.resource_typeWEBSITE.HTTP_method.resource_type または BATCH.DELETE.OBJECT と表示されます。

エントリ例

Copy
REST.COPY.OBJECT_GET
キー

コピー対象のオブジェクトの「key」部分。オペレーションがキーパラメーターを取らない場合は「-」。

エントリ例

Copy
/photos/2014/08/puppy.jpg
Request-URI

HTTP リクエストメッセージの Request-URI の部分。

エントリ例

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

コピーオペレーションの GET 部分の HTTP ステータスの数値。

エントリ例

Copy
200
エラーコード

コピーオペレーションの GET 部分の Amazon S3 エラーコード。エラーがない場合は「-」。

エントリ例

Copy
NoSuchBucket
Bytes Sent

送信されたレスポンスのバイト数(HTTP プロトコルオーバーヘッドを除きます)。ゼロの場合は「-」。

エントリ例

Copy
2662992
Object Size

該当するオブジェクトの合計サイズ。

エントリ例

Copy
3462992
Total Time

サーバーから見た、リクエストの転送中の時間数(ミリ秒単位)。これは、リクエストが受信されてから、レスポンスの最終バイトが送信されるまでの時間を計測した値です。クライアント側での計測値は、ネットワーク遅延により長くなる場合があります。

エントリ例

Copy
70
Turn-Around Time

Amazon S3 でリクエストの処理に要した時間数(ミリ秒単位)。これは、リクエストの最終バイトが受信されてから、レスポンスの先頭バイトが送信されるまでの時間を計測した値です。

エントリ例

Copy
10
Referrer

HTTP Referrer ヘッダーの値(存在する場合)。一般に、HTTP ユーザーエージェント(例: ブラウザ)はこのヘッダーをリクエスト作成時のリンクまたは埋め込みページの URL に設定します。

エントリ例

Copy
"http://www.amazon.com/webservices"
User-Agent

HTTP User-Agent ヘッダーの値。

エントリ例

Copy
"curl/7.15.1"
Version Id

コピー対象のオブジェクトのバージョン ID。x-amz-copy-source ヘッダーでコピー元の一部として versionId パラメーターを指定しなかった場合は「-」。

エントリ例

Copy
3HL4kqtJvjVBH40Nrjfkd