Como extrair Logs do Sistema

IMPORTANTE: OS LOGS SÃO INDISPENSÁVEIS PARA O SUPORTE

Os logs são o "caixa-preta" do sistema. Eles registram exatamente o que aconteceu no momento de um erro.

Sem o envio dos logs, nossa equipe não consegue analisar o que está ocorrendo na sua infraestrutura. Antes de abrir um chamado relatando falhas, por favor, extraia os logs seguindo os passos abaixo. Isso agiliza (e muito) a solução do seu problema.

Existem dois tipos principais de logs que podem ser solicitados:

1. Backend (Terminal): Para erros de conexão, API, WhatsApp, envio de mensagens e banco de dados.

2. Frontend (Navegador): Para erros visuais, tela branca ou botões que não respondem.

---

Método 1: Logs do Backend (Via Terminal / SSH)

Pré-requisito: habilitar os logs no seu servidor

Antes de tudo, você precisa ativar o registro de logs no seu servidor. Abra o terminal do sistema e edite o arquivo .env:

nano /home/deployzdg/zpro.io/backend/.env

Adicione os seguintes parâmetros:

LOGGER_INFO=true
LOGGER_WARN=true
LOGGER_ERROR=true

Salve a edição com ctrl + O Saia do arquivo com ctrl + X

Como acessar os logs

Este é o método universal, válido tanto para quem usa o terminal da Hostinger quanto para quem acessa via SSH (PuTTY, etc.).

Passo a Passo:

1. Acesse a VPS: Entre no terminal da sua máquina.

2. Acesse o usuário do sistema: As aplicações rodam dentro do usuário deployzdg. É obrigatório entrar nele primeiro:

   su - deployzdg

3. Liste os Processos (Importante): Antes de abrir o log, você precisa saber qual é o ID do processo. O backend geralmente é o 0, mas se você tiver múltiplas instâncias, isso pode mudar. Digite:

   pm2 list

   Veja na coluna id qual número corresponde ao processo que você quer verificar (geralmente chamado de backend ou zpro-backend).

4. Abra o Log: Supondo que o ID do seu backend seja 0 (o mais comum), digite:

   pm2 log 0

   (Se o ID for outro, substitua o número. Ex: pm2 log 2).

5. Analise e Capture: O terminal mostrará os registros em tempo real.

   • Tente provocar o erro: Com o log aberto, vá no seu sistema Z-PRO e tente fazer a ação que está dando erro.

   • Texto Vermelho: Indica falhas. Tire um print ou copie as linhas vermelhas para enviar ao suporte.

6. Sair do Log: Para parar a exibição e liberar o terminal, pressione as teclas: CTRL + C

Vídeo Logs do Backend para Usuários Hostinger (Via Navegador)

Vídeo Logs do Backend via SSH

---

Método 2: Logs do Frontend (Console do Navegador)

Se o erro parece ser visual, tela branca ou no carregamento da página, o erro não está no servidor, mas sim no navegador.

Passos para Acessar o Console:

1. Abra o Navegador: Visite a página do Z-PRO onde o problema está acontecendo.

2. Abra as Ferramentas do Desenvolvedor: Use um dos métodos abaixo:

   • Botão Direito: Clique com o botão direito em qualquer lugar da página e selecione "Inspecionar".

   • Atalhos (Windows/Linux): Pressione F12 ou Ctrl + Shift + J.

   • Atalhos (Mac): Pressione Cmd + Option + I.

3. Selecione a Aba "Console": Dentro da janela que abriu, clique na aba escrita "Console".

O que analisar no Console:

• Erros (Vermelho): Erros de execução no código front-end (JavaScript) serão exibidos em vermelho. Tire um print desses erros para o suporte.

• Avisos (Amarelo): Mensagens de alerta que geralmente não impedem o funcionamento.