使用 CloudWatch API 获取指标 - Amazon CloudFront
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

如果我们为英文版本指南提供翻译,那么如果存在任何冲突,将以英文版本指南为准。在提供翻译时使用机器翻译。

使用 CloudWatch API 获取指标

您可以使用 Amazon CloudWatch API 或 CLI 获取您构建的程序或应用程序中的 CloudFront 指标。您可以使用原始数据构建自己的自定义控制面板、自己的警报工具等。要从 CloudWatch API 中获取 CloudFront 指标,您必须使用 美国东部(弗吉尼亚北部)地区 (us-east-1)。您还需要了解每个指标的特定值和类型。

所有 CloudFront 指标的值

以下值适用于所有 CloudFront 指标:

Namespace

Namespace 的值始终为 AWS/CloudFront

维度

每个 CloudFront 指标都有以下两个维度:

DistributionId

DistributionId 的值是要获取其指标的 CloudFront 分配的 ID。

Region

Region 的值始终是 Global,因为 CloudFront 是全球性服务。

注意

要从 CloudWatch API 中获取 CloudFront 指标,您必须使用 美国东部(弗吉尼亚北部)地区 (us-east-1)。

单个 CloudFront 指标的值

使用以下列表中的信息从 CloudWatch API 获取有关特定 CloudFront 指标的详细信息。仅当您为分配启用了其他指标时,其中某些指标才可用。

注意

每个指标只有一个适用的统计数据 AverageSum。以下列表指定了适用于该指标的统计数据。

4xx 错误率

响应的 HTTP 状态代码为 4xx 的所有查看器请求所占的百分比。

  • Metric name (指标名称):4xxErrorRate

  • Valid statistic (有效统计数据):Average

  • Unit (单位):Percent

401 错误率

响应的 HTTP 状态代码为 401 的所有查看器请求所占的百分比。要获取此指标,您必须首先启用其他指标

  • Metric name (指标名称):401ErrorRate

  • Valid statistic (有效统计数据):Average

  • Unit (单位):Percent

403 错误率

响应的 HTTP 状态代码为 403 的所有查看器请求所占的百分比。要获取此指标,您必须首先启用其他指标

  • Metric name (指标名称):403ErrorRate

  • Valid statistic (有效统计数据):Average

  • Unit (单位):Percent

404 错误率

响应的 HTTP 状态代码为 404 的所有查看器请求所占的百分比。要获取此指标,您必须首先启用其他指标

  • Metric name (指标名称):404ErrorRate

  • Valid statistic (有效统计数据):Average

  • Unit (单位):Percent

5xx 错误率

响应的 HTTP 状态代码为 5xx 的所有查看器请求所占的百分比。

  • Metric name (指标名称):5xxErrorRate

  • Valid statistic (有效统计数据):Average

  • Unit (单位):Percent

502 错误率

响应的 HTTP 状态代码为 502 的所有查看器请求所占的百分比。要获取此指标,您必须首先启用其他指标

  • Metric name (指标名称):502ErrorRate

  • Valid statistic (有效统计数据):Average

  • Unit (单位):Percent

503 错误率

响应的 HTTP 状态代码为 503 的所有查看器请求所占的百分比。要获取此指标,您必须首先启用其他指标

  • Metric name (指标名称):503ErrorRate

  • Valid statistic (有效统计数据):Average

  • Unit (单位):Percent

504 错误率

响应的 HTTP 状态代码为 504 的所有查看器请求所占的百分比。要获取此指标,您必须首先启用其他指标

  • Metric name (指标名称):504ErrorRate

  • Valid statistic (有效统计数据):Average

  • Unit (单位):Percent

已下载字节

查看器针对 GETHEADOPTIONS 请求下载的字节总数。

  • Metric name (指标名称):BytesDownloaded

  • Valid statistic (有效统计数据):Sum

  • Unit (单位):None

已上传字节

查看器通过 CloudFront 使用 POSTPUT 请求上传到您的源的字节总数。

  • Metric name (指标名称):BytesUploaded

  • Valid statistic (有效统计数据):Sum

  • Unit (单位):None

缓存命中率

由 CloudFront 从其缓存提供内容的所有可缓存请求的百分比。HTTP POSTPUT 请求及错误不视为可缓存请求。要获取此指标,您必须首先启用其他指标

  • Metric name (指标名称):CacheHitRate

  • Valid statistic (有效统计数据):Average

  • Unit (单位):Percent

来源延迟

对于从来源提供内容(而非从 CloudFront 缓存提供内容)的请求,从 CloudFront 接收请求,到开始向网络(而非查看器)提供响应为止所花费的总时间(以毫秒为单位)。这也称为首字节延迟time-to-first-byte。要获取此指标,您必须首先启用其他指标

  • Metric name (指标名称):OriginLatency

  • Valid statistic (有效统计数据):Percentile

  • Unit (单位):Milliseconds

注意

要从 CloudWatch API 获取 Percentile 统计信息,请使用 ExtendedStatistics 参数,而不是 Statistics。有关更多信息,请参阅 Amazon CloudWatch API Reference 中的 GetMetricStatistics 或适用于 AWS 开发工具包的参考文档。

请求

针对所有 HTTP 方法以及 HTTP 和 HTTPS 请求,CloudFront 收到的查看器请求总数。

  • Metric name (指标名称):Requests

  • Valid statistic (有效统计数据):Sum

  • Unit (单位):None

总错误率

响应的 HTTP 状态代码为 4xx5xx 的所有查看器请求所占的百分比。

  • Metric name (指标名称):TotalErrorRate

  • Valid statistic (有效统计数据):Average

  • Unit (单位):Percent