本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
监控 AWS CodeBuild
可以使用 Amazon CloudWatch 监控构建，在出现问题时报告以及视情况执行自动操作。可以监控两个级别的构建：
- 项目级别
-
这些指标适用于指定项目中的所有构建。要查看项目的指标，请为 CloudWatch 中的维度指定
ProjectName。 - AWS 账户级别
-
这些指标适用于一个账户中的所有构建。要查看 AWS 账户级别的指标，请勿在 CloudWatch 中输入维度。构建资源利用率指标在 AWS 账户级别不可用。
CloudWatch 指标显示构建随着时间推移的行为。例如，可以监控：
-
构建项目或 AWS 账户中随着时间推移尝试过多少次构建。
-
构建项目或 AWS 账户中随着时间推移成功过多少次构建。
-
构建项目或 AWS 账户中随着时间推移失败过多少次构建。
-
CodeBuild 在构建项目或 AWS 账户中随着时间推移花费过多少时间运行构建。
-
构建或整个构建项目的构建资源利用率。构建资源利用率指标包括 CPU、内存和存储利用率等指标。
有关更多信息，请参阅监控 CodeBuild 指标。
CodeBuild CloudWatch 指标
可按 AWS 账户或构建项目跟踪以下指标。
- 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 统计数据：平均值（建议）、最大值、最小值
- 提交时长
-
测量构建的
SUBMITTED阶段的持续时间。单位：秒
有效 CloudWatch 统计数据：平均值（建议）、最大值、最小值
- SucceededBuilds
-
测量成功构建的数量。
单位：计数
有效的 CloudWatch 统计数据：总计
- UploadArtifactsDuration
-
测量构建的
UPLOAD_ARTIFACTS阶段的持续时间。单位：秒
有效 CloudWatch 统计数据：平均值（建议）、最大值、最小值
CodeBuild CloudWatch 资源利用率指标
注意
CodeBuild 资源利用率指标仅适用于以下区域：
-
亚太地区（东京）区域
-
亚太地区（首尔）区域
-
亚太地区（孟买）区域
-
亚太地区（新加坡）区域
-
亚太地区（悉尼）区域
-
加拿大（中部）区域
-
欧洲地区（法兰克福）区域
-
欧洲地区（爱尔兰）区域
-
欧洲地区（伦敦）区域
-
欧洲（巴黎）区域
-
南美洲（圣保罗）区域
-
美国东部（弗吉尼亚州北部）区域
-
美国东部（俄亥俄州）区域
-
美国西部（加利福尼亚北部）区域
-
美国西部（俄勒冈州）区域
可以跟踪以下资源利用率指标。
- 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 指标创建警报，以便可在构建出错时做出反应。两个最有用的警报指标如下：
-
FailedBuild。可以创建在预先确定的秒数内检测到特定数量的失败构建时触发的警报。在 CloudWatch 中，指定秒数以及将触发警报的失败构建数量。 -
Duration。可以创建在构建所用时间长于预期时触发的警报。指定在启动构建之后、完成构建之前必须经历多少秒才会触发警报。
有关如何为 CodeBuild 指标创建警报的信息，请参阅使用 CloudWatch 警报监控构建。有关警报的更多信息，请参阅的《Amazon CloudWatch 用户指南》中的创建 Amazon CloudWatch 警报。
