本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
使用 Amazon CloudWatch API 取得指標
您可以使用 CloudWatch API 或 AWS Command Line Interface (AWS CLI)，在您建置的程式或應用程式中取得 CloudFront 指標。您可以使用原始資料來建置自己的自訂儀表板、您自己的警示工具等等。
如需詳細資訊，請參閱《 AWS CLI 命令參考》中的 get-metric-data 或《Amazon CloudWatch API 參考》中的 GetMetricData API 操作。 Amazon CloudWatch
注意
若要從 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 -
有效統計資訊：
Average -
單位：
Percent
-
- 401 錯誤率
-
回應的 HTTP 狀態碼為
401之所有瀏覽者請求的百分比。若要取得此指標，您必須先開啟其他指標。-
指標名稱：
401ErrorRate -
有效統計資訊：
Average -
單位：
Percent
-
- 403 錯誤率
-
回應的 HTTP 狀態碼為
403之所有瀏覽者請求的百分比。若要取得此指標，您必須先開啟其他指標。-
指標名稱：
403ErrorRate -
有效統計資訊：
Average -
單位：
Percent
-
- 404 錯誤率
-
回應的 HTTP 狀態碼為
404之所有瀏覽者請求的百分比。若要取得此指標，您必須先開啟其他指標。-
指標名稱：
404ErrorRate -
有效統計資訊：
Average -
單位：
Percent
-
- 5xx 錯誤率
-
回應的 HTTP 狀態碼為
5xx之所有瀏覽者請求的百分比。-
指標名稱：
5xxErrorRate -
有效統計資訊：
Average -
單位：
Percent
-
- 502 錯誤率
-
回應的 HTTP 狀態碼為
502之所有瀏覽者請求的百分比。若要取得此指標，您必須先開啟其他指標。-
指標名稱：
502ErrorRate -
有效統計資訊：
Average -
單位：
Percent
-
- 503 錯誤率
-
回應的 HTTP 狀態碼為
503之所有瀏覽者請求的百分比。若要取得此指標，您必須先開啟其他指標。-
指標名稱：
503ErrorRate -
有效統計資訊：
Average -
單位：
Percent
-
- 504 錯誤率
-
回應的 HTTP 狀態碼為
504之所有瀏覽者請求的百分比。若要取得此指標，您必須先開啟其他指標。-
指標名稱：
504ErrorRate -
有效統計資訊：
Average -
單位：
Percent
-
- 下載的位元組數
-
瀏覽者執行
GET、HEAD及OPTIONS請求時下載的位元組總數。-
指標名稱：
BytesDownloaded -
有效統計資訊：
Sum -
單位：
None
-
- 上傳的位元組數
-
檢視器使用
POST和PUT請求，透過 CloudFront 上傳至原始伺服器的位元組總數。-
指標名稱：
BytesUploaded -
有效統計資訊：
Sum -
單位：
None
-
- 快取命中率
-
CloudFront 從其快取中提供內容的所有可快取請求的百分比。HTTP
POST和PUT請求及錯誤不視為可快取請求。若要取得此指標，您必須先開啟其他指標。-
指標名稱：
CacheHitRate -
有效統計資訊：
Average -
單位：
Percent
-
- 來源延遲
-
對於原始伺服器提供的請求 (非從 CloudFront 快取提供)，從 CloudFront 收到請求到開始對網路 (非檢視器) 提供回應所花費的總時長 (以毫秒為單位)。這也稱為第一位元組延遲或第一個位元組的時間。若要取得此指標，您必須先開啟其他指標。
-
指標名稱：
OriginLatency -
有效統計資訊：
Percentile -
單位：
Milliseconds
注意
若要從 CloudWatch API 取得
Percentile統計資料，請使用ExtendedStatistics參數，不要使用Statistics。如需詳細資訊，請參閱 Amazon CloudWatch API 參考中的 GetMetricStatistics，或 AWS 開發套件的參考文件。 -
- 請求
-
CloudFront 收到之所有 HTTP 方法以及 HTTP 和 HTTPS 請求的檢視器請求總數。
-
指標名稱：
Requests -
有效統計資訊：
Sum -
單位：
None
-
- 總錯誤率
-
回應的 HTTP 狀態碼為
4xx或5xx之所有瀏覽者請求的百分比。-
指標名稱：
TotalErrorRate -
有效統計資訊：
Average -
單位：
Percent
-
CloudFront 函數指標的值
使用下列清單中的資訊，從 CloudWatch API 取得特定 CloudFront 函數的詳細資訊。
注意
每個指標僅適用一個統計資料 (Average 或 Sum)。下列清單指定適用於該指標的統計資料。
- 呼叫
-
在給定時間段內啟動 (叫用) 函數的次數。
-
指標名稱：
FunctionInvocations -
有效統計資訊：
Sum -
單位：
None
-
- 驗證錯誤
-
函數在給定時間段內產生的驗證錯誤數。函數成功執行但返回無效的資料 (無效的事件物件) 時，就會發生驗證錯誤。
-
指標名稱：
FunctionValidationErrors -
有效統計資訊：
Sum -
單位：
None
-
- 執行錯誤
-
在給定時間段內發生的執行錯誤次數。當函數無法成功完成時，就會發生執行錯誤。
-
指標名稱：
FunctionExecutionErrors -
有效統計資訊：
Sum -
單位：
None
-
- 運算利用率
-
執行函數所花費的時間 (0-100)，以所允許時間上限的百分比表示。例如，35 的值表示該函數以所允許時間上限的 35% 完成。
-
指標名稱：
FunctionComputeUtilization -
有效統計資訊：
Average -
單位：
Percent
-
- 限流
-
在特定期間內調節函數的次數。
-
指標名稱：
FunctionThrottles -
有效統計資訊：
Sum -
單位：
None
-
