监控 Amazon CodeBuild - Amazon CodeBuild
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

监控 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 警报