本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
使用 Amazon CloudWatch API 取得指標
您可以使用 CloudWatch API 或 AWS Command Line Interface (AWS CLI) 取得您所建置之程式或應用程式中的 CloudFront 指標。您可以使用原始資料來建置自己的自訂儀表板、您自己的警示工具等等。
如需詳細資訊，請參閱get-metric-data AWS CLI命令參考或 Amazon GetMetricDataAPI 參考中的 CloudWatch API 操作。
注意
若要從 CloudWatch API 取得 CloudFront 指標，您必須使用美國東部 (維吉尼亞北部) 區域 (us-east-1)。您還必須知道每個指標的特定值和類型。
所有 CloudFront 指標的值
下列值適用於所有 CloudFront 測量結果：
Namespace-
Namespace的值永遠為AWS/CloudFront。 - 維度
-
每個 CloudFront 量度都有以下兩個維度：
DistributionId-
您要取得量度的 CloudFront 分佈識別碼。
FunctionName-
您要取得量度之函數的名稱 (在 CloudFront 函數中)。
此維度僅適用於函數。
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
-
- 上傳的位元組數
-
檢視者使用CloudFront、使用
POST和PUT要求上傳至您來源的位元組總數。-
指標名稱：
BytesUploaded -
有效統計資訊：
Sum -
單位：
None
-
- 快取命中率
-
為其 CloudFront 提供快取內容的所有可快取要求的百分比。HTTP
POST和PUT請求及錯誤不視為可快取請求。若要取得此指標，您必須先開啟其他指標。-
指標名稱：
CacheHitRate -
有效統計資訊：
Average -
單位：
Percent
-
- 來源延遲
-
從 CloudFront 接收要求到開始對網路 (非檢視者) 提供回應 (而非檢視者) 的要求 (而非 CloudFront快取) 所花費的總時間 (以毫秒為單位)。這也稱為第一個位元組延遲，或time-to-first-byte。若要取得此指標，您必須先開啟其他指標。
-
指標名稱：
OriginLatency -
有效統計資訊：
Percentile -
單位：
Milliseconds
注意
要從 CloudWatch API 獲取
Percentile統計信息，請使用ExtendedStatistics參數，而不是Statistics。如需詳細資訊，請參閱 GetMetricStatisticsAmazon CloudWatch API 參考或AWS 開發套件的參考文件。 -
- 請求
-
所有 HTTP 方法以及 HTTP 和 HTTPS 要求所接收的檢視器要求總數。 CloudFront
-
指標名稱：
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
-
