# CloudFront 的指标类型
<a name="programming-cloudwatch-metrics"></a>

您可以使用 CloudWatch API 或 Amazon Command Line Interface (Amazon CLI) 在您构建的程序或应用程序中获取 CloudFront 指标。您可以使用原始数据构建自己的自定义控制面板、自己的警报工具等。

有关更多信息，请参阅《Amazon CLI 命令参考》**中的 [get-metric-data](https://docs.amazonaws.cn/cli/latest/reference/cloudwatch/get-metric-data.html) 或《Amazon CloudWatch API 参考》**中的 [GetMetricData](https://docs.amazonaws.cn/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html) API 操作。

**Topics**
+ [

## 所有 CloudFront 指标的值
](#cloudfront-metrics-global-values)
+ [

## CloudFront 分配指标的值
](#cloudfront-metrics-distribution-values)
+ [

## CloudFront 函数指标的值
](#cloudfront-metrics-function-values)

**注意**  
要从 CloudWatch API 获取 CloudFront 指标，您必须使用美国东部（弗吉尼亚州北部）区域 (`us-east-1`)。您还需要了解每个指标的特定值和类型。

## 所有 CloudFront 指标的值
<a name="cloudfront-metrics-global-values"></a>

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

**`Namespace`**  
`Namespace` 的值始终为 `AWS/CloudFront`。

**维度**  
每个 CloudFront 指标都具有以下维度：    
**`DistributionId`**  
要获取其指标的 CloudFront 分配的 ID。  
**`FunctionName`**  
要获取指标的函数的名称（在 CloudFront Functions 中）。  
此维度仅适用于函数。  
**`Region`**  
`Region` 的值始终是 `Global`，因为 CloudFront 是全球性服务。

## CloudFront 分配指标的值
<a name="cloudfront-metrics-distribution-values"></a>

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

**注意**  
每个指标只有一个适用的统计数据 `Average` 或 `Sum`。以下列表指定了适用于该指标的统计数据。

**4xx 错误率**  
响应的 HTTP 状态代码为 `4xx` 的所有查看器请求所占的百分比。  
+ 指标名称：`4xxErrorRate`
+ Valid statistic (有效统计数据)：`Average`
+ 单位：`Percent`

**401 错误率**  
响应的 HTTP 状态代码为 `401` 的所有查看器请求所占的百分比。要获取此指标，您必须首先[启用其他指标](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)。  
+ 指标名称：`401ErrorRate`
+ Valid statistic (有效统计数据)：`Average`
+ 单位：`Percent`

**403 错误率**  
响应的 HTTP 状态代码为 `403` 的所有查看器请求所占的百分比。要获取此指标，您必须首先[启用其他指标](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)。  
+ 指标名称：`403ErrorRate`
+ Valid statistic (有效统计数据)：`Average`
+ 单位：`Percent`

**404 错误率**  
响应的 HTTP 状态代码为 `404` 的所有查看器请求所占的百分比。要获取此指标，您必须首先[启用其他指标](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)。  
+ 指标名称：`404ErrorRate`
+ Valid statistic (有效统计数据)：`Average`
+ 单位：`Percent`

**5xx 错误率**  
响应的 HTTP 状态代码为 `5xx` 的所有查看器请求所占的百分比。  
+ 指标名称：`5xxErrorRate`
+ Valid statistic (有效统计数据)：`Average`
+ 单位：`Percent`

**502 错误率**  
响应的 HTTP 状态代码为 `502` 的所有查看器请求所占的百分比。要获取此指标，您必须首先[启用其他指标](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)。  
+ 指标名称：`502ErrorRate`
+ Valid statistic (有效统计数据)：`Average`
+ 单位：`Percent`

**503 错误率**  
响应的 HTTP 状态代码为 `503` 的所有查看器请求所占的百分比。要获取此指标，您必须首先[启用其他指标](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)。  
+ 指标名称：`503ErrorRate`
+ Valid statistic (有效统计数据)：`Average`
+ 单位：`Percent`

**504 错误率**  
响应的 HTTP 状态代码为 `504` 的所有查看器请求所占的百分比。要获取此指标，您必须首先[启用其他指标](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)。  
+ 指标名称：`504ErrorRate`
+ Valid statistic (有效统计数据)：`Average`
+ 单位：`Percent`

**已下载字节**  
查看器针对 `GET` 和 `HEAD` 请求下载的字节总数。  
+ 指标名称：`BytesDownloaded`
+ Valid statistic (有效统计数据)：`Sum`
+ 单位：`None`

**已上传字节**  
查看器使用 `OPTIONS`、`POST` 和 `PUT` 请求上传到 CloudFront 的字节总数。  
+ 指标名称：`BytesUploaded`
+ Valid statistic (有效统计数据)：`Sum`
+ 单位：`None`

**缓存命中率**  
由 CloudFront 从其缓存提供内容的所有可缓存请求的百分比。HTTP `POST` 和 `PUT` 请求及错误不视为可缓存请求。要获取此指标，您必须首先[启用其他指标](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)。  
+ 指标名称：`CacheHitRate`
+ Valid statistic (有效统计数据)：`Average`
+ 单位：`Percent`

**来源延迟**  
对于从来源提供内容（而非从 CloudFront 缓存提供内容）的请求，从 CloudFront 接收请求，到开始向网络（而非查看器）提供响应为止所花费的总时间（以毫秒为单位）。这也称为*首字节延迟*或 *time-to-first-byte*。要获取此指标，您必须首先[启用其他指标](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)。  
+ 指标名称：`OriginLatency`
+ Valid statistic (有效统计数据)：`Percentile`
+ 单位：`Milliseconds`
要从 CloudWatch API 获取 `Percentile` 统计信息，请使用 `ExtendedStatistics` 参数，而不是 `Statistics`。有关更多信息，请参阅 *Amazon CloudWatch API 参考*中的 [GetMetricStatistics](https://docs.amazonaws.cn/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html) 或 [Amazon 开发工具包](https://docs.amazonaws.cn/#sdks)的参考文档。

**请求**  
针对所有 HTTP 方法以及 HTTP 和 HTTPS 请求，CloudFront 收到的查看器请求总数。  
+ Metric name (指标名称)：`Requests`
+ Valid statistic (有效统计数据)：`Sum`
+ 单位：`None`

**总错误率**  
响应的 HTTP 状态代码为 `4xx` 或 `5xx` 的所有查看器请求所占的百分比。  
+ 指标名称：`TotalErrorRate`
+ Valid statistic (有效统计数据)：`Average`
+ 单位：`Percent`

## CloudFront 函数指标的值
<a name="cloudfront-metrics-function-values"></a>

使用以下列表中的信息从 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`
+ Unit (单位)：`None`