# Datadog Integration
## Datadog Configuration Process.
#### Welcome to Pier Cloud!
This document aims to be a guide so that you can prepare the environment to connect the Pier Cloud platform with Datadog using an API connection.
### In the Datadog environment
#### PART I: Creating API KEY and APPLICATION KEY
As a premise, we need to create an API KEY and an APPLICATION KEY in Datadog.
\
We will present a step-by-step guide on how to do this.
#### To start the integration process with the Platform, it is necessary to create an API KEY in Datadog.
1. Click on your user, then on API Keys, as shown in the image below:
2. In this step, click on **+ New Key** to create a new API Key.
2.1. After clicking on **New Key**, a window will open to enter the name of the **API Key**, in this case the name Pier Cloud test was used (however, the name of the project, etc. can be added) then click on **Create Key**.
2.2. After creating the API Key name, you will be redirected to this step, Click **Copy**, to copy the generated key and paste it into a notepad, then click **finish.** The API Key was created successfully.
3. Here, you can view the **API Key** created as shown in the image below:
4. In this step it will be necessary to create an **Application Key**, click on Application Keys, as shown in the image below:
4.1. Here click on **+ New Key**.
4.2. In this step, enter the name of the application key, then click **Create Key**.
4.3. Here you will need to select the scopes, click **Edit**, as shown in the image below:
4.4. In this step in the search field (Filter Scopes), look for the following scopes:
* timeseries\_query
* metrics\_read
* hosts\_read
After selecting, click **Save** to save the selected items.
4.5. In this step, click on **Copy** to copy the key (paste it into a notepad), then click on **Finish** to complete the creation of the Application Keys.
Note: Note the selection in blue, where the scopes selected in the previous step appear.
4.6. Here, you can view the **Application Key** created as shown in the image below:
5. Abaixo estão as informações que deverão ser inseridas na Plataforma da Pier:
* Key generated in "**API Key**" in Datadog;
* Key generated in "**APPLICATION Key**" in Datadog
* Datadog URL
### On the Pier Cloud Platform
#### PART II: Configure the Pier Cloud Platform to receive data from the Datadog integration
After the API KEY and APPLICATION Key have been created, it is necessary to configure the Platform.
**Below we have a step by step guide on how to do this.**
1. On the Pier Cloud platform, click on your user icon, then **settings**.
2. Here click on **Secrets**, as shown in the image below:
3. In this step, click on **+ Add** to insert the information created on the Datadog platform.
4. In this step we will enter the Secret name, the type and the API Key and Application Key, which were generated in steps 2.2 and 4.3.
In the **Base URL**, the Datadog platform URL will be inserted.
To create the Secret click **Save**.
5. That's it, Secret created as shown in the image below:
Agora precisamos criar o **Data Connector**
6. In the Menu on the left, click on **Data Connectors**, and then click on **+ Add** in the upper right corner, to create the data connector.
7. In this step, we must insert:
* In the "**Data Connector**" field, we must select the Datadog option.
* In the "**Data Connector Identifier Name**" field, we will enter the name to identify the Data Connector.
* In the "**Select Access Secret**" field, we must select the secret that we created in the previous step.
* Then click **save**.
**Note**: Below in the blue selection are the metrics, which are already set as default.
8. Here you can view the created Data Connector.
**That's it, the setup is complete!**
