本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 在 中記錄和監控 AWS CodeBuild 記錄和監控是維護 和 AWS 解決方案的可靠性、可用性 AWS CodeBuild 和效能的重要部分。您應該從 AWS 解決方案的所有部分收集監控資料，以便在發生多點故障時更輕鬆地偵錯。 AWS 提供下列工具來監控 CodeBuild 資源和組建，以及回應潛在事件。 **Topics** + [使用 記錄 AWS CodeBuild API 呼叫 AWS CloudTrail](cloudtrail.md) + [使用 CloudWatch 監控 CodeBuild 建置](monitoring-builds.md) # 使用 記錄 AWS CodeBuild API 呼叫 AWS CloudTrail AWS CodeBuild 已與 服務整合 AWS CloudTrail，此服務提供由使用者、角色或 CodeBuild 中的 AWS 服務所採取之動作的記錄。CloudTrail 會將 CodeBuild 的所有 API 呼叫擷取為事件，包括從 CodeBuild 主控台以及從程式碼呼叫到 CodeBuild APIs呼叫。如果您建立線索，則可以將 CloudTrail 事件持續交付至 S3 儲存貯體，包括 CodeBuild 的事件。即使您未設定追蹤，依然可以透過 CloudTrail 主控台中的**事件歷史記錄**檢視最新事件。您可以使用 CloudTrail 所收集的資訊，判斷對 CodeBuild 提出的請求、提出請求的 IP 地址、提出請求的人員、提出請求的時間，以及其他詳細資訊。 若要進一步了解 CloudTrail，請參閱[「AWS CloudTrail 使用者指南」](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)。 **Topics** + [關於 CloudTrail 中 AWS CodeBuild 的資訊](service-name-info-in-cloudtrail.md) + [關於 AWS CodeBuild 日誌檔案項目](understanding-service-name-entries.md) # 關於 CloudTrail 中 AWS CodeBuild 的資訊 當您建立 AWS 帳戶時，會在您的帳戶上啟用 CloudTrail。當活動在 CodeBuild 中發生時，該活動會與**事件歷史記錄**中的其他 AWS 服務事件一起記錄在 CloudTrail 事件中。您可以在 AWS 帳戶中檢視、搜尋和下載最近的事件。如需詳細資訊，請參閱 *AWS CloudTrail 使用者指南*中的 [使用 CloudTrail 事件歷史記錄檢視事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)。 若要持續記錄您 AWS 帳戶中的事件，包括 CodeBuild 的事件，請建立追蹤。線索可讓 CloudTrail 將日誌檔案傳遞到 S3 儲存貯體。根據預設，當您在主控台建立追蹤時，權杖會套用到所有區域。線索會記錄 AWS 分割區中所有區域的事件，並將日誌檔案傳送到您指定的 S3 儲存貯體。您可以設定其他 AWS 服務，以進一步分析和處理 CloudTrail 日誌中收集的事件資料。如需詳細資訊，請參閱： + [建立追蹤的概觀](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) + [CloudTrail 支援的服務和整合](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations) + [設定 CloudTrail 的 Amazon SNS 通知](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html) + [接收多個區域的 CloudTrail 日誌檔案](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)和[接收多個帳戶的 CloudTrail 日誌檔案](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) CloudTrail 會記錄所有 CodeBuild 動作，並記錄在 [CodeBuild API 參考](https://docs.aws.amazon.com/codebuild/latest/APIReference/)中。例如，對 `CreateProject`（在 、 中`create-project`) AWS CLI、 `StartBuild` （在 AWS CLI、 中`start-project`) 和 `UpdateProject`（在 AWS CLI中`update-project`) 動作的呼叫會在 CloudTrail 日誌檔案中產生項目。 每一筆事件或日誌專案都會包含產生請求者的資訊。身分資訊可協助您判斷下列事項： + 該請求是否使用根或使用者憑證提出。 + 提出該請求時，是否使用了特定角色或聯合身分使用者的暫時安全憑證。 + 請求是否由其他 AWS 服務提出。 如需詳細資訊，請參閱*AWS CloudTrail 《 使用者指南*》中的 [CloudTrail userIdentity 元素](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)。 # 關於 AWS CodeBuild 日誌檔案項目 權杖是一種組態，能讓事件以日誌檔案的形式交付至您指定的 S3 儲存貯體。CloudTrail 日誌檔案包含一個或多個日誌項目。一個事件為任何來源提出的單一請求，並包含請求動作、請求的日期和時間、請求參數等資訊。CloudTrail 日誌檔案並非依公有 API 呼叫追蹤記錄的堆疊排序，因此不會以任何特定順序出現。 **注意** 為了保護敏感資訊，CodeBuild 日誌中會隱藏下列項目： AWS 存取金鑰 IDs。如需詳細資訊，請參閱*AWS Identity and Access Management 《 使用者指南*》中的[管理 IAM 使用者的存取金鑰](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html)。 使用參數存放區指定的字串。如需詳細資訊，請參閱《*Amazon EC2 Systems Manager 使用者指南*》中的 [Systems Manager 參數存放區](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-paramstore.html)和 [Systems Manager 參數存放區主控台演練](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-walk.html#sysman-paramstore-console)。 使用 指定的字串 AWS Secrets Manager。如需詳細資訊，請參閱[金鑰管理](security-key-management.md)。 下列範例顯示 CloudTrail 日誌項目，示範在 CodeBuild 中建立組建專案。 ``` { "eventVersion": "1.05", "userIdentity": { "type": "FederatedUser", "principalId": "account-ID:user-name", "arn": "arn:aws:sts::account-ID:federated-user/user-name", "accountId": "account-ID", "accessKeyId": "access-key-ID", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2016-09-06T17:59:10Z" }, "sessionIssuer": { "type": "IAMUser", "principalId": "access-key-ID", "arn": "arn:aws:iam::account-ID:user/user-name", "accountId": "account-ID", "userName": "user-name" } } }, "eventTime": "2016-09-06T17:59:11Z", "eventSource": "codebuild.amazonaws.com", "eventName": "CreateProject", "awsRegion": "region-ID", "sourceIPAddress": "127.0.0.1", "userAgent": "user-agent", "requestParameters": { "awsActId": "account-ID" }, "responseElements": { "project": { "environment": { "image": "image-ID", "computeType": "BUILD_GENERAL1_SMALL", "type": "LINUX_CONTAINER", "environmentVariables": [] }, "name": "codebuild-demo-project", "description": "This is my demo project", "arn": "arn:aws:codebuild:region-ID:account-ID:project/codebuild-demo-project:project-ID", "encryptionKey": "arn:aws:kms:region-ID:key-ID", "timeoutInMinutes": 10, "artifacts": { "location": "arn:aws:s3:::codebuild-region-ID-account-ID-output-bucket", "type": "S3", "packaging": "ZIP", "outputName": "MyOutputArtifact.zip" }, "serviceRole": "arn:aws:iam::account-ID:role/CodeBuildServiceRole", "lastModified": "Sep 6, 2016 10:59:11 AM", "source": { "type": "GITHUB", "location": "https://github.com/my-repo.git" }, "created": "Sep 6, 2016 10:59:11 AM" } }, "requestID": "9d32b228-745b-11e6-98bb-23b67EXAMPLE", "eventID": "581f7dd1-8d2e-40b0-aeee-0dbf7EXAMPLE", "eventType": "AwsApiCall", "recipientAccountId": "account-ID" } ``` # 使用 CloudWatch 監控 CodeBuild 建置 您可以使用 Amazon CloudWatch 來監看您的建置、在發生錯誤時回報，以及適時採取自動動作。您可以在兩個層級監控組建： 專案層級 這些指標適用於指定專案中的所有組建。若要查看專案的指標，請在 CloudWatch 中`ProjectName`為維度指定 。 AWS 帳戶層級 這些指標適用於 帳戶中的所有組建。若要查看帳戶層級的 AWS 指標，請勿在 CloudWatch 中輸入維度。 AWS 帳戶層級無法使用建置資源使用率指標。 CloudWatch 指標會顯示您建置隨時間經過的行為。例如，您可以監控： + 隨著時間的推移，在組建專案或 AWS 帳戶中嘗試了多少組建。 + 隨著時間的推移，組建專案或 AWS 帳戶中有多少組建成功。 + 隨著時間的推移，組建專案或 AWS 帳戶中有多少組建失敗。 + CodeBuild 隨著時間在組建專案或 AWS 帳戶中執行組建所花費的時間。 + 建置建置或整個建置專案的資源使用率。建置資源使用率指標包括 CPU、記憶體和儲存使用率等指標。 如需詳細資訊，請參閱[檢視 CodeBuild 指標](monitoring-metrics.md)。 # CodeBuild CloudWatch 指標 您可以追蹤每個 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 資源使用率指標 **注意** 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 維度 CodeBuild 提供下列 CloudWatch 指標維度。如果未指定這些指標，則指標適用於目前 AWS 帳戶。 BuildId、 BuildNumber、ProjectName 提供建置識別符、建置編號和專案名稱的指標。 ProjectName 為專案名稱提供指標。 # CodeBuild CloudWatch 警示 您可以使用 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 指標 AWS CodeBuild 會代表您監控 函數，並透過 Amazon CloudWatch 報告指標。這些指標包含建置總數、失敗建置和成功建置，以及建置持續時間。 您可以使用 CodeBuild 主控台或 CloudWatch 主控台來監控 CodeBuild 的指標。下列程序說明如何檢視指標。 **Topics** + [檢視建置指標 (CodeBuild 主控台）](#metrics-in-codebuild-console) + [檢視建置指標 (Amazon CloudWatch 主控台）](#metrics-in-cloudwatch-console) ## 檢視建置指標 (CodeBuild 主控台） **注意** 您無法自訂用於在 CodeBuild 主控台中顯示指標的指標或圖形。如果您想要自訂顯示，請使用 Amazon CloudWatch 主控台來檢視您的建置指標。 ### 帳戶層級指標 **檢視 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 (帳戶指標)**。 ### 專案層級指標 **檢視專案層級指標** 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 主控台） 您可以使用 CloudWatch 主控台自訂指標和用來顯示指標的圖形。 ### 帳戶層級指標 **檢視帳戶層級指標** 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** 指標。所有選取的專案和指標組合都會顯示在頁面的圖形中。 ### 專案層級指標 **檢視專案層級指標** 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 資源使用率指標 AWS CodeBuild 會代表您監控建置資源使用率，並透過 Amazon CloudWatch 報告指標。這些包括 CPU、記憶體和儲存使用率等指標。 **注意** CodeBuild 資源使用率指標只會針對執行超過一分鐘的組建進行記錄。 您可以使用 CodeBuild 主控台或 CloudWatch 主控台來監控 CodeBuild 的資源使用率指標。 **注意** CodeBuild 資源使用率指標僅適用於下列區域： 亞太區域 (東京) 區域 亞太區域 (首爾) 區域 亞太地區 (孟買) 區域 亞太區域 (新加坡) 區域 亞太區域 (雪梨) 區域 加拿大 (中部) 區域 歐洲 (法蘭克福) 區域 歐洲 (愛爾蘭) 區域 歐洲 (倫敦) 區域 歐洲 (巴黎) 區域 南美洲 (聖保羅) 區域 美國東部 (維吉尼亞北部) 區域 美國東部 (俄亥俄) 區域 美國西部 (加利佛尼亞北部) 區域 美國西部 (奧勒岡) 區域 下列程序說明如何存取資源使用率指標。 **Topics** + [存取資源使用率指標 (CodeBuild 主控台）](#utilization-metrics-codebuild-console) + [存取資源使用率指標 (Amazon CloudWatch 主控台）](#utilization-metrics-cloudwatch-console) ## 存取資源使用率指標 (CodeBuild 主控台） **注意** 您無法自訂用於在 CodeBuild 主控台中顯示指標的指標或圖形。如果您想要自訂顯示，請使用 Amazon CloudWatch 主控台來檢視您的建置指標。 ### 專案層級資源使用率指標 **存取專案層級的資源使用率指標** 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 中檢視**。 ### 建置層級資源使用率指標 **存取建置層級資源使用率指標** 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 主控台） Amazon CloudWatch 主控台可用來存取 CodeBuild 資源使用率指標。 ### 專案層級資源使用率指標 **存取專案層級的資源使用率指標** 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)。 ### 建置層級資源使用率指標 **存取建置層級資源使用率指標** 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 組建 您可以為組建建立 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. 選擇**建立警示**。