---
title: HCP Terraform
description: Gain visibility into your organization's HCP Terraform audit events
breadcrumbs: Docs > Integrations > HCP Terraform
---

# HCP Terraform
Integration version1.0.0
## Overview{% #overview %}

This integration enables the collection of HCP Terraform (formerly known as Terraform Cloud) audit trail log data for Datadog [Cloud SIEM](https://app.datadoghq.com/security/home).

- Control your HCP Terraform data retention.
- Build custom widgets and dashboards.
- Set up [Cloud SIEM](https://app.datadoghq.com/security/home) detection rules using the [out-of-the-box Logs Pipeline](https://app.datadoghq.com/logs/pipelines?search=hcp-terraform).
- Cross-reference HCP Terraform events with the data from other services.

After parsing your HCP Terraform logs, Datadog populates the [out-of-the-box HCP Terraform overview dashboard](https://app.datadoghq.com/dash/integration/31325/hcp-terraform-overview) with insights into security-related events from your HCP Terraform values, items, and users. Widgets include toplists showing the most frequent and infrequent events, and a geolocation map that shows you the country of origin for sign-in attempts.

To find HCP Terraform logs, search your Datadog logs with `source:hcp-terraform`. If you installed the integration correctly, you should be able to see HCP Terraform events.

## Setup{% #setup %}

### Installation{% #installation %}

**Step 1: Create an Organization token for HCP Terraform**

1. Log in to your Hashicorp account at [https://app.terraform.io/](https://app.terraform.io/) then click your Organization and click **Settings**
1. Select the **API tokens** link under **Security**.
1. Select **Create an organization token**.
1. Set an expiration date if desired.
1. Click **Generate token**
1. Copy and save your generated Organization token

**Step 2: Create the Datadog Integration**

1. Paste the Token into the **Organization Token** field below.
1. Enter a name for the account.

### Configuration{% #configuration %}

If you are not receiving any logs data, confirm that you have the **audit-logging** attribute set to **true** in your [organization entitlement set](https://developer.hashicorp.com/terraform/cloud-docs/api-docs/organizations#show-the-entitlement-set).

### Validation{% #validation %}

Once the integration is installed, your HCP Terraform audit logs will be available for query with in Datadog logs using `source:hcp-terraform`.

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

### Metrics{% #metrics %}

hcp-terraform does not include any metrics.

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

hcp-terraform does not include any service checks.

### Events{% #events %}

hcp-terraform does not include any events.

## Troubleshooting{% #troubleshooting %}

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