---
title: CircleCI
description: >-
  CircleCI's platform makes it easy to rapidly build and release quality
  software.
breadcrumbs: Docs > Integrations > CircleCI
---

# CircleCI
Integration version1.0.0Synthetics
## Overview{% #overview %}

Connect to CircleCI to:

- Visualize key CircleCI metrics such as the number of finished builds or the average build time.
- Analyze data (such as splitting builds by job name or repository) using Datadog's tag system.
- View orb workflow data in Synthetics
- Collect and ingest CircleCI job logs into DataDog

For more in-depth monitoring of your CircleCI pipelines, check out [CI Pipeline Visibility](https://app.datadoghq.com/ci/getting-started). CI Pipeline Visibility provides granular insights into your user workflow, lets you access detailed Git metadata, and tracks pipeline performance over time.

## Setup{% #setup %}

### Installation{% #installation %}

You can install the CircleCI integration with its [integration tile](https://app.datadoghq.com/integrations/circleci).

### Configuration{% #configuration %}

1. In your CircleCI settings, go to Personal API Tokens and enter the generated key in the form. The name does not need to be the same as the CircleCI label, but it has to be unique.
1. Filter the repositories using an expression such as "Organization/repo*name", "Organization/repo*\*" or "Organization/*". **The filtering is made on the list of tracked projects, which must be set up on the CircleCI side.**
1. Specify the appropriate version control system and reference the appropriate API key.
1. If you enable log collection for a repo, you must make sure that its pipelines are being sent to DataDog CI Visibility. Follow the instructions in [Set up Tracing on a CircleCI Workflow](https://docs.datadoghq.com/continuous_integration/pipelines/circleci/).

Multiple API tokens can be set, and multiple projects can be tracked for one given token. Users must be set as contributors for a particular repo in order to see that repo's information in Datadog.

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

|  |
|  |
| **circleci.completed\_build\_time.sum**(count) | Total build time of completed (not canceled) builds*Shown as millisecond*   |
| **circleci.completed\_build\_time.avg**(gauge) | Average build time of completed (not canceled) builds*Shown as millisecond* |
| **circleci.finished\_builds.count**(count)     | Count of all finished builds*Shown as build*                                |
| **circleci.completed\_builds.count**(count)    | Count of all completed (not canceled) builds*Shown as build*                |

### Events{% #events %}

The CircleCI integration does not include any events.

### Service Checks{% #service-checks %}

The CircleCI integration does not include any service checks.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).

## Further Reading{% #further-reading %}

- [Monitor your CircleCI environment with Datadog](https://www.datadoghq.com/blog/circleci-monitoring-datadog/)