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

# 使用 CloudWatch 監控 CodeBuild 建置
<a name="monitoring-builds"></a>

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

專案層級  
這些指標適用於指定專案中的所有組建。若要查看專案的指標，請在 CloudWatch 中`ProjectName`為維度指定 。

AWS 帳戶層級  
這些指標適用於 帳戶中的所有組建。若要查看帳戶層級的 AWS 指標，請勿在 CloudWatch 中輸入維度。 AWS 帳戶層級無法使用建置資源使用率指標。

CloudWatch 指標會顯示您建置隨時間經過的行為。例如，您可以監控：
+  隨著時間的推移，在組建專案或 AWS 帳戶中嘗試了多少組建。
+  隨著時間的推移，組建專案或 AWS 帳戶中有多少組建成功。
+  隨著時間的推移，組建專案或 AWS 帳戶中有多少組建失敗。
+  CodeBuild 隨著時間在組建專案或 AWS 帳戶中執行組建所花費的時間。
+ 建置建置或整個建置專案的資源使用率。建置資源使用率指標包括 CPU、記憶體和儲存使用率等指標。

 如需詳細資訊，請參閱[檢視 CodeBuild 指標](monitoring-metrics.md)。

# CodeBuild CloudWatch 指標
<a name="cloudwatch_metrics-codebuild"></a>

 您可以追蹤每個 AWS 帳戶或組建專案的下列指標。如需搭配 CodeBuild 使用 CloudWatch 的詳細資訊，請參閱 [使用 CloudWatch 監控 CodeBuild 建置](monitoring-builds.md)。

BuildDuration  
測量組建的 `BUILD` 階段的持續時間。  
單位：秒  
有效的 CloudWatch 統計資料：平均值 （建議）、最大值、最小值

Builds  
 測量已觸發的組建數目。  
 單位：Count   
 有效的 CloudWatch 統計資料：總和 

DownloadSourceDuration  
測量組建的 `DOWNLOAD_SOURCE` 階段的持續時間。  
單位：秒  
有效的 CloudWatch 統計資料：平均值 （建議）、最大值、最小值

持續時間  
 測量隨著時間所有組建的持續時間。  
 單位：秒   
 有效的 CloudWatch 統計資料：平均值 （建議）、最大值、最小值 

FailedBuilds  
 測量由於用戶端錯誤或逾時而失敗的建置數目。  
 單位：Count   
 有效的 CloudWatch 統計資料：總和 

FinalizingDuration  
測量組建的 `FINALIZING` 階段的持續時間。  
單位：秒  
有效的 CloudWatch 統計資料：平均值 （建議）、最大值、最小值

InstallDuration  
測量組建的 `INSTALL` 階段的持續時間。  
單位：秒  
有效的 CloudWatch 統計資料：平均值 （建議）、最大值、最小值

PostBuildDuration  
測量組建的 `POST_BUILD` 階段的持續時間  
單位：秒  
有效的 CloudWatch 統計資料：平均值 （建議）、最大值、最小值

PreBuildDuration  
測量組建的 `PRE_BUILD` 階段的持續時間。  
單位：秒  
有效的 CloudWatch 統計資料：平均值 （建議）、最大值、最小值

ProvisioningDuration  
測量組建的 `PROVISIONING` 階段的持續時間。  
單位：秒  
有效的 CloudWatch 統計資料：平均值 （建議）、最大值、最小值

QueuedDuration  
測量組建的 `QUEUED` 階段的持續時間。  
單位：秒  
有效的 CloudWatch 統計資料：平均值 （建議）、最大值、最小值

SubmittedDuration  
測量組建的 `SUBMITTED` 階段的持續時間。  
單位：秒  
有效的 CloudWatch 統計資料：平均值 （建議）、最大值、最小值

SucceededBuilds  
 測量成功的組建數目。  
 單位：Count   
 有效的 CloudWatch 統計資料：總和 

UploadArtifactsDuration  
測量組建的 `UPLOAD_ARTIFACTS` 階段的持續時間。  
單位：秒  
有效的 CloudWatch 統計資料：平均值 （建議）、最大值、最小值

# CodeBuild CloudWatch 資源使用率指標
<a name="cloudwatch-utilization-metrics"></a>

**注意**  
CodeBuild 資源使用率指標僅適用於下列區域：  
亞太區域 (東京) 區域
亞太區域 (首爾) 區域
亞太地區 (孟買) 區域
亞太區域 (新加坡) 區域
亞太區域 (雪梨) 區域
加拿大 (中部) 區域
歐洲 (法蘭克福) 區域
歐洲 (愛爾蘭) 區域
歐洲 (倫敦) 區域
歐洲 (巴黎) 區域
南美洲 (聖保羅) 區域
美國東部 (維吉尼亞北部) 區域
美國東部 (俄亥俄) 區域
美國西部 (加利佛尼亞北部) 區域
美國西部 (奧勒岡) 區域

您可以追蹤下列資源使用率指標。如需搭配 CodeBuild 使用 CloudWatch 的詳細資訊，請參閱 [使用 CloudWatch 監控 CodeBuild 建置](monitoring-builds.md)。

CPUUtilized  
建置容器使用的已配置處理 CPU 單位數量。  
單位：CPU 單位  
有效的 CloudWatch 統計資料：平均值 （建議）、最大值、最小值

CPUUtilizedPercent  
建置容器使用的已配置處理百分比。  
單位：百分比  
有效的 CloudWatch 統計資料：平均值 （建議）、最大值、最小值

MemoryUtilized  
組建容器使用的記憶體數。  
單位：MB  
有效的 CloudWatch 統計資料：平均值 （建議）、最大值、最小值

MemoryUtilizedPercent  
組建容器使用的配置記憶體百分比。  
單位：百分比  
有效的 CloudWatch 統計資料：平均值 （建議）、最大值、最小值

StorageReadBytes  
組建容器使用的儲存讀取速度。  
單位：位元組/秒  
有效的 CloudWatch 統計資料：平均值 （建議）、最大值、最小值

StorageWriteBytes  
組建容器使用的儲存寫入速度。  
單位：位元組/秒  
有效的 CloudWatch 統計資料：平均值 （建議）、最大值、最小值

# CodeBuild CloudWatch 維度
<a name="codebuild-cloudwatch-dimensions"></a>

CodeBuild 提供下列 CloudWatch 指標維度。如果未指定這些指標，則指標適用於目前 AWS 帳戶。

BuildId、 BuildNumber、ProjectName  
提供建置識別符、建置編號和專案名稱的指標。

ProjectName  
為專案名稱提供指標。

# CodeBuild CloudWatch 警示
<a name="codebuild_cloudwatch_alarms"></a>

 您可以使用 CloudWatch 主控台根據 CodeBuild 指標建立警示，以便在建置發生錯誤時做出反應。下列各點說明兩個對警示最有用的指標。如需搭配 CodeBuild 使用 CloudWatch 的詳細資訊，請參閱 [使用 CloudWatch 監控 CodeBuild 建置](monitoring-builds.md)。
+  `FailedBuild`。 您可以在預定秒數內偵測到特定數量的失敗組建時，建立觸發的警示。在 CloudWatch 中，您可以指定觸發警示的秒數和失敗組建次數。
+  `Duration`。 您可以建立在建置時間超過預期時觸發的警示。您可以指定於觸發警示之前，在組建開始後與組建完成前，必須經過的秒數。

 如需如何為 CodeBuild 指標建立警示的資訊，請參閱 [使用 CloudWatch 警示監控 CodeBuild 組建](monitoring-alarms.md)。如需警示的詳細資訊，請參閱《[Amazon CloudWatch 使用者指南》中的建立 Amazon CloudWatch 警示](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)。 *Amazon CloudWatch * 

# 檢視 CodeBuild 指標
<a name="monitoring-metrics"></a>

 AWS CodeBuild 會代表您監控 函數，並透過 Amazon CloudWatch 報告指標。這些指標包含建置總數、失敗建置和成功建置，以及建置持續時間。

 您可以使用 CodeBuild 主控台或 CloudWatch 主控台來監控 CodeBuild 的指標。下列程序說明如何檢視指標。

**Topics**
+ [檢視建置指標 (CodeBuild 主控台）](#metrics-in-codebuild-console)
+ [檢視建置指標 (Amazon CloudWatch 主控台）](#metrics-in-cloudwatch-console)

## 檢視建置指標 (CodeBuild 主控台）
<a name="metrics-in-codebuild-console"></a>

**注意**  
您無法自訂用於在 CodeBuild 主控台中顯示指標的指標或圖形。如果您想要自訂顯示，請使用 Amazon CloudWatch 主控台來檢視您的建置指標。

### 帳戶層級指標
<a name="codebuild-console-account-level-metrics"></a><a name="cw-account-metrics-codebuild-console"></a>

**檢視 AWS 帳戶層級指標**

1. 登入 AWS 管理主控台 並在 https：//[https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) 開啟 AWS CodeBuild 主控台。

1.  在導覽窗格中，選擇 **Account metrics (帳戶指標)**。

### 專案層級指標
<a name="codebuild-console-project-level-metrics"></a><a name="cw-project-codebuild-console"></a>

**檢視專案層級指標**

1. 登入 AWS 管理主控台 並在 https：//[https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) 開啟 AWS CodeBuild 主控台。

1.  在導覽窗格中，選擇 **Build projects (建置專案)**。

1.  在組建專案清單中，於 **Name (名稱)** 欄中，選擇您想要檢視指標所在的專案。

1.  選擇**指標**標籤。

## 檢視建置指標 (Amazon CloudWatch 主控台）
<a name="metrics-in-cloudwatch-console"></a>

您可以使用 CloudWatch 主控台自訂指標和用來顯示指標的圖形。

### 帳戶層級指標
<a name="cloudwatch-console-account-level-metrics"></a><a name="cw-account-cloudwatch-console"></a>

**檢視帳戶層級指標**

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1.  在導覽窗格中，選擇 **指標**。

1.  在 **All metrics (所有指標)** 標籤上，選擇 **CodeBuild**。  
![\[如何檢視 CodeBuild 指標。\]](http://docs.aws.amazon.com/zh_tw/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)

1.  選擇**帳戶指標**。

1.  選擇一或多個專案和指標。針對每個專案，您可以選擇 **SucceededBuilds**、**FailedBuilds**、**Builds** 和 **Duration** 指標。所有選取的專案和指標組合都會顯示在頁面的圖形中。

### 專案層級指標
<a name="cloudwatch-console-project-level-metrics"></a><a name="cw-project-cloudwatch-console"></a>

**檢視專案層級指標**

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1.  在導覽窗格中，選擇 **指標**。

1.  在 **All metrics (所有指標)** 標籤上，選擇 **CodeBuild**。  
![\[如何檢視 CodeBuild 指標。\]](http://docs.aws.amazon.com/zh_tw/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)

1.  選擇 **By Project (依專案)**。

1.  選擇一或多個專案和指標組合。針對每個專案，您可以選擇 **SucceededBuilds**、**FailedBuilds**、**Builds** 和 **Duration** 指標。所有選取的專案和指標組合都會顯示在頁面的圖形中。

1.  (選用) 您可以自訂指標和圖形。例如，從**統計資料**欄中的下拉式清單中，您可以選擇要顯示的不同統計資料。或者，從下拉式功能表中，於 **Period (期間)** 欄中，您可以選擇用來監控指標的不同時間期間。

   如需詳細資訊，請參閱《*Amazon CloudWatch 使用者指南*》中的[圖形指標](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html)和[檢視可用的指標](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html)。

# 檢視 CodeBuild 資源使用率指標
<a name="monitoring-utilization-metrics"></a>

AWS CodeBuild 會代表您監控建置資源使用率，並透過 Amazon CloudWatch 報告指標。這些包括 CPU、記憶體和儲存使用率等指標。

**注意**  
CodeBuild 資源使用率指標只會針對執行超過一分鐘的組建進行記錄。

您可以使用 CodeBuild 主控台或 CloudWatch 主控台來監控 CodeBuild 的資源使用率指標。

**注意**  
CodeBuild 資源使用率指標僅適用於下列區域：  
亞太區域 (東京) 區域
亞太區域 (首爾) 區域
亞太地區 (孟買) 區域
亞太區域 (新加坡) 區域
亞太區域 (雪梨) 區域
加拿大 (中部) 區域
歐洲 (法蘭克福) 區域
歐洲 (愛爾蘭) 區域
歐洲 (倫敦) 區域
歐洲 (巴黎) 區域
南美洲 (聖保羅) 區域
美國東部 (維吉尼亞北部) 區域
美國東部 (俄亥俄) 區域
美國西部 (加利佛尼亞北部) 區域
美國西部 (奧勒岡) 區域

下列程序說明如何存取資源使用率指標。

**Topics**
+ [存取資源使用率指標 (CodeBuild 主控台）](#utilization-metrics-codebuild-console)
+ [存取資源使用率指標 (Amazon CloudWatch 主控台）](#utilization-metrics-cloudwatch-console)

## 存取資源使用率指標 (CodeBuild 主控台）
<a name="utilization-metrics-codebuild-console"></a>

**注意**  
您無法自訂用於在 CodeBuild 主控台中顯示指標的指標或圖形。如果您想要自訂顯示，請使用 Amazon CloudWatch 主控台來檢視您的建置指標。

### 專案層級資源使用率指標
<a name="codebuild-console-project-level-utilization"></a>

**存取專案層級的資源使用率指標**

1. 登入 AWS 管理主控台 並在 https：//[https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) 開啟 AWS CodeBuild 主控台。

1. 在導覽窗格中，選擇 **Build projects (建置專案)**。

1. 在建置專案清單中的名稱****欄中，選擇您要檢視其使用率指標的專案。

1. 選擇**指標**標籤。資源使用率指標會顯示在**資源使用率指標**區段中。

1. 若要在 CloudWatch 主控台中檢視專案層級資源使用率指標，請在**資源使用率指標**區段中選擇在 ** CloudWatch 中檢視**。

### 建置層級資源使用率指標
<a name="codebuild-console-build-level-utilization"></a>

**存取建置層級資源使用率指標**

1. 登入 AWS 管理主控台 並在 https：//[https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) 開啟 AWS CodeBuild 主控台。

1. 在導覽窗格中，選擇 **Build history (組建歷史記錄)**。

1. 在組建清單中的**組建執行**欄中，選擇您要檢視其使用率指標的組建。

1. 選擇**資源使用率**索引標籤。

1. 若要在 CloudWatch 主控台中檢視建置層級資源使用率指標，請在**資源使用率指標**區段中選擇在 ** CloudWatch 中檢視**。

## 存取資源使用率指標 (Amazon CloudWatch 主控台）
<a name="utilization-metrics-cloudwatch-console"></a>

Amazon CloudWatch 主控台可用來存取 CodeBuild 資源使用率指標。

### 專案層級資源使用率指標
<a name="cloudwatch-console-project-level-utilization"></a><a name="cw-project-cloudwatch-console"></a>

**存取專案層級的資源使用率指標**

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1. 在導覽窗格中，選擇 **指標**。

1. 在 **All metrics (所有指標)** 標籤上，選擇 **CodeBuild**。  
![\[主控台螢幕擷取畫面，顯示位於所有指標索引標籤上的 CodeBuild 選項。\]](http://docs.aws.amazon.com/zh_tw/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)

1. 選擇 **By Project (依專案)**。

1. 選擇要新增至圖形的一或多個專案和指標組合。所有選取的專案和指標組合都會顯示在頁面的圖形中。

1. （選用） 您可以從**圖形化指標**索引標籤自訂指標和圖形。例如，從**統計資料**欄中的下拉式清單中，您可以選擇要顯示的不同統計資料。或者，從下拉式功能表中，於 **Period (期間)** 欄中，您可以選擇用來監控指標的不同時間期間。

   如需詳細資訊，請參閱《*Amazon CloudWatch 使用者指南*》中的[繪製指標](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html)圖形和[檢視可用的指標](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html)。

### 建置層級資源使用率指標
<a name="cloudwatch-console-build-level-utilization"></a>

**存取建置層級資源使用率指標**

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1. 在導覽窗格中，選擇 **指標**。

1. 在 **All metrics (所有指標)** 標籤上，選擇 **CodeBuild**。  
![\[主控台螢幕擷取畫面，顯示位於所有指標索引標籤上的 CodeBuild 選項。\]](http://docs.aws.amazon.com/zh_tw/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)

1. 選擇 **BuildId、 BuildNumber、ProjectName**。

1. 選擇要新增至圖形的一或多個組建和指標組合。所有選取的組建和指標組合都會顯示在頁面上的圖形中。

1. （選用） 您可以從**圖形化指標**索引標籤自訂指標和圖形。例如，從**統計資料**欄中的下拉式清單中，您可以選擇要顯示的不同統計資料。或者，從下拉式功能表中，於 **Period (期間)** 欄中，您可以選擇用來監控指標的不同時間期間。

   如需詳細資訊，請參閱《*Amazon CloudWatch 使用者指南*》中的[繪製指標](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html)和[檢視可用的指標](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html)。

# 使用 CloudWatch 警示監控 CodeBuild 組建
<a name="monitoring-alarms"></a>

 您可以為組建建立 CloudWatch 警示。警示會監看您指定時間段的單個指標，然後根據幾個時間段內與指定閾值相關的指標值來執行一或多個動作。使用原生 CloudWatch 警示功能，您可以在超過閾值時指定 CloudWatch 支援的任何動作。例如，您可以指定在帳戶中有三個以上的組建在十五分鐘內失敗時傳送 Amazon SNS 通知。

**為 CodeBuild 指標建立 CloudWatch 警示**

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1.  在導覽窗格中，選擇 **Alarms** (警示)。

1.  選擇**建立警示** 。

1.  在 **CloudWatch Metrics by Category (依類別的 CloudWatch 指標)** 下，選擇 **CodeBuild Metrics (CodeBuild 指標)**。如果您只需要專案層級指標，請選擇 **By Project (依專案)**。如果您只需要帳戶層級指標，請選擇 **Account Metrics (帳戶指標)**。

1.  在 **Create Alarm (建立警示)** 上，如果尚未選取指標，請選擇 **Select Metric (選擇指標)**。

1.  選擇您要為其建立警示的指標。選項為 **By Project (依專案)** 或 **Account Metrics (帳戶指標)**。

1.  選擇 **Next (下一步)** 或 **Define Alarm (定義警示)**，然後建立警示。如需詳細資訊，請參閱 *Amazon CloudWatch 使用者指南*中的[建立 CloudWatch 警示](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)。如需在觸發警示時設定 Amazon SNS 通知的詳細資訊，請參閱《[Amazon SNS 開發人員指南》中的設定 Amazon SNS 通知](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html)。 *Amazon SNS * 

1.  選擇**建立警示**。