View a markdown version of this page

CloudFront 的指標類型 - Amazon CloudFront

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

CloudFront 的指標類型

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

如需詳細資訊,請參閱《AWS CLI 命令參考》中的 get-metric-data 或《Amazon CloudWatch API 參考》中的 GetMetricData API 操作。

注意

若要從 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 請求下載的位元組總數。

  • 指標名稱:BytesDownloaded

  • 有效統計資訊:Sum

  • 單位:None

上傳的位元組數

檢視器使用 OPTIONS、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