本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
使用 CloudWatch API 获取指标
您可以使用 Amazon CloudWatch API 或 CLI 在您构建的程序或应用程序中获取 CloudFront 指标。您可以使用原始数据构建自己的自定义控制面板、自己的警报工具等。
要从 CloudWatch API 获取 CloudFront 指标，您必须使用美国东部（弗吉尼亚北部）区域 (us-east-1)。您还需要了解每个指标的特定值和类型。
所有 CloudFront 指标的值
以下值适用于所有 CloudFront 指标：
Namespace-
Namespace的值始终为AWS/CloudFront。 - 尺寸
-
每个 CloudFront 指标都有以下两个维度：
DistributionId-
您要获取其指标的 CloudFront 分配的 ID。
FunctionName-
要获取其指标的函数（在 “ CloudFront 函数” 中）的名称。
此维度仅适用于函数。
Region-
的价值永远
Region是Global，因为 CloudFront 是一项全球服务。
注意
要从 CloudWatch API 获取 CloudFront 指标，您必须使用美国东部（弗吉尼亚北部）区域 (us-east-1)。
CloudFront分布指标的值
使用以下列表中的信息从 CloudWatch API 获取有关特定 CloudFront 分发指标的详细信息。仅当您为分配启用了其他指标时，其中某些指标才可用。
注意
每个指标只有一个适用的统计数据 Average 或 Sum。以下列表指定了适用于该指标的统计数据。
- 4xx 错误率
-
响应的 HTTP 状态代码为
4xx的所有查看器请求所占的百分比。-
指标名称：
4xxErrorRate -
Valid statistic (有效统计数据)：
Average -
单位：
Percent
-
- 401 错误率
-
响应的 HTTP 状态代码为
401的所有查看器请求所占的百分比。要获取此指标，您必须首先启用其他指标。-
指标名称：
401ErrorRate -
Valid statistic (有效统计数据)：
Average -
单位：
Percent
-
- 403 错误率
-
响应的 HTTP 状态代码为
403的所有查看器请求所占的百分比。要获取此指标，您必须首先启用其他指标。-
指标名称：
403ErrorRate -
Valid statistic (有效统计数据)：
Average -
单位：
Percent
-
- 404 错误率
-
响应的 HTTP 状态代码为
404的所有查看器请求所占的百分比。要获取此指标，您必须首先启用其他指标。-
指标名称：
404ErrorRate -
Valid statistic (有效统计数据)：
Average -
单位：
Percent
-
- 5xx 错误率
-
响应的 HTTP 状态代码为
5xx的所有查看器请求所占的百分比。-
指标名称：
5xxErrorRate -
Valid statistic (有效统计数据)：
Average -
单位：
Percent
-
- 502 错误率
-
响应的 HTTP 状态代码为
502的所有查看器请求所占的百分比。要获取此指标，您必须首先启用其他指标。-
指标名称：
502ErrorRate -
Valid statistic (有效统计数据)：
Average -
单位：
Percent
-
- 503 错误率
-
响应的 HTTP 状态代码为
503的所有查看器请求所占的百分比。要获取此指标，您必须首先启用其他指标。-
指标名称：
503ErrorRate -
Valid statistic (有效统计数据)：
Average -
单位：
Percent
-
- 504 错误率
-
响应的 HTTP 状态代码为
504的所有查看器请求所占的百分比。要获取此指标，您必须首先启用其他指标。-
指标名称：
504ErrorRate -
Valid statistic (有效统计数据)：
Average -
单位：
Percent
-
- 已下载字节
-
查看器针对
GET、HEAD和OPTIONS请求下载的字节总数。-
Metric name (指标名称)：
BytesDownloaded -
Valid statistic (有效统计数据)：
Sum -
单位：
None
-
- 已上传字节
-
查看器通过 CloudFront 使用
POST和PUT请求上传到您的源的字节总数。-
指标名称：
BytesUploaded -
Valid statistic (有效统计数据)：
Sum -
单位：
None
-
- 缓存命中率
-
从其缓存中 CloudFront 提供内容的所有可缓存请求的百分比。HTTP
POST和PUT请求及错误不视为可缓存请求。要获取此指标，您必须首先启用其他指标。-
指标名称：
CacheHitRate -
Valid statistic (有效统计数据)：
Average -
单位：
Percent
-
- 来源延迟
-
从 CloudFront 收到请求到开始向网络（而不是查看者）提供响应所花费的总时间，以毫秒为单位，从源站而不是缓存中处理的请求。 CloudFront 这也称为首字节延迟，或time-to-first-byte。要获取此指标，您必须首先启用其他指标。
-
指标名称：
OriginLatency -
Valid statistic (有效统计数据)：
Percentile -
单位：
Milliseconds
注意
要从 CloudWatch API 获取
Percentile统计数据，请使用ExtendedStatistics参数，而不是Statistics。有关更多信息，请参阅 GetMetricStatisticsAmazon CloudWatch API 参考或Amazon软件开发工具包的参考文档。 -
- 请求
-
针对所有 HTTP 方法以及 HTTP 和 HTTPS 请求接收的查看者请求总数。 CloudFront
-
指标名称：
Requests -
Valid statistic (有效统计数据)：
Sum -
单位：
None
-
- 总错误率
-
响应的 HTTP 状态代码为
4xx或5xx的所有查看器请求所占的百分比。-
指标名称：
TotalErrorRate -
Valid statistic (有效统计数据)：
Average -
单位：
Percent
-
CloudFront 函数指标的值
使用以下列表中的信息从 CloudWatch API 获取有关特定 CloudFront函数指标的详细信息。
注意
每个指标只有一个适用的统计数据 Average 或 Sum。以下列表指定了适用于该指标的统计数据。
- 调用
-
给定时间内开始（调用）函数的次数。
-
Metric name (指标名称)：
FunctionInvocations -
Valid statistic (有效统计数据)：
Sum -
单位：
None
-
- 验证错误
-
函数在给定时间段内产生的验证错误数。当函数成功运行但返回无效数据（无效的事件对象）时，会发生验证错误。
-
Metric name (指标名称)：
FunctionValidationErrors -
Valid statistic (有效统计数据)：
Sum -
单位：
None
-
- 执行错误
-
给定时间内发生的执行错误数。当函数无法成功完成时，会发生执行错误。
-
Metric name (指标名称)：
FunctionExecutionErrors -
Valid statistic (有效统计数据)：
Sum -
单位：
None
-
- 计算利用率
-
函数运行所花费的时间占最大允许时间的百分比 (0-100)。例如，值为 35 表示函数在最大允许时间的 35% 内完成。
-
指标名称：
FunctionComputeUtilization -
Valid statistic (有效统计数据)：
Average -
单位：
Percent
-
- 节流
-
在给定时间段内函数受到限制的次数。
-
指标名称：
FunctionThrottles -
Valid statistic (有效统计数据)：
Sum -
单位：
None
-