# 查看 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，请选择列标题中的链接。