# CircleCI

## About the integration

CircleCI is a modern continuous integration and continuous delivery (CI/CD) platform. It allows you to build, test, and deploy your application using automated jobs that are triggered manually or as a consequence of various interactions with connected code repository.

It is assumed you already have an active CircleCI account and a repository with a working CircleCI configuration.

## Setting up the integration

Refer to the [general instructions on adding CircleCI integration](https://help.sleuth.io/integrations-1/builds/circleci).

You should also add at least one [Code deployment](https://help.sleuth.io/modeling-your-deployments/code-deployments) which is using CircleCI so that we may use it as a source of CircleCI builds.

## Configuring the integration

Once the integration is successful, find the **Impact sources** section in the sidebar and click the **+ Add** link nested under that section.

![](https://2832637360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1bR_-Od0islbiOl4G0%2Fuploads%2Fgit-blob-f83c0fa1cac2fa985c8870f5c5cc552d2788d91f%2Fimpact-sidebar.png?alt=media)

Select **CircleCI** from the dropdown and continue by clicking **Enable and add**.

![](https://2832637360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1bR_-Od0islbiOl4G0%2Fuploads%2Fgit-blob-8183cfa86c285d40fcd7f6eaf85a51039032cb1e%2Fcircleci-impact-build-provider.png?alt=media)

Give this build tracking instance a **name** and select which **build** or job inside a build should be used to base the impact measurements on.

![](https://2832637360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1bR_-Od0islbiOl4G0%2Fuploads%2Fgit-blob-d37a0ace4a2dcbf2a49f102009ee51fb316af8ad%2Fcircle-impact-form.png?alt=media)

That's it! Sleuth will now start verifying your deploys health by tracking whether the selected build/job is passing or failing. Head over to the Dashboard to start seeing your data in action in the project and deploy health graphs.

## Removing the integration

Refer to the [general instructions on removing CircleCI integration](https://help.sleuth.io/integrations-1/builds/circleci).