projeto-importado/docs/criacao_usuario_monitor_elastic.md

## Criação do Usuário para Monitoramento do Elasticsearch

Este procedimento descreve como criar o usuário `zbx_monitor` para o monitoramento do Elasticsearch via Zabbix.

Siga os passos abaixo para realizar a criação do usuário utilizando o Postman.

---

## **Configuração com Postman**

> **Pré-requisito:** É necessário utilizar o Postman para configurar o cluster e criar os usuários.

### Observações:
- Todos os clientes já possuem um NAT configurado para acesso à interface `INT_RT` através da porta `9201`.
- Os ambientes globais são acessados diretamente pela porta `9200`. Esse NAT já é criado automaticamente durante o processo de deploy do Elasticsearch.

---

### **1. Desabilitar a verificação de certificado SSL no Postman**

Acesse as configurações do Postman e desabilite a opção **"SSL certificate verification"**.

![Desabilitar SSL no Postman](../img/des-elastic-atendenet-postman-settings.png)

---

### **2. Importar a Collection do Postman**

Importe o arquivo `.json` responsável pela criação do usuário. Faça o download através do link abaixo e siga a documentação.

**Arquivo:**
- [Criação do Usuário - Zabbix](../docs/Create%20user%20Zabbix.postman_collection.json)

---

### **3. Ajustar a senha na aba Authorization**

Após importar a collection, acesse a requisição `Elastic - Create user Zabbix` e altere a senha na aba **Authorization**, utilizando a senha definida durante a criação do hash no deploy do container.

Essa senha pode ser obtida no GDT, no equipamento `01835-GRAVATAI-JITSI`, conforme imagem abaixo:

![Senha no GDT](../img/create-user-zabbix-elastic_gdt.png)

Altere a senha no campo correspondente à autenticação básica:

![Alterando senha no Postman](../img/create-user-zabbix-elastic_auth.png)

---
### Realizar o cadastro da senha do usuário no GTT

1. Realizar o acesso no `https://datacenter.ipm.com.br/`

2. Acessar a rotina abaixo e buscar pelo cliente
- Gerenciamento Data Center » Manutenção » Equipamentos » Equipamento

3. No equipamento `cluster` do cliente, Consultar >> Serviços
- Gerenciamento Data Center » Manutenção » Equipamentos » Equipamento » Consultar Serviços do Equipamento

4. Expandir a stack do Elastic Search, conforme na imagem abaixo
![Expandindo Elastic Search](../img/expandir_elasticsearch_gtt.png)

5. Com botão direito sobre o serviço do Tipo: Interno - Elastic Search, Configurar o serviço. Como mostra a imagem abaixo
![Expandindo Elastic Search](../img/expandir_elasticsearch_gtt1.png)

6. Realizar a inclusão do usuário
- + Incluir >> Por template
![Expandindo Elastic Search](../img/expandir_elasticsearch_gtt2.png)

7. Selecionar o template de Role, clicando na Lupa e selecionando o template com sequência 1 e confirmar.
![Expandindo Elastic Search](../img/expandir_elasticsearch_gtt3.png)

- Após isso, será realizado a criação de um usuário chamado `zbx_monitor` com a senha aberta e criptografada
---
---

### **4. Configurar variáveis do ambiente**

Acesse as variáveis do ambiente **"Elastic - Create user Zabbix"** e ajuste os valores conforme o tipo de acesso ao Elasticsearch (ambiente global ou cliente).

- **URL_ELASTIC:**  
  `https://INT_RT:9201` para ambientes de cliente  
  `https://<endereço_global>:9200` para ambientes globais

- **SENHA_MONITORAMENTO:**  
  Senha definida para o usuário `zbx_monitor`
- A senha do procedimento que foi realizado acima, na inclusão de usuário no GTT.

Após configurar, clique em **Save** e depois em **Run**, conforme imagens abaixo:

![Configuração das variáveis](../img/create-user-zabbix-elastic2.png)  
![Executando a Collection](../img/create-user-zabbix-elastic3.png)

---

### **5. Resultado esperado**

A execução correta da Collection deve retornar uma resposta semelhante à imagem abaixo:

![Resultado esperado](../img/create-user-zabbix-elastic4.png)

---

---
### Realizar cadastro de Macro e Vincular Template no Zabbix

1. Acessar o Zabbix para realizar os procedimentos
- PR: https://pr01-datacenter.ipm.com.br:8085/
- SP: https://sp01-datacenter.ipm.com.br:8085/

2. Acessar Configuration >> Hosts e buscar pelo cliente, conforme mostra imagem abaixo
![Remover VM do Zabbix](../img/remover_vm_zabbix.png)

3. Clicar sobre o equipamento `cluster` e ir na guia `macros`, conforme mostra a imagem abaixo
![Adicionar VM do Zabbix](../img/adicionar_vm_zabbix.png)

4. Adicionar os macros abaixo:

- __Macro:__ {$ELASTICSEARCH.HOST}
- __Value:__ 08573-des-atendenet-0870-01.atende.net
- __Description:__ The connection of the Elasticsearch Hostname.

- __Macro:__ {$ELASTICSEARCH.PASSWORD}
- __Value:__ alterar o tipo para "Secret text" e colar a senha que foi gerada no GTT
- __Description:__ The password of the Elasticsearch.

4. Adicionar o template `Elasticsearch Cluster by HTTP` no equipamento cluster

![Adicionar VM do Zabbix](../img/adicionar_vm_zabbix1.png)