使用 Amazon CloudWatch API 获取指标
您可以使用 CloudWatch API 或 Amazon Command Line Interface (Amazon CLI) 在您构建的程序或应用程序中获取 CloudFront 指标。您可以使用原始数据构建自己的自定义控制面板、自己的警报工具等。
有关更多信息，请参阅《Amazon CLI 命令参考》中的 get-metric-data 或《Amazon CloudWatch API 参考》中的 GetMetricData API 操作。
注意
要从 CloudWatch API 获取 CloudFront 指标，您必须使用美国东部（弗吉尼亚州北部）区域 (us-east-1)。您还需要了解每个指标的特定值和类型。
所有 CloudFront 指标的值
以下值适用于所有 CloudFront 指标：
Namespace-
Namespace的值始终为AWS/CloudFront。 - 维度
-
每个 CloudFront 指标都具有以下两个维度：
DistributionId-
要获取其指标的 CloudFront 分配的 ID。
FunctionName-
要获取指标的函数的名称（在 CloudFront Functions 中）。
此维度仅适用于函数。
Region-
Region的值始终是Global，因为 CloudFront 是全球性服务。
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请求上传到您的源的字节总数。-
Metric name (指标名称)：
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。有关更多信息，请参阅 Amazon CloudWatch API 参考中的 GetMetricStatistics 或 Amazon 开发工具包的参考文档。 -
- 请求
-
针对所有 HTTP 方法以及 HTTP 和 HTTPS 请求，CloudFront 收到的查看器请求总数。
-
Metric name (指标名称)：
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
-