監控 AWS CodeBuild

您可以使用 Amazon CloudWatch 來監看組建，在發現錯誤時回報，並適時自動採取動作。您可以在兩個層級監控組建：

項目級別

這些指標用於指定專案中的所有組建。若要查看專案的指標，請指定ProjectName中的 CloudWatch。

AWS帳户級別

這些指標用於帳户中的所有組建。若要查看AWS帳户級別，請勿在 CloudWatch 中輸入維度。構建資源利用率衡量指標在AWS帳户級別。

CloudWatch 指標會顯示組建隨著時間的行為。例如，您可以監控：

• 隨著時間在組建專案或 AWS 帳戶中嘗試了多少個組建。

• 隨著時間在組建專案或 AWS 帳戶中成功了多少個組建。

• 隨著時間在組建專案或 AWS 帳戶中失敗了多少個組建。

• CodeBuild 用於運行組建耗費了多少時間。AWS隨著時間的帳號。

• 構建生成或整個構建項目的資源利用率。構建資源使用率指標包含 CPU、記憶體和存儲使用率這類指標。

如需詳細資訊，請參閱 監控 CodeBuild 指標。

CodeBuild 指標

以下指標可通過AWS帳户或組建專案。

構建

測量組建的 BUILD 階段的持續時間。

個單位: 秒鐘

有效的 CloudWatch 統計資訊：平均值 (建議)、最大值

建置數

測量已觸發的組建數目。

個單位: 計數

有效的 CloudWatch 統計資訊：總和

下載源持續時間

測量組建的 DOWNLOAD_SOURCE 階段的持續時間。

個單位: 秒鐘

有效的 CloudWatch 統計資訊：平均值 (建議)、最大值

Duration

測量隨著時間所有組建的持續時間。

個單位: 秒鐘

有效的 CloudWatch 統計資訊：平均值 (建議)、最大值

FailedBuilds

測量因為客户端錯誤或超時而失敗的組建數量。

個單位: 計數

有效的 CloudWatch 統計資訊：總和

最終確定持續時間

測量組建的 FINALIZING 階段的持續時間。

個單位: 秒鐘

有效的 CloudWatch 統計資訊：平均值 (建議)、最大值

安裝持續時間

測量組建的 INSTALL 階段的持續時間。

個單位: 秒鐘

有效的 CloudWatch 統計資訊：平均值 (建議)、最大值

構建後

測量組建的 POST_BUILD 階段的持續時間

個單位: 秒鐘

有效的 CloudWatch 統計資訊：平均值 (建議)、最大值

預構建

測量組建的 PRE_BUILD 階段的持續時間。

個單位: 秒鐘

有效的 CloudWatch 統計資訊：平均值 (建議)、最大值

配置持續時間

測量組建的 PROVISIONING 階段的持續時間。

個單位: 秒鐘

有效的 CloudWatch 統計資訊：平均值 (建議)、最大值

隊列持續時間

測量組建的 QUEUED 階段的持續時間。

個單位: 秒鐘

有效的 CloudWatch 統計資訊：平均值 (建議)、最大值

提交

測量組建的 SUBMITTED 階段的持續時間。

個單位: 秒鐘

有效的 CloudWatch 統計資訊：平均值 (建議)、最大值

SucceededBuilds

測量成功的組建數目。

個單位: 計數

有效的 CloudWatch 統計資訊：總和

上載工件持續時間

測量組建的 UPLOAD_ARTIFACTS 階段的持續時間。

個單位: 秒鐘

有效的 CloudWatch 統計資訊：平均值 (建議)、最大值

CodeBuild CloudWatch 資源利用率指標

注意

下列區域才能取得 CodeBuild 資源使用率指標：

• 亞太區域 (東京) 區域

• Asia Pacific (Seoul) Region

• Asia Pacific (Mumbai) Region

• Asia Pacific (Singapore) Region

• Asia Pacific (Sydney) Region

• Canada (Central) Region

• 歐洲區域 (法蘭克福)

• Europe (Ireland) Region

• Europe (London) Region

• 歐洲 (巴黎) 區域

• South America (São Paulo) Region

• US East (N. Virginia) Region

• US East (Ohio) Region

• US West (N. California) Region

• 美國西部區域 (奧勒岡)

可以跟蹤以下資源利用率指標。

CPU 使用

組建容器使用的已配置處理單位數。

個單位: CPU 單位

有效的 CloudWatch 統計資訊：平均值 (建議)、最大值

CPU 使用率百分比

構建容器使用的已分配處理的百分比。

個單位: 百分比

有效的 CloudWatch 統計資訊：平均值 (建議)、最大值

MemoryUtilized

組建容器使用的記憶體數。

個單位: MB

有效的 CloudWatch 統計資訊：平均值 (建議)、最大值

記憶佔用百分比

組建容器使用的已配置記憶體百分比。

個單位: 百分比

有效的 CloudWatch 統計資訊：平均值 (建議)、最大值

StorageReadBytes

構建容器使用的存儲讀取速度。

個單位: 位位/秒

有效的 CloudWatch 統計資訊：平均值 (建議)、最大值

StorageWriteBytes

構建容器使用的存儲寫入速度。

個單位: 位位/秒

有效的 CloudWatch 統計資訊：平均值 (建議)、最大值

CodeBuild 維度

CodeBuild 提供了以下 CloudWatch 指標維度。如果未指定這些指標，則指標用於當前AWS帳户。

BuildId、內部編號、ProjectName

為構建標識符、內部版本號和項目名稱提供了指標。

ProjectName

針對專案名稱提供了指標。

CodeBuild 警示

您可以使用 CloudWatch 控台來根據 CodeBuild 指標建立警示，使得您可以在組建發生錯誤時加以應對。對警示來說，最有用的兩個指標是：

• FailedBuild。 您可以建立警示，此警示會在預定秒數內偵測到特定數目的失敗組建時觸發。在 CloudWatch 中，您可以指定將觸發警示的秒數和失敗組建的數目。

• Duration。 您可以建立當組建耗費的時間較預期長時觸發的警示。您可以指定於觸發警示之前，在組建開始後與組建完成前，必須經過的秒數。

如需如何為 CodeBuild 指標建立警示的詳細資訊，請參閲使用 CloudWatch 警示監控組建。如需警示的詳細資訊，請參閲建立 Amazon CloudWatch 警示中的Amazon CloudWatch 使用者指南。