---
title: dbt Cloud
description: Pull stats on runs, job performance, and more from your dbt Cloud account.
breadcrumbs: Docs > Integrations > dbt Cloud
---

# dbt Cloud
Integration version1.0.0dbt Cloud Dashboard
## Overview{% #overview %}

The Datadog integration with [dbt Cloud](https://www.getdbt.com/product/dbt-cloud) allows you to collect and visualize key metrics from your dbt runs, models, and tests. By integrating dbt Cloud with Datadog, you can:

- Monitor the performance and health of your dbt runs.
- Visualize execution times, compilation times, and status codes for runs, models, and tests.
- Correlate dbt metrics with data from other services in your stack.

## Setup{% #setup %}

### Prerequisites{% #prerequisites %}

- A dbt Cloud account.
- An API token with necessary permissions.

### Step 1: Generate an API Token in dbt Cloud{% #step-1-generate-an-api-token-in-dbt-cloud %}

1. In dbt Cloud, go to **User Profile** > **API Tokens** > **Service Tokens**.
1. Click on **+ Create Service Token**.
1. Provide a name for the token.
1. Set the token permissions:
   - For Administrative API metrics (Job run metrics): Ensure the token has access to runs and jobs.
   - For Discovery API metrics (Models and Tests metrics): Ensure the token has **Metadata API** privileges, and you've [enabled the Discovery API](https://docs.getdbt.com/docs/dbt-cloud-apis/discovery-api) for your project.
1. Click **Save** and copy the generated **API Token**.

### Step 2: Connect your dbt Cloud Account to Datadog{% #step-2-connect-your-dbt-cloud-account-to-datadog %}

1. Add your account ID, account URL, and API token.
1. Optional: For Discovery API metrics, add your [metadata URL](https://docs.getdbt.com/docs/dbt-cloud-apis/discovery-querying#discovery-api-endpoints).
1. Click the **Save** button to save your settings.

Once enabled, data from your current and recent dbt runs and model executions should be available within ten minutes.

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

### Metrics{% #metrics %}

|  |
|  |
| **dbt\_cloud.runs.total**(count)             | The total number of dbt runs executed.*Shown as run*          |
| **dbt\_cloud.runs.elapsed\_time**(gauge)     | The elapsed time of dbt runs in seconds.*Shown as second*     |
| **dbt\_cloud.runs.status\_code**(gauge)      | The status code of dbt runs.                                  |
| **dbt\_cloud.runs.failures**(count)          | Count of failed dbt job runs.                                 |
| **dbt\_cloud.models.execution\_time**(gauge) | The execution time of dbt models in seconds.*Shown as second* |
| **dbt\_cloud.models.compile\_time**(gauge)   | The compile time of dbt models in seconds.*Shown as second*   |
| **dbt\_cloud.tests.execution\_time**(gauge)  | The execution time of dbt tests in seconds.*Shown as second*  |
| **dbt\_cloud.tests.compile\_time**(gauge)    | The compile time of dbt tests in seconds.*Shown as second*    |

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

The dbt Cloud integration does not include any service checks.

### Events{% #events %}

The dbt Cloud integration does not include any events.

## Troubleshooting{% #troubleshooting %}

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

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

- [Monitor dbt Cloud with Datadog](https://www.datadoghq.com/blog/monitor-dbt-cloud-with-datadog/)