# Integração Elastic Cloud

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

#### 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 Elasticsearch utilizando conexão via API.

### No ambiente da Elastic Cloud

{% hint style="success" %}
PRE REQUISITO: 

Para integração com a plataforma da Pier Cloud, será necessário criar uma API Key no Elasticsearch.
{% endhint %}

A seguir, você encontrará um passo a passo detalhado de como realizar essa configuração.

#### Geração da API Key

1. Para iniciar a configuração faça o login no portal da Elastic Cloud através do link: <https://cloud.elastic.co/login>.

* Insira o e-mail e senha cadastrados e fornecidos pela a sua organização.

{% hint style="warning" %}
Observação:&#x20;

Para executar esse procedimento é necessário ser “Organization Owner”.
{% endhint %}

<figure><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUcY9sI0bpeJk1_RIfnTh7Lbr-u5uPTlO1u93cRi20gTkhARzM0UVtlo-b6zvD5jGUykzPcxoMFURWH5I3G8rZVWxBT7sMXcPVGiexU67Niv9kogam9ACQJ6rePrOYizPjdvjwhg-fTKmodDkEoEvFq862jAJF8A=s2048?key=LbFC3PdQEeH_FLCGr_0TAG2e" alt=""><figcaption></figcaption></figure>

2. Clique no ícone do usuário no canto superior direito, em seguida selecione a opção **Organization**, conforme ilustrado na imagem abaixo.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2Ft7H5hIeSeX628mylQb5u%2Fimage.png?alt=media&#x26;token=37c532fd-671d-4410-8d41-6b2ed748cb44" alt=""><figcaption></figcaption></figure>

2. Clique na aba **API keys**, conforme ilustrado na imagem abaixo.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2Fy98nnHnt7WjDTsUrN7Lz%2Fimage%20(1).png?alt=media&#x26;token=2338c733-2db9-444a-adea-94c97f665302" alt=""><figcaption></figcaption></figure>

3. E clique em **Create API key**, para criação de uma nova chave.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FBy3Oqm3QssErpFtE0VAs%2Fimage%20(2).png?alt=media&#x26;token=c7d97e4f-fe9e-432c-9def-f450c3aa8a16" alt=""><figcaption></figcaption></figure>

* **Passo 1:**
  * **Add name:** adicione um nome para identificar a API key.&#x20;
* **Passo 2:**&#x20;
  * **Set expiration**, selecione o período de expiração da API (neste caso, vamos escolher 1 ano).&#x20;
* **Passo 3:**&#x20;
  * **Assign roles:** habilite a opção **Billing Admin**.&#x20;

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2F9rt8nSJhX6NWRilXGE9s%2Fimage.png?alt=media&#x26;token=45fabb45-16da-46c2-bf41-9a58b33382e6" alt=""><figcaption></figcaption></figure>

Em seguida, clique em **Create API key**, para concluir a geração da chave.

{% hint style="warning" %}
**Observação**: Este procedimento deve ser realizado pelo Organization Owner.
{% endhint %}

5. Copie a key gerada e cole em um bloco ou clique em **Download API key**, conforme ilustrado na imagem abaixo.

<figure><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUcVo4D0nzvp35mxfwzi9tFsZR6uQN7Yxf66L0cNgwW59XpMzSUCRuFHkN2wDwpJCtcx-L47VmJ9rU6DAWJmieSO2mBiI4QFfdz7rOaErjDSdq-6NvAhDrvZcuiBeQ9hmFfDWsydhXMl5ERWagQVNYAMJMJwCg0R=s2048?key=LbFC3PdQEeH_FLCGr_0TAG2e" alt=""><figcaption></figcaption></figure>

6. API key criada com sucesso!
   * Anote o **Organization ID**, conforme ilustrado na imagem abaixo.
   * Com o **Organization ID** e a **chave** gerada durante a criação da **API key,** já podemos prosseguir para a configuração na Plataforma da Pier Cloud.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FI26obDDu3QJObME8shTt%2Fimage%20(8).png?alt=media&#x26;token=6532cae9-9109-4b66-ac4d-f934ead0a730" alt=""><figcaption></figcaption></figure>

### **Na Plataforma da Pier Cloud:**

#### **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**: Insira um nome para identificar o Segredo (Secret)
  * Exemplo: "Elastic Cloud API\_Key".&#x20;
* **Tipo**: Selecione o tipo de Segredo "**API Key"**.&#x20;
* **API Key**: Insira a chave da API gerada no passo 5, no ambiente do Elastic Cloud.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FxH1sCzk04D9IRdzANQOt%2Fimage.png?alt=media&#x26;token=a03d09fa-2725-42ac-ab03-3650212f15e2" alt="" width="563"><figcaption></figcaption></figure>

5. Por fim, clique em **Salvar** para concluir a criação do Segredo.

**Pronto, o Segredo para o Elastic 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%2FwCoYbHVLI12Iq2qVUPD0%2FCaptura%20de%20Tela%202025-08-20%20a%CC%80s%2017.00.01.png?alt=media&#x26;token=09304ede-fc2f-41f3-bf25-bc462122bf41" alt=""><figcaption></figcaption></figure>

2. Nesse passo vamos configurar o Data Connector:

* **Data Connector:** selecione o tipo de conector de dados "Elastic Cloud".
* **Nome do Identificador do Data Connector:** insira um nome para identificar o conector.
  * Exemplo: "Elastic Cloud".&#x20;
* **Selecione o segredo (Secret) para este conector de dados:** escolha o segredo criado no passo 5 da Criação do Segredo.
* **ID da Organização:** insira o ID da Organização obtido no passo 6 no ambiente do Elastic Cloud.&#x20;

<figure><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUf20wP8Ssx5hOpgUNHCUucUvx4tEFBweolIKOYkClUCe90NLQ1u9G6HbKwaoDBEe5KaU1zqqHMVz1pCNA4e13qagT9v-yPucu-10Xm-InQcZcwkSeeKsXZzKpSQgEGsedsRO9HyMQ=s2048?key=LbFC3PdQEeH_FLCGr_0TAG2e" alt=""><figcaption></figcaption></figure>

3. Por fim, clique em **Salvar** para criar o conector de dados.

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