本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

您可以使用 Amazon CloudWatch 来监视您的构建，在出现问题时进行报告，并在适当时自动采取行动。可以监控两个级别的构建：

项目级别  
这些指标适用于指定项目中的所有构建。要查看项目的指标，请为 CloudWatch 中的维度指定 `ProjectName`。

AWS 账户等级  
这些指标适用于一个账户中的所有构建。要查看 AWS 账户级别的指标，请勿在 CloudWatch 中输入维度。构建资源利用率指标在 AWS 账户级别不可用。

CloudWatch 指标显示您的版本在一段时间内的行为。例如，可以监控：
+  随着时间的推移，在构建项目或 AWS 账户中尝试了多少次构建。
+  随着时间的推移，在构建项目或 AWS 账户中成功构建了多少版本。
+  一段时间内，一个构建项目或一个 AWS 账户中有多少构建失败。
+  随着时间的推移，在构建项目或 AWS 帐号中运行构建所 CodeBuild 花费的时间。
+ 构建或整个构建项目的构建资源利用率。构建资源利用率指标包括 CPU、内存和存储利用率等指标。

 有关更多信息，请参阅 [查看 CodeBuild 指标](monitoring-metrics.md)。

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

 可以按 AWS 账号或构建项目跟踪以下指标。有关 CloudWatch与一起使用的更多信息 CodeBuild，请参阅[使用监控 CodeBuild 构建 CloudWatch](monitoring-builds.md)。

BuildDuration  
测量构建的 `BUILD` 阶段的持续时间。  
单位：秒  
有效 CloudWatch 统计数据：平均值（推荐）、最大值、最小值

Builds  
 测量所触发构建的数量。  
 单位：计数   
 有效 CloudWatch 统计数据：总和 

DownloadSourceDuration  
测量构建的 `DOWNLOAD_SOURCE` 阶段的持续时间。  
单位：秒  
有效 CloudWatch 统计数据：平均值（推荐）、最大值、最小值

Duration  
 测量随着时间的推移所有构建的持续时间。  
 单位：秒   
 有效 CloudWatch 统计数据：平均值（推荐）、最大值、最小值 

FailedBuilds  
 测量因为客户端错误或超时而失败的构建的数量。  
 单位：计数   
 有效 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  
 测量成功构建的数量。  
 单位：计数   
 有效 CloudWatch 统计数据：总和 

UploadArtifactsDuration  
测量构建的 `UPLOAD_ARTIFACTS` 阶段的持续时间。  
单位：秒  
有效 CloudWatch 统计数据：平均值（推荐）、最大值、最小值

# CodeBuild CloudWatch 资源利用率指标
<a name="cloudwatch-utilization-metrics"></a>

**注意**  
CodeBuild 资源利用率指标仅在以下区域可用：  
亚太地区（东京）区域
亚太地区（首尔）区域
亚太地区（孟买）区域
亚太地区（新加坡）区域
亚太地区（悉尼）区域
加拿大（中部）区域
欧洲地区（法兰克福）区域
欧洲地区（爱尔兰）区域
欧洲地区（伦敦）区域
欧洲地区（巴黎）区域
南美洲（圣保罗）区域
US East (N. Virginia) Region
美国东部（俄亥俄州）区域
美国西部（北加利福尼亚）区域
美国西部（俄勒冈州）区域

可以跟踪以下资源利用率指标。有关 CloudWatch与一起使用的更多信息 CodeBuild，请参阅[使用监控 CodeBuild 构建 CloudWatch](monitoring-builds.md)。

CPUUtilized  
构建容器使用的分配的 CPU 处理单元数量。  
单位：CPU 单元数量  
有效 CloudWatch 统计数据：平均值（推荐）、最大值、最小值

CPUUtilized百分比  
构建容器使用的分配的处理单元所占百分比。  
单位：百分比  
有效 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 指标创建警报，以便在构建出现问题时做出反应。以下要点说明了对警报最有用的两个指标。有关 CloudWatch与一起使用的更多信息 CodeBuild，请参阅[使用监控 CodeBuild 构建 CloudWatch](monitoring-builds.md)。
+  `FailedBuild`。可以创建在预先确定的秒数内检测到特定数量的失败构建时触发的警报。在中 CloudWatch，您可以指定秒数以及有多少失败的生成会触发警报。
+  `Duration`。可以创建在构建所用时间长于预期时触发的警报。指定在启动构建之后、完成构建之前必须经历多少秒才会触发警报。

 有关如何为 CodeBuild 指标创建警报的信息，请参阅[使用 CloudWatch 警报监控 CodeBuild 构建](monitoring-alarms.md)。有关警报的更多信息，请参阅[亚马逊* CloudWatch 用户指南中的创建亚马逊 CloudWatch *警报](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)。

# 查看 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://console.aws.amazon.com/codesuite/codebuild](https://console.aws.amazon.com/codesuite/codebuild/home) /hom AWS CodeBuild e 中打开控制台。

1.  在导航窗格中，选择**账户指标**。

### 项目级别指标
<a name="codebuild-console-project-level-metrics"></a><a name="cw-project-codebuild-console"></a>

**查看项目级别指标**

1. 登录 AWS 管理控制台 并在 [https://console.aws.amazon.com/codesuite/codebuild](https://console.aws.amazon.com/codesuite/codebuild/home) /hom AWS CodeBuild e 中打开控制台。

1.  在导航窗格中，选择**构建项目**。

1.  在构建项目列表中的**名称**列中，选择要查看其指标的项目。

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 管理控制台 并打开 CloudWatch 控制台，网址为[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)。

1.  在导航窗格中，选择**指标**。

1.  在**全部指标**选项卡上，选择 **CodeBuild**。  
![\[如何查看 CodeBuild 指标。\]](http://docs.aws.amazon.com/zh_cn/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)

1.  选择**账户指标**。

1.  选择一个或多个项目和指标。对于每个项目，您可以选择**SucceededBuilds**、**FailedBuilds**、**生成**和**持续时间**指标。此页面上的图表中将显示所有选定项目和指标组合。

### 项目级别指标
<a name="cloudwatch-console-project-level-metrics"></a><a name="cw-project-cloudwatch-console"></a>

**查看项目级别指标**

1. 登录 AWS 管理控制台 并打开 CloudWatch 控制台，网址为[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)。

1.  在导航窗格中，选择**指标**。

1.  在**全部指标**选项卡上，选择 **CodeBuild**。  
![\[如何查看 CodeBuild 指标。\]](http://docs.aws.amazon.com/zh_cn/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)

1.  选择**按项目**。

1.  选择一个或多个项目和指标组合。对于每个项目，您可以选择**SucceededBuilds**、**FailedBuilds**、**生成**和**持续时间**指标。此页面上的图表中将显示所有选定项目和指标组合。

1.  （可选）可以自定义指标和图表。例如，从**统计数据**列的下拉列表中，可以选择要显示的不同统计数据。或从**周期**列的下拉菜单中，可以选择要用于监控指标的不同时间段。

   有关更多信息，请参阅 *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 资源利用率指标仅在以下区域可用：  
亚太地区（东京）区域
亚太地区（首尔）区域
亚太地区（孟买）区域
亚太地区（新加坡）区域
亚太地区（悉尼）区域
加拿大（中部）区域
欧洲地区（法兰克福）区域
欧洲地区（爱尔兰）区域
欧洲地区（伦敦）区域
欧洲地区（巴黎）区域
南美洲（圣保罗）区域
US East (N. Virginia) Region
美国东部（俄亥俄州）区域
美国西部（北加利福尼亚）区域
美国西部（俄勒冈州）区域

以下过程演示如何访问您的资源利用率指标。

**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://console.aws.amazon.com/codesuite/codebuild](https://console.aws.amazon.com/codesuite/codebuild/home) /hom AWS CodeBuild e 中打开控制台。

1. 在导航窗格中，选择**构建项目**。

1. 在构建项目列表中的**名称**列中，选择要查看其利用率指标的项目。

1. 请选择**指标**选项卡。资源利用率指标显示在**资源利用率指标**部分。

1. 要在 CloudWatch控制台中查看项目级别的资源利用率指标，请在 “**资源利用率指标**” **部分 CloudWatch中选择 “查看**”。

### 构建级别资源利用率指标
<a name="codebuild-console-build-level-utilization"></a>

**要访问构建级别资源利用率指标**

1. 登录 AWS 管理控制台 并在 [https://console.aws.amazon.com/codesuite/codebuild](https://console.aws.amazon.com/codesuite/codebuild/home) /hom AWS CodeBuild e 中打开控制台。

1. 在导航窗格中，选择**构建历史记录**。

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 管理控制台 并打开 CloudWatch 控制台，网址为[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)。

1. 在导航窗格中，选择**指标**。

1. 在**全部指标**选项卡上，选择 **CodeBuild**。  
![\[控制台屏幕截图显示了位于 “所有指标” 选项卡上的 CodeBuild 选项。\]](http://docs.aws.amazon.com/zh_cn/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)

1. 选择**按项目**。

1. 选择一个或多个项目和指标组合，以添加到图表中。此页面上的图表中将显示所有选定项目和指标组合。

1. （可选）您可以在**绘成图表的指标**选项卡中自定义指标和图表。例如，从**统计数据**列的下拉列表中，可以选择要显示的不同统计数据。或从**周期**列的下拉菜单中，可以选择要用于监控指标的不同时间段。

   有关更多信息，请参阅 *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 管理控制台 并打开 CloudWatch 控制台，网址为[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)。

1. 在导航窗格中，选择**指标**。

1. 在**全部指标**选项卡上，选择 **CodeBuild**。  
![\[控制台屏幕截图显示了位于 “所有指标” 选项卡上的 CodeBuild 选项。\]](http://docs.aws.amazon.com/zh_cn/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)

1. 选择**BuildId、 BuildNumber、 ProjectName**。

1. 选择一个或多个构建和指标组合，以添加到图表中。此页面上的图表中将显示所有选定构建和指标组合。

1. （可选）您可以在**绘成图表的指标**选项卡中自定义指标和图表。例如，从**统计数据**列的下拉列表中，可以选择要显示的不同统计数据。或从**周期**列的下拉菜单中，可以选择要用于监控指标的不同时间段。

   有关更多信息，请参阅 *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 时支持的任何操作。例如，可以指定 15 分钟内如果账户中有三个以上的构建失败，则发送 Amazon SNS 通知。

**为 CodeBuild 指标创建 CloudWatch 警报**

1. 登录 AWS 管理控制台 并打开 CloudWatch 控制台，网址为[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)。

1.  在导航窗格中，选择**告警**。

1.  选择**创建告警**。

1.  在 “**按类别划分的CloudWatch 指标**” 下，选择**CodeBuild指标**。如果您知道您只需要项目级别指标，则选择**按项目**。如果您知道您只需要账户级别指标，则选择**账户指标**。

1.  在**创建警报**上，请选择**选择指标**（如果尚未选择）。

1.  选择要为之创建警报的指标。选项为**按项目**或**账户指标**。

1.  选择**下一步**或**定义警报**，然后创建警报。有关更多信息，请参阅[亚马逊* 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)。

1.  选择**创建警报**。