本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

您可以使用 CloudWatch API 或 AWS Command Line Interface (AWS CLI)，在您建置的程式或應用程式中取得 CloudFront 指標。您可以使用原始資料來建置自己的自訂儀表板、您自己的警示工具等等。

如需詳細資訊，請參閱《*AWS CLI 命令參考*》中的 [get-metric-data](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-data.html) 或《*Amazon CloudWatch API 參考*》中的 [GetMetricData](https://docs.aws.amazon.com/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`
+ 有效統計資訊：`Average`
+ 單位：`Percent`

**401 錯誤率**  
回應的 HTTP 狀態碼為 `401` 之所有瀏覽者請求的百分比。若要取得此指標，您必須先[開啟其他指標](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)。  
+ 指標名稱：`401ErrorRate`
+ 有效統計資訊：`Average`
+ 單位：`Percent`

**403 錯誤率**  
回應的 HTTP 狀態碼為 `403` 之所有瀏覽者請求的百分比。若要取得此指標，您必須先[開啟其他指標](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)。  
+ 指標名稱：`403ErrorRate`
+ 有效統計資訊：`Average`
+ 單位：`Percent`

**404 錯誤率**  
回應的 HTTP 狀態碼為 `404` 之所有瀏覽者請求的百分比。若要取得此指標，您必須先[開啟其他指標](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)。  
+ 指標名稱：`404ErrorRate`
+ 有效統計資訊：`Average`
+ 單位：`Percent`

**5xx 錯誤率**  
回應的 HTTP 狀態碼為 `5xx` 之所有瀏覽者請求的百分比。  
+ 指標名稱：`5xxErrorRate`
+ 有效統計資訊：`Average`
+ 單位：`Percent`

**502 錯誤率**  
回應的 HTTP 狀態碼為 `502` 之所有瀏覽者請求的百分比。若要取得此指標，您必須先[開啟其他指標](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)。  
+ 指標名稱：`502ErrorRate`
+ 有效統計資訊：`Average`
+ 單位：`Percent`

**503 錯誤率**  
回應的 HTTP 狀態碼為 `503` 之所有瀏覽者請求的百分比。若要取得此指標，您必須先[開啟其他指標](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)。  
+ 指標名稱：`503ErrorRate`
+ 有效統計資訊：`Average`
+ 單位：`Percent`

**504 錯誤率**  
回應的 HTTP 狀態碼為 `504` 之所有瀏覽者請求的百分比。若要取得此指標，您必須先[開啟其他指標](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)。  
+ 指標名稱：`504ErrorRate`
+ 有效統計資訊：`Average`
+ 單位：`Percent`

**下載的位元組數**  
檢視器針對 `GET` 和 `HEAD` 請求下載的位元組總數。  
+ 指標名稱：`BytesDownloaded`
+ 有效統計資訊：`Sum`
+ 單位：`None`

**上傳的位元組數**  
檢視器使用 `OPTIONS`、`POST` 和 `PUT` 請求上傳至 CloudFront 的位元組總數。  
+ 指標名稱：`BytesUploaded`
+ 有效統計資訊：`Sum`
+ 單位：`None`

**快取命中率**  
CloudFront 從其快取中提供內容的所有可快取請求的百分比。HTTP `POST` 和 `PUT` 請求及錯誤不視為可快取請求。若要取得此指標，您必須先[開啟其他指標](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)。  
+ 指標名稱：`CacheHitRate`
+ 有效統計資訊：`Average`
+ 單位：`Percent`

**來源延遲**  
對於原始伺服器提供的請求 (非從 CloudFront 快取提供)，從 CloudFront 收到請求到開始對網路 (非檢視器) 提供回應所花費的總時長 (以毫秒為單位)。這也稱為*第一位元組延遲*或*第一個位元組的時間*。若要取得此指標，您必須先[開啟其他指標](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)。  
+ 指標名稱：`OriginLatency`
+ 有效統計資訊：`Percentile`
+ 單位：`Milliseconds`
若要從 CloudWatch API 取得 `Percentile` 統計資料，請使用 `ExtendedStatistics` 參數，不要使用 `Statistics`。如需詳細資訊，請參閱 *Amazon CloudWatch API 參考*中的 [GetMetricStatistics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html)，或 [AWS 開發套件](https://docs.aws.amazon.com/#sdks)的參考文件。

**請求**  
CloudFront 收到之所有 HTTP 方法以及 HTTP 和 HTTPS 請求的檢視器請求總數。  
+ 指標名稱：`Requests`
+ 有效統計資訊：`Sum`
+ 單位：`None`

**總錯誤率**  
回應的 HTTP 狀態碼為 `4xx` 或 `5xx` 之所有瀏覽者請求的百分比。  
+ 指標名稱：`TotalErrorRate`
+ 有效統計資訊：`Average`
+ 單位：`Percent`

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

使用下列清單中的資訊，從 CloudWatch API 取得特定 CloudFront 函數的詳細資訊。

**注意**  
每個指標僅適用一個統計資料 (`Average` 或 `Sum`)。下列清單指定適用於該指標的統計資料。

**呼叫**  
在給定時間段內啟動 (叫用) 函數的次數。  
+ 指標名稱：`FunctionInvocations`
+ 有效統計資訊：`Sum`
+ 單位：`None`

**驗證錯誤**  
函數在給定時間段內產生的驗證錯誤數。函數成功執行但返回無效的資料 (無效的事件物件) 時，就會發生驗證錯誤。  
+ 指標名稱：`FunctionValidationErrors`
+ 有效統計資訊：`Sum`
+ 單位：`None`

**執行錯誤**  
在給定時間段內發生的執行錯誤次數。當函數無法成功完成時，就會發生執行錯誤。  
+ 指標名稱：`FunctionExecutionErrors`
+ 有效統計資訊：`Sum`
+ 單位：`None`

**運算利用率**  
執行函數所花費的時間 (0-100)，以所允許時間上限的百分比表示。例如，值為 35 表示函數在最大允許時間的 35% 內完成。  
+ 指標名稱：`FunctionComputeUtilization`
+ 有效統計資訊：`Average`
+ 單位：`Percent`

**限流**  
在特定期間內調節函數的次數。  
+ 指標名稱：`FunctionThrottles`
+ 有效統計資訊：`Sum`
+ 單位：`None`