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
In the AWS integration page, ensure that CodeBuild is enabled under the Metric Collection tab.
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
If you haven’t already, set up the Datadog Forwarder Lambda function.
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.
