AWS CodeBuild
用户指南 (API 版本 2016-10-06)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

监控 AWS CodeBuild

可以使用 Amazon CloudWatch 监控构建,在出现问题时报告以及视情况执行自动操作。可以监控两个级别的构建:

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

  • AWS 账户级别:这些指标适用于一个账户中的所有构建。要查看 AWS 账户级别的指标,请勿在 CloudWatch 中输入维度。

CloudWatch 指标显示构建随着时间推移的行为。例如,可以监控:

  • 构建项目或 AWS 账户中随着时间推移尝试过多少次构建。

  • 构建项目或 AWS 账户中随着时间推移成功过多少次构建。

  • 构建项目或 AWS 账户中随着时间推移失败过多少次构建。

  • CodeBuild 在构建项目或 AWS 账户中随着时间推移花费过多少时间执行构建。

CodeBuild 控制台中显示的指标始终为过去三天的指标。您可以使用 CloudWatch 控制台查看不同持续时间内的 CodeBuild 指标。

有关创建适用于 CodeBuild 的 CloudWatch 指标的信息,请参阅使用 CloudWatch 指标监控构建

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 统计数据:平均值(建议)、最大值、最小值

SubmittedDuration

测量构建的 SUBMITTED 阶段的持续时间。

单位:秒

有效 CloudWatch 统计数据:平均值(建议)、最大值、最小值

SucceededBuilds

测量成功构建的数量。

单位:计数

有效 CloudWatch 统计数据:总计

UploadArtifactsDuration

测量构建的 UPLOAD_ARTIFACTS 阶段的持续时间。

单位:秒

有效 CloudWatch 统计数据:平均值(建议)、最大值、最小值

CodeBuild CloudWatch 维度

ProjectName 是唯一的 AWS CodeBuild 指标维度。如果指定了此维度,则指标适用于对应项目。如果未指定此维度,则指标适用于当前 AWS 账户。

CodeBuild CloudWatch 警报

您可以使用 CloudWatch 控制台基于 CodeBuild 指标创建警报,以便可在构建出错时做出反应。两个最有用的警报指标如下:

  • FailedBuild。可以创建在预先确定的秒数内检测到特定数量的失败构建时触发的警报。在 CloudWatch 中,指定秒数以及将触发警报的失败构建数量。

  • Duration。可以创建在构建所用时间长于预期时触发的警报。指定在启动构建之后、完成构建之前必须经历多少秒才会触发警报。

有关如何为 CodeBuild 指标创建警报的信息,请参阅使用 CloudWatch 警报监控构建。有关警报的更多信息,请参阅创建 Amazon CloudWatch 警报