# Provedor Datadog

## Plataforma FinOps Pier - Configurações de integração com Datadog

#### Bem-vindo à Pier Cloud!

Esse documento possui como objetivo, ser um guia para que você possa preparar o ambiente, a fim de que seja possível conectar a plataforma da Pier Cloud com o Datadog utilizando conexão via API de Billing.

### No ambiente Datadog

#### PARTE I: Criação de API KEY e APPLICATION KEY

Como premissa precisamos da criação de uma API KEY e uma APPLICATION KEY no Datadog.

Iremos apresentar um passo a passo de como fazer isso.

#### Para iniciar o processo de integração com o Lighthouse, é necessário a criação de uma API KEY no Datadog.

1\. Clique no seu usuário, em seguida em **API Keys**, conforme imagem abaixo:

<figure><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUdxdjkip3fa7G9ogh0Jez4H4aQm122ChKF1_kXAf9b11P38IqDIQ9H2foDAWRg-w-PB-rp43JkXuusWVUTgSxOC1CV5s93k3rzqG81s9dhbqY5PWIj9MQseQkhMWrG-xrUmH2hvRNprIZtMzwrQId9J9ymIudXBlOC_CzX1bt8o5w=s2048?key=f42TckAHfw7FOkWO0ZMHHQ" alt=""><figcaption></figcaption></figure>

2. Nesse passo clique em **+ New Key**, para criar uma nova API Key.

<figure><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUfD0Btzcxi7Hxxd0jk8gRmoeRSbX9wQvipHZcE28DQtK0BxGA7aYQmSgyZHRav5r8H3sFcht1Eu50LwcNgs_Xtv5NO_d3aUB4utSCCGo-gUSUfKurLzVEHHdASrBtCGxZgnXEwWie2csXYuIGiRZYL5hZLbFKWk2GMYNni7JD1h=s2048?key=f42TckAHfw7FOkWO0ZMHHQ" alt=""><figcaption></figcaption></figure>

2.1. Após clicar em **New Key**, irá abrir uma janela para inserir o nome da **API Key**, nesse caso foi usado o nome Pier Cloud teste(porém pode ser adicionado o nome do projeto, etc.) em seguida clique em **Create Key**.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FUVVJmeEzeMTcsaTmBt6e%2Fimage.png?alt=media&#x26;token=17014e0f-b628-4489-9acd-f9e2e2f01134" alt="" width="401"><figcaption></figcaption></figure>

2.2. Após criar no nome da API Key, será redirecionado para esse passo, Clique **Copy**, para copiar a chave gerada e cole em um bloco de notas, em seguida clique **finish**, pronto a API Key foi criada com sucesso .

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FuZd7PlvGMirYRbnAbSsS%2Fimage.png?alt=media&#x26;token=daca32d1-daad-4111-9e7e-a0ba4863ea91" alt="" width="401"><figcaption></figcaption></figure>

3. Aqui, é possível visualizar a API Key criada conforme imagem abaixo:

<figure><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUcLORlD1kZLeHAYCngUXQYTEnekMXs0NFhs-KWlKgdQr12vhLlppdhiK9dF3dC8pmPfSuOHQm1fvIfp_yYjC5PvsmbbyMygUFC-uRP6xLb05XKv9pIiA7hEZg3BFu_-AGH-sl-DYRm3jzBbUGkBLxcdna3x3XCcX26Iioj1bpiRrQ=s2048?key=f42TckAHfw7FOkWO0ZMHHQ" alt=""><figcaption></figcaption></figure>

4. Nesse passo será necessário a criação de uma **Application Key**, clique em Application Keys, conforme imagem abaixo:

<figure><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUcJjgIS4qXeYbQ9EoFXYWTZbY789vNbsGjdEvpE01gXJCBtnMSETQP1f5PtjTm5I6M0usg9rUI7_2DOo1y08sXQx_UYDtrKvbCYI0uC5ZDdapwWOqY-fIDX3MpMPDBJGsX2PTZnqcO6FYeIYHQ0buVBEoEbTmpZvs1rDEohKRdmnA=s2048?key=f42TckAHfw7FOkWO0ZMHHQ" alt=""><figcaption></figcaption></figure>

4.1. Aqui clique em + New Key.

<figure><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUcJjgIS4qXeYbQ9EoFXYWTZbY789vNbsGjdEvpE01gXJCBtnMSETQP1f5PtjTm5I6M0usg9rUI7_2DOo1y08sXQx_UYDtrKvbCYI0uC5ZDdapwWOqY-fIDX3MpMPDBJGsX2PTZnqcO6FYeIYHQ0buVBEoEbTmpZvs1rDEohKRdmnA=s2048?key=f42TckAHfw7FOkWO0ZMHHQ" alt=""><figcaption></figcaption></figure>

4.2. Nesse passo insira o nome da application key, em seguida clique em **Create Key**.

<figure><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUenstvXkPCFvakQ-AKXYUrJINp2CkEGjRTlMCC24rblMJA7bP8AkJWXpiBNEUzFL4gblFX7SVC9aeyKmwTAslnHKJNAH2WJlG8v3W8KjEx9SkMuk_QtTezJqx_joFepb4YUBcXzopp1oWJxKLNBiPdM9I0UdaXFzDq2a74Nj5mG=s2048?key=f42TckAHfw7FOkWO0ZMHHQ" alt=""><figcaption></figcaption></figure>

4.3. Aqui será necessário selecionar os escopos, clique Edit, conforme imagem abaixo:

<figure><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUfaZqWohBrU1KWQqF2R8PGR1L5yc11Vl1veQdJIvGEorEjPitiHx3P6aOcL2TP1Ifjk0Uo0KSMxOW-JUb6juVjSGB1At8EOA6j_FFBrWPIP6PHlzREvcNhaGf2JOyvlPCaSl6FwdMQYEDJyvioIJPDdbSpeHz5P0_gQ6Surt7lRJQ=s2048?key=f42TckAHfw7FOkWO0ZMHHQ" alt=""><figcaption></figcaption></figure>

4.4. Nesse passo no campo de pesquisa(Filter Scopes), procure pelos seguintes escopos:

* `usage_read`
* `billing_read` (se aplicável)
* `logs_read` (para otimização de logs)
* `metrics_read` (para otimização de métricas)

Após selecionar, clique **Save**, para salvar os itens selecionados.

4.5. Nesse passo clique em **Copy**, para copiar a chave (cole em um bloco de notas), em seguida clique em **Finish**, para finalizar a criação da Application Keys.

{% hint style="success" %}
Obs.: Note na seleção em azul, onde aparecem os escopos selecionados no passo anterior.
{% endhint %}

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FjcxEtc15WK514GXvYS33%2Fimage.png?alt=media&#x26;token=fd4e6d7a-c37f-4cd7-abd4-91fbfd7fc72c" alt=""><figcaption></figcaption></figure>

4.6. Aqui, é possível visualizar a **Application Key** criada conforme imagem abaixo:

<figure><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUfIHziYLrqHo4_AuHbVE2MIjVVcKgAcqF7rCgSc9bGhOiU1A2kae7yvvdk7g7_gJ4WNMZ7gdtJY7tibxBA1odmkKeB0dapIG_7TzVowjC9jKj9xbLGP6VKEdTUyOpbehrj7onCCDmI0SkIb0_Q6eFvg67gnMrqIbm6hXO1GB0iV=s2048?key=f42TckAHfw7FOkWO0ZMHHQ" alt=""><figcaption></figcaption></figure>

5. Abaixo estão as informações que deverão ser inseridas na Plataforma da Pier:
   * Chave gerada no **API Key no Datadog**;
   * Chave gerada no **APPLICATION Key no Datadog**
   * **URL do Datadog**

### Na Plataforma da Pier

#### PARTE II: Configurar a Plataforma Pier Cloud para receber os dados da integração com o Datadog

Depois das API KEY e APPLICATION Key criadas, é necessário fazer as configurações na Plataforma.

A seguir, nós temos um passo a passo de como fazer isso.

#### Criação do Segredo

1. Clicando no perfil do usuário, na opção “**Configurações**”, conforme ilustrado abaixo:

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2Fjuwj5agNed1e3ZYwwawd%2Fimage.png?alt=media&#x26;token=b44e7485-9ba2-46f1-9b50-c559cf50a16e" alt=""><figcaption></figcaption></figure>

2. O sistema apresentará o menu lateral com algumas opções de configuração, onde deve ser selecionada a opção “**Segredos**”:

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FSDhfty2x7kuQw69hfxyn%2Fimage%20(1).png?alt=media&#x26;token=a3f63acf-85b1-4be2-9cc8-9434c76fb56d" alt=""><figcaption></figcaption></figure>

3. Ao clicar na opção **Adicionar**, o sistema irá apresentar a tela para criação do segredo, onde devem ser inseridas as informações geradas na plataforma do Datadog.:

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FM92gpxyYnWBckqiIvK2H%2Fimage.png?alt=media&#x26;token=c4af33f0-d794-4e42-a558-7a7c8fc5030a" alt="" width="563"><figcaption></figcaption></figure>

3. Nesse passo vamos inserir as seguintes informações:
   * Nome da Secret: Forneça um nome para identificar o segredo.&#x20;
   * Tipo: Inserir o tipo **Datadog**
   * &#x20;API Key: Inserir a chave copiada no passo 2.2
   * Application Key: Insira a chave copiada no passo 4.5 para a criação do Application Key.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2F9p2jbNxMRxUJLKppypj7%2Fimage.png?alt=media&#x26;token=048dd4f8-0287-4ade-9f68-8d45fab1192d" alt=""><figcaption></figcaption></figure>

5. Uma vez preenchida as informações solicitadas, clique em **Salvar**, para finalizar a criação do secret.

Pronto, **Secret** criado com sucesso!

#### Criação do Billing Connector

1. No Menu à esquerda, clique em **Billing Connectors**, em seguida clique em **+ Adicionar Conector** no canto superior à direita, para criar um Billing Connector.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2Fg27HecD4MYqjZq2t8fhE%2Fimage.png?alt=media&#x26;token=3b7cd80d-0275-459a-a7fe-5ddcbcb41134" alt=""><figcaption></figcaption></figure>

7. Será apresentada a tela para cadastro do Billing Connector onde deveremos preencher as seguintes informações:

* **Tipo**: Manter selecionado o tipo Padrão
* **Cloud Provider**: Selecionar a opção Datadog
* **Identificação do Billing Connector**: Fornecer um nome que identifique o conector de billing

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FlHHRlfZYfhHo6mygyDLF%2Fimage.png?alt=media&#x26;token=613f233c-af1c-4758-ae50-84d680cda4ee" alt="" width="563"><figcaption></figcaption></figure>

7. Uma vez criado o billing connector, será necessário complementar o cadastro na funcionalidade de **Data Connectors**, conforme ilustrado abaixo:

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FzC4OD7uoLb1pR2hLwEw2%2FCaptura%20de%20Tela%202025-09-19%20a%CC%80s%2016.51.02.png?alt=media&#x26;token=130815e0-97d3-4c89-a93e-bbc5e3548c6b" alt=""><figcaption></figcaption></figure>

7. Na tela principal de Data Connector, clique no ícone **editar** do Billing Connector criado anteriormente:

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FRoQ73z6HKSogQypskzLY%2FCaptura%20de%20Tela%202025-09-19%20a%CC%80s%2017.02.06.png?alt=media&#x26;token=37ba987f-bb43-433f-8621-c01d4cbe9cb5" alt="" width="375"><figcaption></figcaption></figure>

Será necessário complementar o cadastro com as seguintes informações:

* **Data Connector:** Essa informação não poderá ser editada,&#x20;
* **Nome identificador do Data Connector:** Manter o mesmo nome preenchido, que foi utilizado no cadastro do billing connector.
* **Selecione o Segredo de acesso:** Devemos selecionar o segredo(Secret), que criamos no passo 3 da criação do segredo.
* **Tipo de Métrica**: Selecionar a opção Usage.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FiSp1D6xLMgLZrlFJhpfX%2Fimage.png?alt=media&#x26;token=a8e2160a-fd75-4632-90f9-0910d9726ff6" alt=""><figcaption></figcaption></figure>

8. Por fim, clicaremos em **Salvar**, para concluir a criação do Billing Connector.

**Pronto, a configuração está concluída!**