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

使用 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 Functions 中)。

此维度仅适用于函数。

Region

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

注意

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

CloudFront 分配指标的值

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

注意

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

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

已下载字节

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

  • Metric name (指标名称):BytesDownloaded

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

  • 单位:None

已上传字节

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

  • Metric name (指标名称):BytesUploaded

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

  • 单位:None

缓存命中率

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

  • 指标名称:CacheHitRate

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

  • 单位:Percent

来源延迟

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

  • 指标名称:OriginLatency

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

  • 单位:Milliseconds

注意

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

请求

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

  • Metric name (指标名称):Requests

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

  • 单位:None

总错误率

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

  • 指标名称:TotalErrorRate

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

  • 单位:Percent

CloudFront 函数指标的值

使用以下列表中的信息从 CloudWatch API 获取有关特定 CloudFront 函数指标的详细信息。

注意

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

调用

给定时间内开始(调用)函数的次数。

  • 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