本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
监控 Amazon CodeBuild
可以使用 Amazon CloudWatch 监控构建,在出现问题时报告以及视情况执行自动操作。可以监控两个级别的构建:
- 项目级别
-
这些指标适用于指定项目中的所有构建。要查看项目的指标,请为 CloudWatch 中的维度指定
ProjectName
。 - Amazon 账户级别
-
这些指标适用于一个账户中的所有构建。要查看 Amazon 账户级别的指标,请勿在 CloudWatch 中输入维度。构建资源利用率指标在 Amazon 账户级别不可用。
CloudWatch 指标显示构建随着时间推移的行为。例如,可以监控:
-
构建项目或 Amazon 账户中随着时间推移尝试过多少次构建。
-
构建项目或 Amazon 账户中随着时间推移成功过多少次构建。
-
构建项目或 Amazon 账户中随着时间推移失败过多少次构建。
-
CodeBuild 在构建项目或 Amazon 账户中随着时间推移花费过多少时间运行构建。
-
构建或整个构建项目的构建资源利用率。构建资源利用率指标包括 CPU、内存和存储利用率等指标。
有关更多信息,请参阅监控 CodeBuild 指标。
CodeBuild CloudWatch 指标
可按 Amazon 账户或构建项目跟踪以下指标。
- 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 提供以下 CloudWatch 指标维度。如果未指定这些维度,则指标适用于当前 Amazon 账户。
- BuildId、BuildNumber、ProjectName
-
提供针对构建标识符、内部版本号和项目名称的指标。
- ProjectName
-
提供针对项目名称的指标。
CodeBuild CloudWatch 警报
您可以使用 CloudWatch 控制台基于 CodeBuild 指标创建警报,以便可在构建出错时做出反应。两个最有用的警报指标如下:
-
FailedBuild
。可以创建在预先确定的秒数内检测到特定数量的失败构建时触发的警报。在 CloudWatch 中,指定秒数以及将触发警报的失败构建数量。 -
Duration
。可以创建在构建所用时间长于预期时触发的警报。指定在启动构建之后、完成构建之前必须经历多少秒才会触发警报。
有关如何为 CodeBuild 指标创建警报的信息,请参阅使用 CloudWatch 警报监控构建。有关警报的更多信息,请参阅的《Amazon CloudWatch 用户指南》中的创建 Amazon CloudWatch 警报。