CloudFront 人気オブジェクトのレポートを表示する - Amazon CloudFront
コンソールで CloudFront 人気オブジェクトのレポートを表示するCloudFront が人気オブジェクト統計を計算する方法CSV 形式でデータをダウンロードする人気オブジェクトレポートのデータと CloudFront 標準ログ (アクセスログ) のデータとの関連

CloudFront 人気オブジェクトのレポートを表示する

Amazon CloudFront 人気オブジェクトレポートを表示して、過去 60 日間の指定された日付範囲内のディストリビューションで最も人気のある 50 個のオブジェクトを確認します。これらのオブジェクトに関する統計を表示することもできます。これには、以下が含まれます。

  • オブジェクトに対するリクエストの数

  • ヒットとミスの数

  • Hit ratio

  • ミスのために供給されたバイト数

  • 供給された合計バイト数

  • 不完全なダウンロードの数

  • HTTP ステータスコード (2xx、3xx、4xx、5xx) 別のリクエスト数

これらの統計のデータは CloudFront アクセスログと同じソースから取得されます。ただし、人気オブジェクトを表示するために、アクセスログを有効にする必要はありません。

コンソールで CloudFront 人気オブジェクトのレポートを表示できます。

ディストリビューションの上位 50 件のオブジェクトの正確な数を取得するには、CloudFront で、午前 0 時から 10 分間隔ですべてのオブジェクトのリクエストをカウントし、その後 24 時間にわたって上位 150 件のオブジェクトの現在までの累計を保持します。(CloudFront は、上位 150 件のオブジェクトの毎日の合計を 60 日間保持します)。

リストの最下位に近いオブジェクトは、リストに加わったり、リストからなくなったりするため、これらのオブジェクトの合計は概算です。150 件のオブジェクトのリストの中の上位 50 件のオブジェクトもリスト内で上がったり下がったりする可能性はありますが、リストから完全になくなることはほとんどないため、これらのオブジェクトの合計は信頼できます。

オブジェクトが上位 150 件のリストからなくなり、その日のうちに再びリストに加わった場合、CloudFront で、そのオブジェクトがリストになかった期間の推定リクエスト数が追加されます。この予測は、その期間中にリストの最後にあったオブジェクトから受け取ったリクエストの数に基づいています。

オブジェクトがその日のうちに上位 50 件のオブジェクトに加わった場合、オブジェクトが上位 150 件になかった間に CloudFront が受け取ったリクエストの数の予想により、通常、人気オブジェクトレポートのリクエスト数は、そのオブジェクトのアクセスログに表示されるリクエストの数を超えます。

人気オブジェクトレポートは CSV 形式でダウンロードできます。このセクションでは、レポートをダウンロードする方法と、レポートの値について説明します。

レポートの先頭数行には次の情報が含まれます。

バージョン

この CSV ファイルの形式のバージョン。

レポート

レポートの名前。

DistributionID

レポートを実行した対象のディストリビューションの ID。

StartDateUTC

協定世界時 (UTC) によるレポートを実行した日付範囲の開始日。

EndDateUTC

協定世界時 (UTC) によるレポートを実行した日付範囲の終了日。

GeneratedTimeUTC

協定世界時 (UTC) によるレポートを実行した日時。

レポートには次の値が含まれています。

DistributionID

レポートを実行した対象のディストリビューションの ID。

FriendlyName

ディストリビューションの代替ドメイン名 (CNAME)、(存在する場合)。ディストリビューションに代替ドメイン名がない場合、リストにはディストリビューションのオリジンドメイン名が含まれます。

オブジェクト

オブジェクトの URL の最後の 500 文字。

RequestCount

このオブジェクトに対するリクエストの総数。

HitCount

CloudFront エッジキャッシュからオブジェクトが提供されたビューワーリクエストの数。

MissCount

オブジェクトが現在エッジキャッシュに存在せず、CloudFront でオリジンからオブジェクトを取得する必要があるビューワーリクエストの数。

HitCountPct

HitCount の値に対する RequestCount の値の割合。

BytesFromMisses

リクエストの発生時にエッジキャッシュにオブジェクトが存在しなかった場合に、このオブジェクトについてビューワーに提供されたバイト数。

TotalBytes

すべての HTTP メソッドのすべてのリクエストに応じて、このオブジェクトについて CloudFront からビューワーに提供される合計バイト数。

IncompleteDownloadCount

このオブジェクトについて、ビューワーがオブジェクトのダウンロードを開始したが、ダウンロードを終了できなかったビューワーリクエストの数。

HTTP2xx

HTTP ステータスコードが 2xx 値 (成功) であるビューワーリクエストの数。

HTTP3xx

HTTP ステータスコードが 3xx 値 (追加のアクションが必要) であるビューワーリクエストの数。

HTTP4xx

HTTP ステータスコードが 4xx 値 (クライアントエラー) であるビューワーリクエストの数。

HTTP5xx

HTTP ステータスコードが 5xx 値 (サーバーエラー) であるビューワーリクエストの数。

次のリストは、CloudFront コンソールの人気オブジェクトレポートの値と、対応する CloudFront アクセスログの値を示します。CloudFront アクセスログの詳細については、「標準ログ (アクセスログ) を設定および使用する」を参照してください。

URL

オブジェクトへのアクセスにビューワーが使用する URL の末尾 500 文字です。

リクエスト

オブジェクトに対するリクエストの総数。一般的にこの値は、CloudFront アクセスログのオブジェクトの GET リクエストの数とほぼ一致します。

Hits

CloudFront エッジキャッシュからオブジェクトが提供されたビューワーリクエストの数。アクセスログでは、これらのリクエストの x-edge-response-result-type の値は Hit です。

Misses

オブジェクトがエッジキャッシュに存在しないため、CloudFront でオリジンからオブジェクトが取得されたビューワーリクエストの数。アクセスログでは、これらのリクエストの x-edge-response-result-type の値は Miss です。

Hit ratio

[Requests] 列の値に対する、[Hits] 列の値の割合。

Bytes from misses

リクエストの発生時にエッジキャッシュに存在しなかったオブジェクトのビューワーに提供されたバイト数。CloudFront アクセスログでは、[bytes from misses]] (欠落しているオブジェクトのバイト数) は、sc-bytes 列で、x-edge-result-type の値が Miss であるリクエストの値の合計です。

Total bytes

すべての HTTP メソッドのオブジェクトに対するすべてのリクエストに応じて CloudFront からビューワーに提供される合計バイト数。CloudFront アクセスログでは、[total bytes] (合計バイト数) は、sc-bytes 列の同じ期間に発生したすべてのリクエストの値の合計です。

Incomplete downloads

リクエストされたオブジェクトのダウンロードが終了しなかったビューワーリクエストの数。通常、ダウンロードが完了しないのは、たとえば別のリンクをクリックしたり、ブラウザを閉じたりして、ビューワーによってキャンセルされたときです。CloudFront アクセスログでは、これらのリクエストの 200 列の値は、sc-status で、Error 列の値は、x-edge-result-type です。

2xx

HTTP ステータスコードが 2xx、Successful であるリクエストの数。CloudFront アクセスログでは、ステータスコードは sc-status 列に表示されます。

3xx

HTTP ステータスコードが 3xx (Redirection) であるリクエストの数です。3xx のステータスコードは追加のアクションが必要であることを表します。たとえば、301 (Moved Permanently) は、リクエストされたオブジェクトが異なる場所に移動されていることを意味します。

4xx

HTTP ステータスコードが 4xx (Client Error) であるリクエストの数です。4xx のステータスコードはクライアント側でエラーが発生したことを表します。たとえば、404 (Not Found) は、クライアントが、検出できないオブジェクトをリクエストしたことを意味します。

5xx

HTTP ステータスコードが 5xx (Server Error) であるリクエストの数です。5xx のステータスコードはオリジンサーバーでリクエストが実行されなかったことを表します。たとえば、503 (Service Unavailable) は、オリジンサーバーが現在利用できないことを意味します。