# Integração 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.

### 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:

* timeseries\_query
* metrics\_read
* hosts\_read

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

<figure><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUcR9jSNIzqZegVriP0F2BPv-GwYNoorbdJh6wpSqhyRSd9y8lDL-cpcLnJTcF9AW6apHRmy9qXWfQQ6w0-m7xSm9b0-HxtcEvJdbEVCT6RtW7ABl9W9LT5rx7bSLrBK_xBHn3xGPWKjuGtGQEKEeLXJTSzkUZ1hDx9kQr2GBjkY=s2048?key=f42TckAHfw7FOkWO0ZMHHQ" alt=""><figcaption></figcaption></figure>

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.

Obs.: Note na seleção em azul, onde aparecem os escopos selecionados no passo anterior.

<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 da criação da **API Key** e **Application Key**, é 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. Na Plataforma, acesse o ícone do usuário e selecione a opção de **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%2FKlJ0ABMqmght3EDFz2uh%2Fimage.png?alt=media&#x26;token=8204eccd-6b86-4624-89cb-5a2df092504f" alt=""><figcaption></figcaption></figure>

2. O sistema irá apresentar o Menu de funcionalidades lateral a esquerda. Clique na opção **Segredos** e em seguida no botão **+ Adicionar** no canto superior à direita, para criar o Segredo.

<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. Nesse passo vamos configurar o segredo com as informações geradas na plataforma do Elastic Cloud:

<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>

4. Nesse passo vamos inserir as seguintes informações:

   * **Nome**: Forneça um nome para identificar o segredo.&#x20;
   * **Tipo**: Inserir o tipo **Datadog**
   * **API Key**: Inserir a chave copiada no passo 2.2, no ambiente do Datadog
   * **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, o Segredo para o Datadog foi criado com sucesso!**&#x20;

#### Criação do **Data Connectors**

1. No menu de funcionalidades a esquerda, clique na opção **Data Connectors** e em seguida no botão **Adicionar** no canto superior à direita, para criação do Data Connector.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2F9QX1XP2zbO6v1ew8i5e2%2FCaptura%20de%20Tela%202025-08-20%20a%CC%80s%2017.00.01.png?alt=media&#x26;token=f0fa0076-e327-4301-a199-2adc872ad27d" alt=""><figcaption></figcaption></figure>

2. Nesse passo vamos configurar o Data Connector:

* **Data Connector:** selecione o tipo de conector de dados **Datadog**,&#x20;
* **Nome do Identificador do Data Connector:** insira um nome para identificar o conector.
  * Exemplo: "Datadog".&#x20;
* **Selecione o segredo para este conector de dados:** escolha o segredo criado no passo 5 da Criação do Segredo.
* **Tipo de Métrica:** Selecione entre as opções:

  * Usage: Sempre que quiser trabalhar com métricas de utilização do billing
  * K8S: Sempre que quiser trabalhar com métricas de observabilidade.&#x20;

  Ao selecionar opção K8S, o sistema irá apresentar algumas métricas que já estão como padrão, além de possibilitar a criação de novas métricas.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FwNjnMZEHDLgD3KbWeaWZ%2Fimage.png?alt=media&#x26;token=6adbd663-062d-4290-a40b-25772d44c5a8" alt=""><figcaption></figcaption></figure>

* **Agregação**: Selecionar o tipo de agregador que será utilizado entre as opções disponíveis (Soma, Média, Mínimo e Máximo)

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FiibwdlVCkPs0b2R7nPDc%2Fimage.png?alt=media&#x26;token=7da22e32-0d68-4010-950c-37b651756124" alt=""><figcaption></figcaption></figure>

* **Tipo de Métrica**: Selecione o tipo de métrica entre as opções disponíveis

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FH3gXxUZJ95CMFgaLKDCt%2Fimage.png?alt=media&#x26;token=574c4f13-baf7-4650-8b2c-a249ec001645" alt=""><figcaption></figcaption></figure>

* **Valor da métrica**: Inserir o valor da métrica que será utilizado

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FPlZPJuBdfHeI1DmLTcnN%2Fimage.png?alt=media&#x26;token=0fd1a773-83cd-4175-9130-bf95c1a10a61" alt=""><figcaption></figcaption></figure>

* **Alias**: Inserir o Alias ou nome que será referenciado na métrica

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FVZ1FBa9DcsOQlLsxvcCx%2Fimage.png?alt=media&#x26;token=e2b0ece6-fa92-4bbb-ab7d-e4127fd0f998" alt=""><figcaption></figcaption></figure>

Ao preencher as informações e clicar no botão **adicionar**, a expressão será apresentada como no relatório, junto com as outras métricas criadas.

3. Por fim, clique no botão **salvar** para concluir a criação do Data Connector.

**Pronto, Data Connectors do Datadog criado com sucesso!**&#x20;