# CloudFront 人気オブジェクトのレポートを表示する
<a name="popular-objects-report"></a>

Amazon CloudFront 人気オブジェクトレポートを表示して、過去 60 日間の指定された日付範囲内のディストリビューションで最も人気のある 50 個のオブジェクトを確認します。これらのオブジェクトに関する統計を表示することもできます。これには、以下が含まれます。
+ オブジェクトに対するリクエストの数
+ ヒットとミスの数
+ Hit ratio
+ ミスのために供給されたバイト数
+ 供給された合計バイト数
+ 不完全なダウンロードの数
+ HTTP ステータスコード (2xx、3xx、4xx、5xx) 別のリクエスト数

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

**Topics**
+ [コンソールで CloudFront 人気オブジェクトのレポートを表示する](#popular-objects-howto)
+ [CloudFront が人気オブジェクト統計を計算する方法](#popular-objects-calculate)
+ [CSV 形式でデータをダウンロードする](#popular-objects-csv)
+ [人気オブジェクトレポートのデータと CloudFront 標準ログ (アクセスログ) のデータとの関連](#popular-objects-data)

## コンソールで CloudFront 人気オブジェクトのレポートを表示する
<a name="popular-objects-howto"></a>

コンソールで CloudFront 人気オブジェクトのレポートを表示できます。<a name="popular-objects-report-procedure"></a>

**CloudFront ディストリビューションの人気オブジェクトを表示するには**

1. AWS マネジメントコンソールにサインインし、[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home) で CloudFront コンソールを開きます。

1. ナビゲーションペインで、**[人気オブジェクト]** をクリックします。

1. [**CloudFront Popular Objects Report (CloudFront 人気オブジェクトレポート)**] ペインの [**Start Date (開始日)**] と [**End Date (終了日)**] で、人気オブジェクトのリストを表示する日付範囲を選択します。過去 60 日間の任意の日付範囲を選択できます。

   日付と時刻は協定世界時 (UTC) です。

1. [**Distribution**] リストで、人気オブジェクトのリストを表示するディストリビューションを選択します。

1. **[更新]** を選択します。

## CloudFront が人気オブジェクト統計を計算する方法
<a name="popular-objects-calculate"></a>

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

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

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

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

## CSV 形式でデータをダウンロードする
<a name="popular-objects-csv"></a>

人気オブジェクトレポートは CSV 形式でダウンロードできます。このセクションでは、レポートをダウンロードする方法と、レポートの値について説明します。<a name="popular-objects-csv-procedure"></a>

**人気オブジェクトレポートを CSV 形式でダウンロードするには**

1. 人気オブジェクトレポートを表示しているときに、**[CSV]** を選択します。

1. [**Opening *file name***] ダイアログボックスで、ファイルを開くか保存するかを選択します。

### レポートに関する情報
<a name="popular-objects-csv-header"></a>

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

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

**レポート**  
レポートの名前。

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

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

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

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

### 人気オブジェクトレポートのデータ
<a name="popular-objects-csv-data"></a>

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

**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 標準ログ (アクセスログ) のデータとの関連
<a name="popular-objects-data"></a>

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

**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) は、オリジンサーバーが現在利用できないことを意味します。