AWS CodeBuild

Overview

AWS CodeBuild is a build service that compiles source code, runs tests, and produces software packages that are ready to deploy.

Install the Datadog AWS CodeBuild integration to:

  • Track your builds by project
  • Collect metrics on your builds
  • Correlate builds with the rest of your Datadog metrics

Setup

Installation

If you haven’t already, set up the Amazon Web Services integration first.

Metric collection

  1. In the AWS integration page, ensure that CloudBuild is enabled under the Metric Collection tab.

  2. Install the Datadog - AWS CodeBuild integration.

Log collection

Enable logging

Configure AWS CodeBuild to send logs either to a S3 bucket or to CloudWatch.

Note: If you log to a S3 bucket, make sure that amazon_codebuild is set as Target prefix.

Send logs to Datadog

  1. If you haven’t already, set up the Datadog Forwarder Lambda function.

  2. Once the Lambda function is installed, manually add a trigger on the S3 bucket or CloudWatch log group that contains your AWS CodeBuild logs in the AWS console:

Data Collected

Metrics

aws.codebuild.build_duration
(gauge)		Measures the duration of the build's BUILD phase.
Shown as second
aws.codebuild.builds
(count)		Measures the number of builds triggered.
Shown as build
aws.codebuild.download_source_duration
(gauge)		Measures the duration of the build's DOWNLOAD_SOURCE phase.
Shown as second
aws.codebuild.duration
(gauge)		Measures the total duration of all builds over time.
Shown as second
aws.codebuild.duration.maximum
(gauge)		Measures the maximum duration of all the builds over time.
Shown as second
aws.codebuild.duration.minimum
(gauge)		Measures the minimum duration of all the builds over time.
Shown as second
aws.codebuild.failed_builds
(count)		Measures the number of failed builds because of client error or timeouts.
Shown as build
aws.codebuild.finalizing_duration
(gauge)		Measures the duration of the build's FINALIZING phase.
Shown as second
aws.codebuild.install_duration
(gauge)		Measures the duration of the build's INSTALL phase.
Shown as second
aws.codebuild.post_build_duration
(gauge)		Measures the duration of the build's POST_BUILD phase
Shown as second
aws.codebuild.pre_build_duration
(gauge)		Measures the duration of the build's PRE_BUILD phase.
Shown as second
aws.codebuild.provisioning_duration
(gauge)		Measures the duration of the build's PROVISIONING phase.
Shown as second
aws.codebuild.queued_duration
(gauge)		Measures the duration of the build's QUEUED phase.
Shown as second
aws.codebuild.submitted_duration
(gauge)		Measures the duration of the build's SUBMITTED phase.
Shown as second
aws.codebuild.succeeded_builds
(count)		Measures the number of successful builds.
Shown as build
aws.codebuild.upload_artifacts_duration
(gauge)		Measures the duration of the build's UPLOAD_ARTIFACTS phase.
Shown as second

Events

The AWS CodeBuild integration does not include any events.

Service Checks

The AWS CodeBuild integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.