CloudFront キャッシュ統計レポートを表示する
Amazon CloudFront キャッシュ統計レポートには、以下の情報が表示されます。
-
リクエストの合計数 – すべての HTTP ステータスコード (200、404 など) およびすべてのメソッド (GET、HEAD、POST など) に対するリクエストの総数。
-
結果タイプ別のビューワーリクエストの割合 – 選択した CloudFront ディストリビューションのビューワーリクエストの合計数に対するヒット、ミス、エラーの割合。
-
ビューワーに転送されたバイト数 – バイト総数とミスのバイト数。
-
HTTP ステータスコード – HTTP ステータスコード別のビューワーリクエスト数。
-
ダウンロードが終了しなかった GET リクエストの割合 – リクエストされたオブジェクトのダウンロードが終了しなかったビューワー GET リクエストが、リクエスト総数に占める割合 (%)。
これらの統計のデータは、CloudFront アクセスログと同じソースから取得されます。ただし、キャッシュ統計を表示するために、アクセスログを有効にする必要はありません。
毎時間または毎日のデータポイントを使用して、過去 60 日間の指定した日付範囲のグラフを表示できます。通常は、1 時間前までに CloudFront が受け取ったリクエストについてデータを表示できますが、データが 24 時間ほど遅れることもあります。
トピック
コンソールで CloudFront キャッシュ統計レポートを表示する
コンソールで CloudFront キャッシュ統計レポートを表示できます。
CloudFront キャッシュ統計レポートを表示するには
AWS Management Consoleにサインインし、https://console.aws.amazon.com/cloudfront/v4/home
で CloudFront コンソールを開きます。 -
ナビゲーションペインで、[キャッシュ統計] をクリックします。
-
[CloudFront Cache Statistics Reports (CloudFront キャッシュ統計レポート)] ペインの [Start Date (開始日)] と [End Date (終了日)] で、キャッシュ統計のグラフを表示する日付範囲を選択します。使用できる範囲は、[Granularity] で選択した値によって決まります。
-
Daily – 1 日につき 1 つのデータポイントを使用してグラフを表示するには、過去 60 日の中で任意の日付範囲を選択します。
-
Hourly – 1 時間につき 1 つのデータポイントを使用してグラフを表示するには、過去 60 日以内で最大 14 日間の任意の日付範囲を選択します。
日付と時刻は協定世界時 (UTC) です。
-
-
[Granularity] では、グラフに 1 日につき 1 つのデータポイントを表示するか、1 時間につき 1 つのデータポイントを表示するかを指定します。14 日を超える日付範囲を指定した場合、1 時間につき 1 つのデータポイントを指定することはできなくなります。
-
[Viewer Location] で、ビューワーのリクエストが発信された大陸を選択するか、[All Locations] を選択します。キャッシュ統計のグラフには、指定した場所から CloudFront が受信したリクエストのデータが含まれます。
-
[Distribution] リストでは、使用状況グラフにデータを表示するディストリビューションを選択します。
-
個々のディストリビューション - 選択した CloudFront ディストリビューションのデータがグラフに表示されます。[Distribution] リストには、ディストリビューションのディストリビューション ID と代替ドメイン名 (CNAME) が表示されます (ある場合)。ディストリビューションに代替ドメイン名がない場合、リストにはディストリビューションのオリジンドメイン名が含まれます。
-
すべてのディストリビューション - 現在の AWS アカウントアカウントに関連付けられているすべてのディストリビューションのデータが集計されてグラフに表示されます。ただし、削除したディストリビューションは除外されます。
-
-
[Update] (更新) を選択します。
ヒント
-
グラフ内の毎日または毎時間のデータポイントのデータを表示するには、データポイントの上にカーソルを合わせます。
-
転送データを示すグラフの場合、Y 軸の単位をギガバイト、メガバイト、キロバイトのいずれかに変更できます。
CSV 形式でデータをダウンロードする
キャッシュ統計レポートは CSV 形式でダウンロードできます。このセクションでは、レポートをダウンロードする方法と、レポートの値について説明します。
キャッシュ統計レポートを CSV 形式でダウンロードするには
-
キャッシュ統計レポートを表示しているときに、[CSV] を選択します。
-
[Opening file name] ダイアログボックスで、ファイルを開くか保存するかを選択します。
レポートに関する情報
レポートの先頭数行には次の情報が含まれます。
- バージョン
-
この CSV ファイルの形式のバージョン。
- レポート
-
レポートの名前。
- DistributionID
-
レポートを実行した対象のディストリビューションの ID。または、すべてのディストリビューションを対象にレポートを実行した場合は
ALL
。 - StartDateUTC
-
協定世界時 (UTC) によるレポートを実行した日付範囲の開始日。
- EndDateUTC
-
協定世界時 (UTC) によるレポートを実行した日付範囲の終了日。
- GeneratedTimeUTC
-
協定世界時 (UTC) によるレポートを実行した日時。
- 詳細度
-
レポートの各行が 1 時間と 1 日のどちらを表すか。
- ViewerLocation
-
ビューワーリクエストが発信された大陸。または、すべての場所についてレポートをダウンロードする場合は
ALL
。
キャッシュ統計レポートのデータ
レポートには次の値が含まれています。
- DistributionID
-
レポートを実行した対象のディストリビューションの ID。または、すべてのディストリビューションを対象にレポートを実行した場合は
ALL
。 - FriendlyName
-
ディストリビューションの代替ドメイン名 (CNAME)、(存在する場合)。ディストリビューションに代替ドメイン名がない場合、リストにはディストリビューションのオリジンドメイン名が含まれます。
- ViewerLocation
-
ビューワーリクエストが発信された大陸。または、すべての場所についてレポートをダウンロードする場合は
ALL
。 - TimeBucket
-
協定世界時 (UTC) によるデータに該当する時間または日付。
- RequestCount
-
すべての HTTP ステータスコード (200、404 など) およびすべてのメソッド (GET、HEAD、POST など) のリクエストの総数。
- HitCount
-
CloudFront エッジキャッシュからオブジェクトが提供されたビューワーリクエストの数。
- MissCount
-
オブジェクトが現在エッジキャッシュに存在せず、CloudFront でオリジンからオブジェクトを取得する必要があるビューワーリクエストの数。
- ErrorCount
-
エラーになり、CloudFront でオブジェクトを提供できなかったビューワーリクエストの数。
- IncompleteDownloadCount
-
ビューワーがオブジェクトのダウンロードを開始したが、ダウンロードを終了できなかったビューワーリクエストの数。
- HTTP2xx
-
HTTP ステータスコードが 2xx 値 (成功) であるビューワーリクエストの数。
- HTTP3xx
-
HTTP ステータスコードが 3xx 値 (追加のアクションが必要) であるビューワーリクエストの数。
- HTTP4xx
-
HTTP ステータスコードが 4xx 値 (クライアントエラー) であるビューワーリクエストの数。
- HTTP5xx
-
HTTP ステータスコードが 5xx 値 (サーバーエラー) であるビューワーリクエストの数。
- TotalBytes
-
すべての HTTP メソッドに対するすべてのリクエストに応じて CloudFront からビューワーに提供される合計バイト数。
- BytesFromMisses
-
リクエストの発生時にエッジキャッシュに存在しなかったオブジェクトのビューワーに提供されたバイト数。この値は、オリジンから CloudFront エッジキャッシュに転送されたバイトの正確な概算です。ただし、エッジキャッシュに既に存在していても、有効期限が切れているオブジェクトのリクエストは除きます。
キャッシュ統計のグラフと CloudFront 標準ログ (アクセスログ) のデータとの関連
次の表は、CloudFront コンソールのキャッシュ統計のグラフと、対応する CloudFront アクセスログの値を示します。CloudFront アクセスログの詳細については、「標準ログ (アクセスログ) を設定および使用する」を参照してください。
- Total requests
-
このグラフには、すべての HTTP ステータスコード (200 または 404 など) およびすべてのメソッド (
GET
、HEAD
、またはPOST
など) のリクエストの総数が表示されます。このグラフに表示されるリクエストの総数は、同じ期間のアクセスログファイルのリクエストの総数と同じです。 - Percentage of viewer requests by result type
-
このグラフには、選択した CloudFront ディストリビューションの合計ビューワーリクエストに対するヒット、ミス、エラーの割合が表示されます。
-
Hit – オブジェクトが CloudFront エッジキャッシュから提供されるビューワーリクエスト。アクセスログでは、これらのリクエストの
x-edge-response-result-type
の値はHit
です。 -
Miss – オブジェクトが現在エッジキャッシュに存在せず、CloudFront でオリジンからオブジェクトを取得する必要があるビューワーリクエスト。アクセスログでは、これらのリクエストの
x-edge-response-result-type
の値はMiss
です。 -
Error – エラーになり、CloudFront でオブジェクトを提供できなかったビューワーリクエスト。アクセスログでは、これらのリクエストの
x-edge-response-result-type
の値はError
、LimitExceeded
またはCapacityExceeded
です。
グラフには、エッジキャッシュに存在しても、有効期限が切れているオブジェクトのリフレッシュヒットリクエストは含まれません。アクセスログでは、リフレッシュヒットのリクエストの
x-edge-response-result-type
の値はRefreshHit
です。 -
- Bytes transferred to viewers
-
このグラフには 2 つの値が表示されます。
-
Total bytes – すべての HTTP メソッドに対するすべてのリクエストに応じて CloudFront からビューワーに提供される合計バイト数。CloudFront アクセスログでは、[Total Bytes (合計バイト数)] は、
sc-bytes
列の同じ期間に発生したすべてのリクエストの値の合計です。 -
Bytes from misses – リクエストの発生時にエッジキャッシュに存在しなかったオブジェクトのビューワーに提供されたバイト数。CloudFront アクセスログでは、[bytes from misses]] (欠落しているオブジェクトのバイト数) は、
sc-bytes
列で、x-edge-result-type
の値がMiss
であるリクエストの値の合計です。この値は、オリジンから CloudFront エッジキャッシュに転送されたバイトの正確な概算です。ただし、エッジキャッシュに既に存在していても、有効期限が切れているオブジェクトのリクエストは除きます。
-
- HTTP ステータスコード
-
このグラフには HTTP ステータスコードごとのビューワーリクエストが表示されます。CloudFront アクセスログでは、ステータスコードは
sc-status
列に表示されます。-
2xx – 成功したリクエスト。
-
3xx – 追加のアクションが必要です。たとえば、301 (Moved Permanently) は、リクエストされたオブジェクトが異なる場所に移動されていることを意味します。
-
4xx – クライアント側のエラー。たとえば、404 (Not Found) は、クライアントが、検出できないオブジェクトをリクエストしたことを意味します。
-
5xx – オリジンサーバーがリクエストを実行しませんでした。たとえば、503 (Service Unavailable) は、オリジンサーバーが現在利用できないことを意味します。
-
- Percentage of GET requests that didn't finish downloading
-
このグラフでは、合計リクエストに対して、リクエストされたオブジェクトのダウンロードが終了していない、ビューワーの
GET
リクエストの割合が表示されます。通常、オブジェクトのダウンロードが完了しないのは、たとえば別のリンクをクリックしたり、ブラウザを閉じたりして、ビューワーによってキャンセルされたときです。CloudFront アクセスログでは、これらのリクエストの200
列の値は、sc-status
で、Error
列の値は、x-edge-result-type
です。