

# 在控制台中查看 CloudFront 报告
<a name="reports"></a>

每份报告都提供详细的信息和可视化效果，以便您可以优化内容交付、确定性能瓶颈并做出数据驱动的决策。无论您是需要监控缓存效率、分析流量规律，还是更好地了解查看器，您都可以使用这些报告来有效地监控和分析 CloudFront 分配。

您可以在控制台中查看有关您的 CloudFront 活动的以下报告：

**Topics**
+ [查看 CloudFront 缓存统计报告](cache-statistics.md)
+ [查看 CloudFront 常用对象报告](popular-objects-report.md)
+ [查看 CloudFront 常用引用站点报告](top-referrers-report.md)
+ [查看 CloudFront 使用情况报告](usage-charts.md)
+ [查看 CloudFront 查看器报告](viewers-reports.md)

上述多数报告都是基于 CloudFront 访问日志中的数据，其中详细介绍了 CloudFront 收到的每个用户请求。您无需启用访问日志即可查看此类报告。有关更多信息，请参阅[访问日志（标准日志）](AccessLogs.md)。

# 查看 CloudFront 缓存统计报告
<a name="cache-statistics"></a>

Amazon CloudFront 缓存统计报告显示了以下信息：
+ **请求总数** – 所有 HTTP 状态代码（例如，200 或 404）以及所有方法（例如，GET、HEAD 或 POST）的请求总数。
+ **查看器请求所占的百分比（按结果类型划分）**– 选定的 CloudFront 分配的命中数、未命中数和错误数占查看器请求总数的百分比
+ **传输到查看器的字节数** – 总字节数和未命中的字节数
+ **HTTP 状态代码** – 按 HTTP 状态代码划分的查看器请求
+ **未完成下载的 GET 请求所占的百分比** – 未完成下载请求的对象的查看器 GET 请求数占请求总数的百分比

这些统计数据与 CloudFront 访问日志来自同一来源。但是，您无需启用[访问日志记录](AccessLogs.md)即可查看缓存统计信息。

您可以显示过去 60 天内指定日期范围的图表，将每小时或每天作为数据点。通常，您可以查看 CloudFront 在一小时前收到的最新请求的相关数据，但数据偶尔会延迟（长达 24 小时）。

**Topics**
+ [在控制台中查看 CloudFront 缓存统计报告](#cache-statistics-howto)
+ [以 CSV 格式下载数据](#cache-statistics-csv)
+ [缓存统计图与 CloudFront 标准日志（访问日志）中数据的相关度](#cache-statistics-data)

## 在控制台中查看 CloudFront 缓存统计报告
<a name="cache-statistics-howto"></a>

您可以在控制台中查看 CloudFront 缓存统计报告。<a name="cache-statistics-procedure"></a>

**查看 CloudFront 缓存统计报告**

1. 登录 AWS 管理控制台，并通过以下网址打开 CloudFront 控制台：[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home)。

1. 在导航窗格中，单击**缓存统计数据**。

1. 在 **CloudFront 缓存统计报告**窗格中，为**开始日期**和**结束日期**选择要显示缓存统计图表的日期范围。可用的范围取决于您为**粒度**选择的值：
   + **每天** – 要显示每天一个数据点的图表，请选择前 60 天内的任何日期范围。
   + **每小时** – 要显示每小时一个数据点的图表，请选择前 60 天内的最多 14 天的任何日期范围。

   日期和时间采用协调世界时 (UTC)。

1. 对于**粒度**，请指定在图表中是每天显示一个数据点还是每小时显示一个数据点。如果您指定大于 14 天的日期范围，则指定每小时一个数据点的选项不可用。

1. 对于**查看器位置**，请选择查看器请求来自哪个洲，或选择**所有位置**。缓存统计信息表包括 CloudFront 收到的来自指定位置的请求数据。

1. 在**分配**列表中，选择您要在使用情况图表中显示数据的分配：
   + **单个分配** – 此类图表显示选定的 CloudFront Web 分配的数据。**分配**列表显示分配 ID 和分配的备用域名 (CNAME)（如果有）。如果某个分配没有备用域名，该列表将包含该分配的原始域名。
   + **所有分配** – 此类图表显示与当前 AWS 账户关联的所有分配（不包括已删除的分配）的汇总数据。

1. 选择**更新**。

**提示**  
要查看图表内每日或每小时数据点的数据，请将鼠标指针悬停在相应数据点上。
对于显示所传输的数据的图表，您可以将垂直比例更改为千兆字节、兆字节或千字节。

## 以 CSV 格式下载数据
<a name="cache-statistics-csv"></a>

您可以将缓存统计报告下载为 CSV 格式的文件。本部分将介绍如何下载该报告并详细说明其中的各个值。<a name="cache-statistics-csv-procedure"></a>

**以 CSV 格式下载缓存统计报告**

1. 在查看缓存统计报告时，选择 **CSV**。

1. 在**打开*文件名***对话框中，选择是要打开还是保存文件。

### 该报告的相关信息
<a name="cache-statistics-csv-header"></a>

该报告的前几行包含以下信息：

**版本**  
该 CSV 文件格式的版本。

**报告**  
报告的名称。

**DistributionID**  
您运行报告的分配 ID 或 `ALL`（如果您运行了所有分配的报告）。

**StartDateUTC**  
您运行报告的日期范围的开始日期，采用协调世界时 (UTC)。

**EndDateUTC**  
您运行报告的日期范围的结束日期，采用协调世界时 (UTC)。

**GeneratedTimeUTC**  
您运行报告的日期和时间，采用协调世界时 (UTC)。

**粒度**  
报告中的每一行代表一小时还是一天。

**ViewerLocation**  
查看器请求来自哪个洲或 `ALL` (如果您选择下载所有位置的报告)。

### 缓存统计信息报告中的数据
<a name="cache-statistics-csv-data"></a>

该报告包括以下值：

**DistributionID**  
您运行报告的分配 ID 或 `ALL`（如果您运行了所有分配的报告）。

**FriendlyName**  
分配的备用域名 (CNAME)（如果有）。如果分配没有备用域名，则该列表会包括该分配的原始域名。

**ViewerLocation**  
查看器请求来自哪个洲或 `ALL` (如果您选择下载所有位置的报告)。

**TimeBucket**  
数据适用的小时或天，采用协调世界时 (UTC)。

**RequestCount**  
所有 HTTP 状态代码 (例如，200 或 404) 及所有方法 (例如，GET、HEAD 或 POST) 的请求总数。

**HitCount**  
从 CloudFront 边缘缓存内为其提供对象的查看器请求数。

**MissCount**  
对象目前不在边缘缓存中，因此 CloudFront 必须从源获取对象的查看器请求数。

**错误计数**  
导致错误，因此 CloudFront 未提供对象的查看器请求数。

**IncompleteDownloadCount**  
查看器已启动但未完成对象下载的查看器请求数。

**HTTP2xx**  
HTTP 状态代码为 2xx 值（已成功）的查看器请求数。

**HTTP3xx**  
HTTP 状态代码为 3xx 值（要求执行其他操作）的查看器请求数。

**HTTP4xx**  
HTTP 状态代码为 4xx 值（客户端错误）的查看器请求数。

**HTTP5xx**  
HTTP 状态代码为 5xx 值 (服务器错误) 的查看器请求数。

**TotalBytes**  
CloudFront 为响应所有 HTTP 方法的所有请求而提供给查看器的字节总数。

**BytesFromMisses**  
对于在收到请求时不在边缘缓存中的对象，向查看器提供的字节数。该值与从源传输到 CloudFront 边缘缓存的字节数非常近似。但是，它不包括已存在于边缘缓存中但已过期的对象请求数。

## 缓存统计图与 CloudFront 标准日志（访问日志）中数据的相关度
<a name="cache-statistics-data"></a>

下表显示了 CloudFront 控制台中的缓存统计图与 CloudFront 访问日志中值的对应情况。有关 CloudFront 访问日志的更多信息，请参阅[访问日志（标准日志）](AccessLogs.md)。

**请求总数**  
该图表显示了所有 HTTP 状态代码 (例如，200 或 404) 及所有方法 (例如，`GET`、`HEAD` 或 `POST`) 的请求总数。该图表中显示的请求总数与同一时间段内访问日志文件的请求总数相等。

**查看器请求所占的百分比（按结果类型划分）**  
该图表显示了所选 CloudFront 分配的命中数、未命中数和错误数占查看器请求总数的百分比：  
+ **命中** – 从 CloudFront 边缘缓存中为其提供对象的查看器请求。在访问日志中，此类请求的 `x-edge-response-result-type` 值为 `Hit`。
+ **未命中** – 对象目前没有位于边缘缓存中，因此，CloudFront 必须从源中获取对象的查看器请求。在访问日志中，此类请求的 `x-edge-response-result-type` 值为 `Miss`。
+ **错误** – 查看器请求导致错误，因此，CloudFront 未提供该对象。在访问日志中，此类请求的 `x-edge-response-result-type` 值为 `Error`、`LimitExceeded` 或 `CapacityExceeded`。
该图表不包括刷新命中 – 在边缘缓存中但已过期的对象的请求。在访问日志中，刷新命中是指 `x-edge-response-result-type` 值为 `RefreshHit` 的请求。

**传输到查看器的字节数**  
该图表显示以下两个值：  
+ **总字节数** – CloudFront 为响应所有 HTTP 方法的所有请求而提供给查看器的总字节数。在 CloudFront 访问日志中，**总字节数**是同一时间段内所有请求的 `sc-bytes` 列中的值之和。
+ **未命中的字节数** – 对于在收到请求时不在边缘缓存中的对象，向查看器提供的字节数。在 CloudFront 访问日志中，**未命中的字节数**是 `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) 表示源服务器当前不可用。

**未完成下载的 GET 请求所占的百分比**  
该图表显示了未完成所请求对象下载的查看器 `GET` 请求数占总请求数的百分比。通常，对象下载未完成是因为查看器取消了下载，例如，通过单击其他链接或关闭浏览器。在 CloudFront 访问日志中，此类请求在 `200` 列中具有 `sc-status` 值，在 `Error` 列中具有 `x-edge-result-type` 值。

# 查看 CloudFront 常用对象报告
<a name="popular-objects-report"></a>

查看 Amazon CloudFront 常用对象报告，以便查看在过去 60 天中指定日期范围内分配的 50 个最常用对象。您还可以查看有关这些对象的统计数据，包括以下信息：
+ 对象的请求数
+ 命中和未命中次数
+ 命中率
+ 为未命中提供的字节数
+ 提供的总字节数
+ 未完成下载次数
+ 按 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 管理控制台，并通过以下网址打开 CloudFront 控制台：[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home)。

1. 在导航窗格中，单击**常用对象**。

1. 在 **CloudFront 常用对象报告**窗格中，对于**开始日期**和**结束日期**，请选择您要显示常用对象列表的日期范围。您可以选择前 60 天内的任何日期范围。

   日期和时间采用协调世界时 (UTC)。

1. 在**分配**列表中，选择要显示常用对象列表的分配。

1. 选择**更新**。

## CloudFront 如何计算常用对象统计数据
<a name="popular-objects-calculate"></a>

为了获取您的分配中前 50 个对象的准确计数，CloudFront 会从午夜开始，以 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. 在**打开*文件名***对话框中，选择是要打开还是保存文件。

### 该报告的相关信息
<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**  
CloudFront 为响应所有 HTTP 方法的所有此类对象请求而提供给查看器的字节总数。

**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` 请求数密切对应。

**命中数**  
从 CloudFront 边缘缓存提供对象的查看器请求数。在访问日志中，此类请求的 `x-edge-response-result-type` 值为 `Hit`。

**未命中数**  
对象不在边缘缓存中，因此 CloudFront 从源中检索了对象的查看器请求数。在访问日志中，此类请求的 `x-edge-response-result-type` 值为 `Miss`。

**命中率**  
**Hits** 列中的值占 **Requests** 列中值的百分比。

**未命中的字节数**  
对于在收到请求时不在边缘缓存中的对象，向查看器提供的字节数。在 CloudFront 访问日志中，**未命中的字节数**是 `sc-bytes` 值为 `x-edge-result-type` 的请求的 `Miss` 列中的值之和。

**总字节数**  
CloudFront 为响应所有 HTTP 方法的所有对象请求而提供给查看器的总字节数。在 CloudFront 访问日志中，**总字节数**是同一时间段内所有请求的 `sc-bytes` 列中的值之和。

**未完成的下载数量**  
未完成所请求对象下载的查看器请求数。通常，下载未完成是因为查看器取消了下载，例如，通过单击其他链接或关闭浏览器。在 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) 表示源服务器当前不可用。

# 查看 CloudFront 常用引用站点报告
<a name="top-referrers-report"></a>

CloudFront 常用引用站点报告包含过去 60 天内任何日期范围内的以下信息：
+ 前 25 个引用站点（针对 CloudFront 为您的分配分发的对象，发起最多 HTTP和 HTTPS 请求的网站域）
+ 来自引用站点的请求数
+ 引用站点在指定时间段内提交的请求数占总请求数的百分比

常用引用站点报告数据与 CloudFront 访问日志来自同一来源。但是，您无需启用[访问日志记录](AccessLogs.md)即可查看常用引用站点。

常用引用站点可以是搜索引擎、直接链接到您的对象的其他网站或者您自己的网站。例如，如果 `https://example.com/index.html` 链接到 10 个图形，则 `example.com` 是所有 10 个图形的引用站点。

**注意**  
如果用户直接在浏览器地址栏中输入 URL，则所请求的对象就不存在引用站点。

**Topics**
+ [在控制台中查看 CloudFront 常用引用站点报告](#top-referrers-howto)
+ [CloudFront 如何计算常用引用站点统计数据](#top-referrers-calculate)
+ [以 CSV 格式下载数据](#top-referrers-csv)
+ [常用引用站点报告中的数据与 CloudFront 标准日志（访问日志）中数据的相关度](#top-referrers-data)

## 在控制台中查看 CloudFront 常用引用站点报告
<a name="top-referrers-howto"></a>

您可以在控制台中查看 CloudFront 常用引用站点报告。<a name="top-referrers-report-procedure"></a>

**查看 CloudFront 分配的常用引用站点**

1. 登录 AWS 管理控制台，并通过以下网址打开 CloudFront 控制台：[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home)。

1. 在导航窗格中，选择**常用引用站点**。

1. 在 **CloudFront 常用引用站点报告**窗格中，对于**开始日期**和**结束日期**，请选择您要显示常用引用站点列表的日期范围。

   日期和时间采用协调世界时 (UTC)。

1. 在**分配**列表中，选择要显示常用引用站点列表的分配。

1. 选择**更新**。

## CloudFront 如何计算常用引用站点统计数据
<a name="top-referrers-calculate"></a>

为了获取前 25 个引用站点的准确计数，CloudFront 会以 10 分钟为间隔来统计所有对象的请求，并维持前 75 个引用站点的汇总。在列表底部附近，不断有引用站点进入或跌出该列表，因此，这些引用站点的总数为近似值。

在 75 个引用站点列表中，前面的 25 个引用站点可能会在列表内上升或下降，但很少会跌出列表，因此，这些引用站点的总计通常会更可靠。

## 以 CSV 格式下载数据
<a name="top-referrers-csv"></a>

您可以将常用引用站点报告下载为 CSV 格式的文件。本部分将介绍如何下载该报告并详细说明其中的各个值。<a name="top-referrers-csv-procedure"></a>

**将常用引用站点报告下载为 CSV 格式的文件**

1. 在查看常用引用站点报告时，选择 **CSV**。

1. 在**打开*文件名***对话框中，选择是要打开还是保存文件。

### 该报告的相关信息
<a name="top-referrers-csv-header"></a>

该报告的前几行包含以下信息：

**版本**  
该 CSV 文件格式的版本。

**报告**  
报告的名称。

**DistributionID**  
您运行报告的分配 ID 或 `ALL`（如果您运行了所有分配的报告）。

**StartDateUTC**  
您运行报告的日期范围的开始日期，采用协调世界时 (UTC)。

**EndDateUTC**  
您运行报告的日期范围的结束日期，采用协调世界时 (UTC)。

**GeneratedTimeUTC**  
您运行报告的日期和时间，采用协调世界时 (UTC)。

### 常用引用站点报告中的数据
<a name="top-referrers-csv-data"></a>

该报告包括以下值：

**DistributionID**  
您运行报告的分配 ID 或 `ALL`（如果您运行了所有分配的报告）。

**FriendlyName**  
分配的备用域名 (CNAME)（如果有）。如果分配没有备用域名，则该列表会包括该分配的原始域名。

**引用站点**  
引用站点的域名。

**RequestCount**  
从 `Referrer` 列中的域名发出的请求总数。

**RequestsPct**  
引用站点在指定时间段内提交的请求数占总请求数的百分比。

## 常用引用站点报告中的数据与 CloudFront 标准日志（访问日志）中数据的相关度
<a name="top-referrers-data"></a>

以下列表显示了 CloudFront 控制台中常用引用站点报告的值与 CloudFront 访问日志中值的对应情况。有关 CloudFront 访问日志的更多信息，请参阅[访问日志（标准日志）](AccessLogs.md)。

**引用站点**  
引用站点的域名。在访问日志中，引用站点显示在 `cs(Referer)` 列中。

**请求计数**  
从 **Referrer** 列中的域名发出的请求总数。该值通常与 CloudFront 访问日志中引用站点的 `GET` 请求数密切对应。

**请求 %**  
引用站点在指定时间段内提交的请求数占总请求数的百分比。如果您的引用站点超过 25 个，则您无法根据本表中的数据计算**请求 %**，因为**请求计数**列不包括指定时间段内的所有请求数。

# 查看 CloudFront 使用情况报告
<a name="usage-charts"></a>

CloudFront 使用情况报告包括以下信息：
+ **请求数** – 显示在指定的 CloudFront 分配的每个时间间隔内，CloudFront 响应来自选定区域中的边缘站点的请求总数。
+ **按协议划分的已传输数据**和**按目的地划分的已传输数据** – 显示在指定的 CloudFront 分配的每个时间间隔内，从选定区域中的 CloudFront 边缘站点传输的数据总量。它们以不同的方式分隔数据，如下所示：
  + **按协议** – 按协议分隔数据：HTTP 或 HTTPS。
  + **按目的地** – 按目的地分隔数据：分隔到您的查看器或源。

CloudFront 使用情况报告基于 CloudFront 的 AWS 使用情况报告。此报告不需要任何额外的配置。有关更多信息，请参阅 [查看 CloudFront 的AWS使用情况报告](reports-billing.md#usage-report)。

您可以查看过去 60 天内指定日期范围的图表，将每小时或每天作为数据点。通常，您可以查看 CloudFront 在 4 小时前收到的最新请求的相关数据，但数据偶尔会延迟（长达 24 小时）。

有关更多信息，请参阅 [使用率图表与 CloudFront 使用率报告中的数据的相关度](#usage-charts-table)。

**Topics**
+ [在控制台中查看 CloudFront 使用情况报告](#usage-charts-howto)
+ [以 CSV 格式下载数据](#usage-csv)
+ [使用率图表与 CloudFront 使用率报告中的数据的相关度](#usage-charts-table)

## 在控制台中查看 CloudFront 使用情况报告
<a name="usage-charts-howto"></a>

您可以在控制台中查看 CloudFront 使用情况报告。<a name="usage-charts-procedure"></a>

**查看 CloudFront 使用情况报告**

1. 登录 AWS 管理控制台，并通过以下网址打开 CloudFront 控制台：[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home)。

1. 在导航窗格中，选择**使用情况报告**。

1. 在 **CloudFront 使用情况报告**窗格中，对于**开始日期**和**结束日期**，请选择您要显示使用情况图表的日期范围。可用的范围取决于您为**粒度**选择的值：
   + **每天** – 要显示每天一个数据点的图表，请选择前 60 天内的任何日期范围。
   + **每小时** – 要显示每小时一个数据点的图表，请选择前 60 天内的最多 14 天的任何日期范围。

   日期和时间采用协调世界时 (UTC)。

1. 对于**粒度**，请指定在图表中是每天显示一个数据点还是每小时显示一个数据点。如果您指定大于 14 天的日期范围，则指定每小时一个数据点的选项不可用。

1. 对于**账单区域**，请选择包含您要查看的数据的 CloudFront 账单区域，或选择**所有区域**。使用情况图表包含 CloudFront 处理的指定区域中边缘站点的请求数据。CloudFront 处理请求的区域不一定与您的查看器的位置对应。

   请仅选择包含在分配的价格级别中的区域。否则，使用情况图表可能不会包含任何数据。例如，如果您为分配选择了价格级别 200，则不会包含南美洲和澳大利亚账单区域，因此 CloudFront 一般不会处理您来自这些区域的请求。有关定价级别的更多信息，请参阅 [CloudFront 定价](https://aws.amazon.com/cloudfront/pricing/)。

1. 在**分配**列表中，选择您要在使用情况图表中显示数据的分配：
   + **单个分配** — 此类图表显示选定的 CloudFront Web 分配的数据。**分配**列表显示分配 ID 和分配的备用域名 (CNAME)（如果有）。如果某个分配没有备用域名，该列表将包含该分配的原始域名。
   + **所有分配（不含已删除的分配）** – 此类图表显示与当前AWS账户关联的所有分配（不包括您已删除的分配）的汇总数据。
   + **所有删除的分配** – 此类图表显示与当前AWS账户关联但已在过去 60 天内删除的所有分配的汇总数据。

1. 选择**更新图表**。

**提示**  
要查看图表内每日或每小时数据点的数据，请将鼠标指针悬停在相应数据点上。
对于显示所传输的数据的图表，请注意，您可以将垂直比例更改为千兆字节、兆字节或千字节。

## 以 CSV 格式下载数据
<a name="usage-csv"></a>

您可以下载 CSV 格式的使用情况报告。本部分将介绍如何下载该报告并详细说明其中的各个值。<a name="usage-csv-procedure"></a>

**下载 CSV 格式的使用情况报告**

1. 在查看使用情况报告时，选择 **CSV**。

1. 在**打开*文件名***对话框中，选择是要打开还是保存文件。

### 该报告的相关信息
<a name="usage-csv-header"></a>

该报告的前几行包含以下信息：

**版本**  
该 CSV 文件格式的版本。

**报告**  
报告的名称。

**DistributionID**  
您运行报告的分配 ID、`ALL` (如果您运行了所有分配的报告) 或 `ALL_DELETED` (如果您运行了所有已删除的分配的报告)。

**StartDateUTC**  
您运行报告的日期范围的开始日期，采用协调世界时 (UTC)。

**EndDateUTC**  
您运行报告的日期范围的结束日期，采用协调世界时 (UTC)。

**GeneratedTimeUTC**  
您运行报告的日期和时间，采用协调世界时 (UTC)。

**粒度**  
报告中的每一行代表一小时还是一天。

**BillingRegion**  
查看器请求来自哪个洲或 `ALL` (如果您选择下载所有账单区域的报告)。

### 使用情况报告中的数据
<a name="usage-csv-data"></a>

该报告包括以下值：

**DistributionID**  
您运行报告的分配 ID、`ALL` (如果您运行了所有分配的报告) 或 `ALL_DELETED` (如果您运行了所有已删除的分配的报告)。

**FriendlyName**  
分配的备用域名 (CNAME)（如果有）。如果分配没有备用域名，则该列表会包括该分配的原始域名。

**BillingRegion**  
您运行报告的 CloudFront 账单区域或 `ALL`。

**TimeBucket**  
数据适用的小时或天，采用协调世界时 (UTC)。

**HTTP**  
在指定 CloudFront 分配的每个时间间隔内，CloudFront 响应从所选区域中边缘站点发出的 HTTP 请求数。值包括：  
+ `GET` 和 `HEAD` 请求数，这些请求促使 CloudFront 将数据传输给您的查看器
+ `DELETE`、`OPTIONS`、`PATCH`、`POST` 和 `PUT` 请求数，这些请求促使 CloudFront 将数据传输给您的源

**HTTPS**  
在指定 CloudFront 分配的每个时间间隔内，CloudFront 响应从所选区域中边缘站点发出的 HTTPS 请求数。值包括：  
+ `GET` 和 `HEAD` 请求数，这些请求促使 CloudFront 将数据传输给您的查看器
+ `DELETE`、`OPTIONS`、`PATCH`、`POST` 和 `PUT` 请求数，这些请求促使 CloudFront 将数据传输给您的源

**HTTPBytes**  
在指定 CloudFront 分配的时间段内，从所选账单区域中的 CloudFront 边缘站点通过 HTTP 传输的数据总量。值包括：  
+ 为响应 `GET` 和 `HEAD` 请求而从 CloudFront 传输到查看器的数据
+ `DELETE`、`OPTIONS`、`PATCH`、`POST` 和 `PUT` 请求从查看器传输到 CloudFront 的数据
+ 为响应 `DELETE`、`OPTIONS`、`PATCH`、`POST` 和 `PUT` 请求而从 CloudFront 传输到查看器的数据

**HTTPSBytes**  
在指定 CloudFront 分配的时间段内，从所选账单区域中的 CloudFront 边缘站点通过 HTTPS 传输的数据总量。值包括：  
+ 为响应 `GET` 和 `HEAD` 请求而从 CloudFront 传输到查看器的数据
+ `DELETE`、`OPTIONS`、`PATCH`、`POST` 和 `PUT` 请求从查看器传输到 CloudFront 的数据
+ 为响应 `DELETE`、`OPTIONS`、`PATCH`、`POST` 和 `PUT` 请求而从 CloudFront 传输到查看器的数据

**BytesIn**  
在指定 CloudFront 分配的每个时间间隔内，为响应所选区域中的 `DELETE`、`OPTIONS`、`PATCH`、`POST` 和 `PUT` 请求而从 CloudFront 传输给源的数据总量。

**BytesOut**  
在指定 CloudFront 分配的每个时间间隔内，通过 HTTP 和 HTTPS 在所选区域中从 CloudFront 传输给查看器的数据总量。值包括：  
+ 为响应 `GET` 和 `HEAD` 请求而从 CloudFront 传输到查看器的数据
+ 为响应 `DELETE`、`OPTIONS`、`PATCH`、`POST` 和 `PUT` 请求而从 CloudFront 传输到查看器的数据

## 使用率图表与 CloudFront 使用率报告中的数据的相关度
<a name="usage-charts-table"></a>

以下列表显示了 CloudFront 控制台中的使用率图表与 CloudFront 使用率报告中**使用类型**列内各值的对应情况。

**Topics**
+ [请求数](#usage-charts-requests)
+ [按协议划分的已传输数据](#usage-charts-data-transferred-by-protocol)
+ [按目的地划分的已传输数据](#usage-charts-data-transferred-by-destination)

### 请求数
<a name="usage-charts-requests"></a>

此图表显示了在指定的 CloudFront 分配的每个时间间隔期间从所选区域的边缘站点 CloudFront 响应的请求总数，这些请求按协议（HTTP 或 HTTPS）和类型（静态、动态或代理）分隔。

**HTTP 请求的数量**  
+ *region***-Requests-HTTP-Static：**为 TTL ≥ 3600 秒的对象提供的 HTTP `GET` 和 `HEAD` 请求数
+ *region***-Requests-HTTP-Dynamic**：为 TTL < 3600 秒的对象提供的 HTTP `GET` 和 `HEAD` 请求数
+ *region***-Requests-HTTP-Proxy：**CloudFront 转发到源的 HTTP `DELETE`、`OPTIONS`、`PATCH`、`POST` 和 `PUT` 请求数

**HTTPS 请求的数量**  
+ *region***-Requests-HTTPS-Static：**为 TTL ≥ 3600 秒的对象提供的 HTTPS `GET` 和 `HEAD` 请求数
+ *region***-Requests-HTTPS-Dynamic：**为 TTL < 3600 秒的对象提供的 HTTPS `GET` 和 `HEAD` 请求数
+ *region***-Requests-HTTPS-Proxy：**CloudFront 转发到源的 HTTPS `DELETE`、`OPTIONS`、`PATCH`、`POST` 和 `PUT` 请求数

### 按协议划分的已传输数据
<a name="usage-charts-data-transferred-by-protocol"></a>

此图表显示在指定的 CloudFront 分配的每个时间间隔期间，从所选区域的 CloudFront 边缘站点传输的数据总量，这些数据按协议（HTTP 或 HTTPS）、类型（静态、动态或代理）和目的地（查看器或源）分隔。

**通过 HTTP 传输的数据**  
+ *region***-Out-Bytes-HTTP-Static：**通过 HTTP 为 TTL ≥ 3600 秒的对象提供的字节数
+ *region***-Out-Bytes-HTTP-Dynamic：**通过 HTTP 为 TTL < 3600 秒的对象提供的字节数
+ *region***-Out-Bytes-HTTP-Proxy：**为响应 `DELETE`、`OPTIONS`、`PATCH`、`POST` 和 `PUT` 请求而通过 HTTP 从 CloudFront 返回到查看器的字节数
+ *region***-Out-OBytes-HTTP-Proxy：**为响应 `DELETE`、`OPTIONS`、`PATCH`、`POST` 和 `PUT` 请求而通过 HTTP 从 CloudFront 边缘站点传输到源的字节总数

**通过 HTTPS 传输的数据**  
+ *region***-Out-Bytes-HTTPS-Static：**通过 HTTPS 为 TTL ≥ 3600 秒的对象提供的字节数
+ *region***-Out-Bytes-HTTPS-Dynamic：**通过 HTTPS 为 TTL < 3600 秒的对象提供的字节数
+ *region***-Out-Bytes-HTTPS-Proxy：**为响应 `DELETE`、`OPTIONS`、`PATCH`、`POST` 和 `PUT` 请求而通过 HTTPS 从 CloudFront 返回到查看器的字节数
+ *region***-Out-OBytes-HTTPS-Proxy：**为响应 `DELETE`、`OPTIONS`、`PATCH`、`POST` 和 `PUT` 请求而通过 HTTPS 从 CloudFront 边缘站点传输到源的字节总数

### 按目的地划分的已传输数据
<a name="usage-charts-data-transferred-by-destination"></a>

此图表显示在指定的 CloudFront 分配的每个时间间隔期间，从所选区域的 CloudFront 边缘站点传输的数据总量，这些数据按目的地（查看器或源）、协议（HTTP 或 HTTPS）和类型（静态、动态或代理）分隔。

**从 CloudFront 传输到您的查看器的数据**  
+ *region***-Out-Bytes-HTTP-Static：**通过 HTTP 为 TTL ≥ 3600 秒的对象提供的字节数
+ *region***-Out-Bytes-HTTPS-Static：**通过 HTTPS 为 TTL ≥ 3600 秒的对象提供的字节数
+ *region***-Out-Bytes-HTTP-Dynamic：**通过 HTTP 为 TTL < 3600 秒的对象提供的字节数
+ *region***-Out-Bytes-HTTPS-Dynamic：**通过 HTTPS 为 TTL < 3600 秒的对象提供的字节数
+ *region***-Out-Bytes-HTTP-Proxy：**为响应 `DELETE`、`OPTIONS`、`PATCH`、`POST` 和 `PUT` 请求而通过 HTTP 从 CloudFront 返回到查看器的字节数
+ *region***-Out-Bytes-HTTPS-Proxy：**为响应 `DELETE`、`OPTIONS`、`PATCH`、`POST` 和 `PUT` 请求而通过 HTTPS 从 CloudFront 返回到查看器的字节数

**从 CloudFront 传输到您的源的数据**  
+ *region***-Out-OBytes-HTTP-Proxy：**为响应 `DELETE`、`OPTIONS`、`PATCH`、`POST` 和 `PUT` 请求而通过 HTTP 从 CloudFront 边缘站点传输到源的字节总数
+ *region***-Out-OBytes-HTTPS-Proxy：**为响应 `DELETE`、`OPTIONS`、`PATCH`、`POST` 和 `PUT` 请求而通过 HTTPS 从 CloudFront 边缘站点传输到源的字节总数

# 查看 CloudFront 查看器报告
<a name="viewers-reports"></a>

CloudFront 查看器报告包含过去 60 天内任何日期范围的以下信息：
+ **设备** – 最常用于访问内容的设备类型（例如台式机或移动设备）
+ **浏览器** – 最常用于访问您的内容的十大浏览器（例如 Chrome 或 Firefox）
+ **操作系统** – 访问内容时最常使用的十大操作系统（例如 Linux、macOS 或 Windows）
+ **位置** – 最常访问您的内容的查看器所在的前 50 个位置（国家/地区或省市/地区）。
  + 您还可以查看过去 60 天内任何日期范围（最长 14 天）的每小时数据点的位置

**注意**  
您无需启用[访问日志记录](AccessLogs.md)即可查看查看器图表和报告。

**Topics**
+ [在控制台中查看查看器图表和报告](#viewers-reports-displaying)
+ [以 CSV 格式下载数据](#viewer-csv)
+ [查看器报告中包含的数据](#viewer-csv-header)
+ [位置报告中的数据与 CloudFront 标准日志（访问日志）中数据的相关度](#viewers-reports-data)

## 在控制台中查看查看器图表和报告
<a name="viewers-reports-displaying"></a>

您可以在控制台中查看 CloudFront 查看器图表和报告。<a name="viewers-reports-procedure"></a>

**查看 CloudFront 查看器图表和报告**

1. 登录 AWS 管理控制台，并通过以下网址打开 CloudFront 控制台：[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home)。

1. 在导航窗格中，选择**查看器**。

1. 在 **CloudFront 查看器**窗格中，对于**开始日期**和**结束日期**，请选择您要显示查看器图表和报告的日期范围。

   对于位置图表，可用范围取决于您为**粒度**选择的值：
   + **每天** – 要显示每天一个数据点的图表，请选择前 60 天内的任何日期范围。
   + **每小时** – 要显示每小时一个数据点的图表，请选择前 60 天内的最多 14 天的任何日期范围。

   日期和时间采用协调世界时 (UTC)。

1. （仅限于浏览器和操作系统图表）对于**分组**，请指定您是要按名称 (Chrome、Firefox) 还是按名称和版本 (Chrome 40.0、Firefox 35.0) 对浏览器及操作系统分组。

1. （仅限于位置图表）对于**粒度**，请指定在图表中是将每天显示为一个数据点还是将每小时显示为一个数据点。如果您指定大于 14 天的日期范围，则指定每小时一个数据点的选项不可用。

1. （仅限于位置图表）对于**详细信息**，请指定是按国家/地区还是按美国各州来显示主要位置。

1. 在**分配**列表中，选择您要在使用情况图表中显示数据的分配：
   + **单个分配** – 此类图表显示选定的 CloudFront Web 分配的数据。**分配**列表显示分配 ID 和分配的备用域名 (CNAME)（如果有）。如果分配没有备用域名，则该列表会包括该分配的原始域名。
   + **所有分配（不含已删除的分配）** – 此类图表显示与当前AWS账户关联的所有分配（不包括您已删除的分配）的汇总数据。

1. 选择**更新**。

要查看图表内每日或每小时数据点的数据，请将鼠标指针悬停在相应数据点上。

## 以 CSV 格式下载数据
<a name="viewer-csv"></a>

您可以将每个查看器报告下载为 CSV 格式的文件。本部分将介绍如何下载此类报告并详细说明其中的各个值。<a name="viewer-csv-procedure"></a>

**将查看器报告下载为 CSV 格式的文件**

1. 在查看查看器报告时，选择 **CSV**。

1. 选择您要下载的数据，例如，**Devices** 或 **Devices Trends**。

1. 在**打开 *文件名***对话框中，选择是要打开还是保存文件。

## 查看器报告中包含的数据
<a name="viewer-csv-header"></a>

每个报告的前几行都包含以下信息：

**版本**  
该 CSV 文件格式的版本。

**报告**  
报告的名称。

**DistributionID**  
您运行报告的分配 ID 或 `ALL`（如果您运行了所有分配的报告）。

**StartDateUTC**  
您运行报告的日期范围的开始日期，采用协调世界时 (UTC)。

**EndDateUTC**  
您运行报告的日期范围的结束日期，采用协调世界时 (UTC)。

**GeneratedTimeUTC**  
您运行报告的日期和时间，采用协调世界时 (UTC)。

**分组（仅限于浏览器和操作系统报告）**  
是按浏览器或操作系统的名称还是按名称和版本对数据分组。

**粒度**  
报告中的每一行代表一小时还是一天。

**详细信息（仅限于位置报告）**  
是按国家/地区还是按美国各州来列出请求。

以下主题介绍不同查看器报告中的信息。

**Topics**
+ [设备报告](#viewer-devices-csv-data)
+ [设备趋势报告](#viewer-device-trends-csv-data)
+ [浏览器报告](#viewer-browsers-csv-data)
+ [浏览器趋势报告](#viewer-browser-trends-csv-data)
+ [操作系统报告](#viewer-operating-system-csv-data)
+ [操作系统趋势报告](#viewer-operating-system-trends-csv-data)
+ [位置报告](#viewer-locations-csv-data)
+ [位置趋势报告](#viewer-location-trends-csv-data)

### 设备报告
<a name="viewer-devices-csv-data"></a>

该报告包括以下值：

**DistributionID**  
您运行报告的分配 ID 或 `ALL`（如果您运行了所有分配的报告）。

**FriendlyName**  
分配的备用域名 (CNAME)（如果有）。如果分配没有备用域名，则该列表会包括该分配的原始域名。

**请求**  
CloudFront 从各类设备收到的请求数。

**RequestsPct**  
CloudFront 从各类设备收到的请求数占 CloudFront 从所有设备收到的总请求数的百分比。

**自定义**  
`User-Agent` HTTP 标头值未与其中一个标准设备类型（例如，`Desktop` 或 `Mobile`）关联的请求。

### 设备趋势报告
<a name="viewer-device-trends-csv-data"></a>

该报告包括以下值：

**DistributionID**  
您运行报告的分配 ID 或 `ALL`（如果您运行了所有分配的报告）。

**FriendlyName**  
分配的备用域名 (CNAME)（如果有）。如果分配没有备用域名，则该列表会包括该分配的原始域名。

**TimeBucket**  
数据适用的小时或天，采用协调世界时 (UTC)。

**桌面**  
CloudFront 在相应时间段内从台式计算机收到的请求数。

**移动**  
CloudFront 在相应时间段内从移动设备收到的请求数。移动设备可以同时包括平板电脑和手机。如果 CloudFront 无法确定请求是来自移动设备还是平板电脑，则会将此类请求显示在 `Mobile` 列中。

**智能电视**  
CloudFront 在相应时间段内从智能电视收到的请求数。

**平板电脑**  
CloudFront 在相应时间段内从平板电脑收到的请求数。如果 CloudFront 无法确定请求是来自移动设备还是平板电脑，则会将此类请求显示在 `Mobile` 列中。

**Unknown**  
`User-Agent` HTTP 标头值未与其中一个标准设备类型（例如，`Desktop` 或 `Mobile`）关联的请求。

**Empty**  
CloudFront 在相应时间段内收到但不包含 HTTP `User-Agent` 标头值的请求数。

### 浏览器报告
<a name="viewer-browsers-csv-data"></a>

该报告包括以下值：

**DistributionID**  
您运行报告的分配 ID 或 `ALL`（如果您运行了所有分配的报告）。

**FriendlyName**  
分配的备用域名 (CNAME)（如果有）。如果分配没有备用域名，则该列表会包括该分配的原始域名。

**组**  
CloudFront 从中收到请求的浏览器或浏览器和版本，具体取决于 `Grouping` 值。除了浏览器名称外，可能的值还包括以下各项：  
+ **自动程序/爬网程序** – 主要是来自搜索引擎且将内容编入索引的请求。
+ **空** – `User-Agent` HTTP 标头值为空的请求。
+ **其他** – CloudFront 已识别但不属于常见浏览器的浏览器。如果 `Bot/Crawler`、`Empty` 和/或 `Unknown` 不在前 9 个值之列，则系统还会将其显示在 `Other` 中。
+ **未知** – `User-Agent` HTTP 标头值与标准浏览器不关联的请求。该类别中的大多数请求来自自定义应用程序或脚本。

**请求**  
CloudFront 从各类浏览器收到的请求数。

**RequestsPct**  
CloudFront 在相应时间段内从各类浏览器收到的请求数占 CloudFront 收到的总请求数的百分比。

### 浏览器趋势报告
<a name="viewer-browser-trends-csv-data"></a>

该报告包括以下值：

**DistributionID**  
您运行报告的分配 ID 或 `ALL`（如果您运行了所有分配的报告）。

**FriendlyName**  
分配的备用域名 (CNAME)（如果有）。如果分配没有备用域名，则该列表会包括该分配的原始域名。

**TimeBucket**  
数据适用的小时或天，采用协调世界时 (UTC)。

**(浏览器)**  
该报告中的其余列会列出浏览器或浏览器及其版本，具体取决于 `Grouping` 的值。除了浏览器名称外，可能的值还包括以下各项：  
+ **自动程序/爬网程序** – 主要是来自搜索引擎且将内容编入索引的请求。
+ **空** – `User-Agent` HTTP 标头值为空的请求。
+ **其他** – CloudFront 已识别但不属于常见浏览器的浏览器。如果 `Bot/Crawler`、`Empty` 和/或 `Unknown` 不在前 9 个值之列，则系统还会将其显示在 `Other` 中。
+ **未知** – `User-Agent` HTTP 标头值与标准浏览器不关联的请求。该类别中的大多数请求来自自定义应用程序或脚本。

### 操作系统报告
<a name="viewer-operating-system-csv-data"></a>

该报告包括以下值：

**DistributionID**  
您运行报告的分配 ID 或 `ALL`（如果您运行了所有分配的报告）。

**FriendlyName**  
分配的备用域名 (CNAME)（如果有）。如果分配没有备用域名，则该列表会包括该分配的原始域名。

**组**  
CloudFront 从中收到请求的操作系统或操作系统和版本，具体取决于 `Grouping` 值。除了操作系统名称外，可能的值还包括以下各项：  
+ **自动程序/爬网程序** – 主要是来自搜索引擎且将内容编入索引的请求。
+ **空** – `User-Agent` HTTP 标头值为空的请求。
+ **其他** – CloudFront 已识别但不属于常见浏览器的操作系统。如果 `Bot/Crawler`、`Empty` 和/或 `Unknown` 不在前 9 个值之列，则系统还会将其显示在 `Other` 中。
+ **未知** – `User-Agent` HTTP 标头值与标准浏览器不关联的请求。该类别中的大多数请求来自自定义应用程序或脚本。

**请求**  
CloudFront 从各类操作系统收到的请求数。

**RequestsPct**  
CloudFront 在相应时间段内从各类操作系统收到的请求数占 CloudFront 收到的总请求数的百分比。

### 操作系统趋势报告
<a name="viewer-operating-system-trends-csv-data"></a>

该报告包括以下值：

**DistributionID**  
您运行报告的分配 ID 或 `ALL`（如果您运行了所有分配的报告）。

**FriendlyName**  
分配的备用域名 (CNAME)（如果有）。如果分配没有备用域名，则该列表会包括该分配的原始域名。

**TimeBucket**  
数据适用的小时或天，采用协调世界时 (UTC)。

**(操作系统)**  
该报告中的其余列会列出操作系统或操作系统及其版本，具体取决于 `Grouping` 的值。除了操作系统名称外，可能的值还包括以下各项：  
+ **自动程序/爬网程序** – 主要是来自搜索引擎且将内容编入索引的请求。
+ **空** – `User-Agent` HTTP 标头值为空的请求。
+ **其他** – CloudFront 已识别但不属于常见浏览器的操作系统。如果 `Bot/Crawler`、`Empty` 和/或 `Unknown` 不在前 9 个值之列，则系统还会将其显示在 `Other` 中。
+ **未知** – 未在 `User-Agent` HTTP 标头中指定操作系统的请求。

### 位置报告
<a name="viewer-locations-csv-data"></a>

该报告包括以下值：

**DistributionID**  
您运行报告的分配 ID 或 `ALL`（如果您运行了所有分配的报告）。

**FriendlyName**  
分配的备用域名 (CNAME)（如果有）。如果分配没有备用域名，则该列表会包括该分配的原始域名。

**LocationCode**  
CloudFront 从其收到请求的位置缩写。有关可能值的更多信息，请参阅 [位置报告中的数据与 CloudFront 标准日志（访问日志）中数据的相关度](#viewers-reports-data) 中的位置描述。

**LocationName**  
CloudFront 从其收到请求的位置名称。

**请求**  
CloudFront 从每个位置收到的请求数。

**RequestsPct**  
CloudFront 在相应时间段内从各位置收到的请求数占 CloudFront 从所有位置收到的总请求数的百分比。

**TotalBytes**  
针对指定的分配和时间段，CloudFront 提供给该国家/地区或州的查看器的字节数。

### 位置趋势报告
<a name="viewer-location-trends-csv-data"></a>

该报告包括以下值：

**DistributionID**  
您运行报告的分配 ID 或 `ALL`（如果您运行了所有分配的报告）。

**FriendlyName**  
分配的备用域名 (CNAME)（如果有）。如果分配没有备用域名，则该列表会包括该分配的原始域名。

**TimeBucket**  
数据适用的小时或天，采用协调世界时 (UTC)。

**(位置)**  
该报告中的剩余列会列出 CloudFront 从其收到请求的位置。有关可能值的更多信息，请参阅 [位置报告中的数据与 CloudFront 标准日志（访问日志）中数据的相关度](#viewers-reports-data) 中的位置描述。

## 位置报告中的数据与 CloudFront 标准日志（访问日志）中数据的相关度
<a name="viewers-reports-data"></a>

以下列表显示了 CloudFront 控制台中位置报告的数据与 CloudFront 访问日志中值的对应情况。有关 CloudFront 访问日志的更多信息，请参阅[访问日志（标准日志）](AccessLogs.md)。

**位置**  
查看器所在的国家/地区或美国的州。在访问日志中，`c-ip` 列包含运行查看器的设备的 IP 地址。我们使用地理位置数据基于 IP 地址识别设备的地理位置。  
如果您显示按国家/地区划分的 **Locations** 报告，国家/地区列表将基于 [ISO 3166-2，即*国家及其区域名表示代码 – 第 2 部分：国家区域代码*](https://en.wikipedia.org/wiki/ISO_3166-2)。国家/地区列表包括以下其他值：  
+ **匿名代理** – 请求来自匿名代理。
+ **卫星提供商** – 请求来自向多个国家/地区提供 Internet 服务的卫星提供商。查看器可能位于欺诈风险较高的国家/地区。
+ **欧洲（未知）** – 请求来自多个欧洲国家/地区使用的块中的 IP 地址。无法确定请求来自哪个国家/地区。CloudFront 将**欧洲（未知）**用作默认值。
+ **亚太区域（未知）** – 请求来自多个亚太国家/地区使用的块中的 IP 地址。无法确定请求来自哪个国家/地区。CloudFront 将**亚太地区（未知）**用作默认值。
如果您显示按美国各州划分的**位置**报告，请注意，该报告会包括美国领土和美国军事地区。  
如果 CloudFront 无法确定某个用户的位置，该位置将在查看器报告中显示为未知。

**请求计数**  
在指定分配的时间段内，来自查看器所在的国家/地区或美国各州的请求总数。该值通常与 CloudFront 访问日志中来自该国家/地区或州的 IP 地址的 `GET` 请求数密切对应。

**请求 %**  
以下项之一，具体取决于您为**详细信息**选择的值：  
+ **国家/地区** – 来自该国家/地区的请求数占总请求数的百分比。
+ **美国各州** – 来自该州的请求数占来自整个美国的请求总数的百分比。
如果请求来源超过 50 个国家/地区，则您无法根据本表中的数据计算**请求 %**，因为**请求计数**列不包括指定时间段内的所有请求数。

**字节**  
针对指定的分配和时间段，CloudFront 提供给该国家/地区或州的查看器的字节数。要将该列中显示的数据单位更改为 KB、MB 或 GB，请选择列标题中的链接。