AWS CodeBuild
User Guide (API Version 2016-10-06)

A new console design is available for this service. Although the procedures in this guide were written for the older version of the console, you will find many of the concepts and basic procedures in this guide still apply.

Monitoring Builds with CloudWatch Metrics

AWS CodeBuild monitors functions on your behalf and reports metrics through Amazon CloudWatch. These metrics include the number of total builds, failed builds, successful builds, and the duration of builds.

You can use the AWS CodeBuild console or the CloudWatch console to monitor metrics for AWS CodeBuild. The following procedures show you how to access metrics.

Access Build Metrics (AWS CodeBuild Console)

The graphs in the AWS CodeBuild console show three days of metrics. You cannot customize the metrics or the graphs used to display them. Use the Amazon CloudWatch console to view your build metrics if you want to modify them.

To access AWS account level metrics

  1. Sign in to the AWS Management Console and open the AWS CodeBuild console at https://console.aws.amazon.com/codebuild/.

  2. In the navigation pane, choose Account metrics.

To access project level metrics

  1. Sign in to the AWS Management Console and open the AWS CodeBuild console at https://console.aws.amazon.com/codebuild/.

  2. In the navigation pane, choose Build projects.

  3. In the list of build projects, in the Project column, choose the project for which you want to view metrics.

  4. Choose the Project metrics tab.

Access Build Metrics (Amazon CloudWatch Console)

You can customize the metrics and the graphs used to display them.

To access account level metrics

  1. Sign in to the AWS Management Console and open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/.

  2. In the navigation pane, choose Metrics.

  3. On the All metrics tab, choose CodeBuild.

  4. Choose the Account Metrics.

  5. Choose one or more projects and metrics. For each project, you can choose the SucceededBuilds, FailedBuilds, Builds, and Duration metrics. All selected project and metric combinations are displayed in the graph on the page.

To access project level metrics

  1. Sign in to the AWS Management Console and open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/.

  2. In the navigation pane, choose Metrics.

  3. On the All metrics tab, choose CodeBuild.

  4. Choose By Project.

  5. Choose one or more project and metric combinations. For each project, you can choose the SucceededBuilds, FailedBuilds, Builds, and Duration metrics. All selected project and metric combinations are displayed in the graph on the page.

  6. (Optional) You can customize your metrics and graphs. For example, from the drop-down list in the Statistic columm, you can choose a different statistic to display. Or from the drop-down menu in the Period column, you can choose a different time period to use to monitor the metric's . For more information about configuring graphs, see Graph Metrics. For more information about metrics, see View Available Metrics.