HashCore Docs
Solução de Problemas

Diagnóstico do Agente

Esta seção ajudará a entender os problemas mais comuns no funcionamento do agente HashCore Pulse.

O Agente não conecta (status Offline)

Sintoma: o agente está instalado e em execução, mas na interface do Pulse é exibido como Offline.

Verifique:

  1. Conexão com a Internet — o servidor onde o agente está em execução deve ter acesso à internet. Verifique a acessibilidade de pulse.hashcore.com a partir da linha de comando: ping pulse.hashcore.com
  2. Porta 443 — o agente funciona via HTTPS. Certifique-se de que o tráfego de saída na porta 443 não esteja bloqueado por um firewall ou proxy corporativo.
  3. Agent ID e Agent Secret — certifique-se de que as credenciais corretas foram inseridas sem espaços extras ao configurar o agente.
  4. Serviço do Agente — certifique-se de que o serviço do agente está em execução:
  • Windows: abra "Serviços" → encontre HashCore Pulse Agent → o status deve ser "Em execução"
  • Linux: execute systemctl status hashcore-agent
  1. Versão do Agente — uma versão desatualizada pode não conseguir conectar-se a um servidor atualizado. Atualize o agente manualmente se a atualização automática não funcionou.

Dispositivos não são detectados

Sintoma: o agente está Online, mas a lista de Workers está vazia ou os dispositivos não aparecem.

Verifique:

  1. Scan Task ativada — certifique-se de que a Scan Task tem o status Enabled. Se desativada — ative-a através do menu de contexto.
  2. Intervalos de IP — certifique-se de que os endereços IP dos dispositivos estão dentro dos intervalos definidos. Verifique os endereços dos dispositivos através de sua interface física ou roteador.
  3. Acessibilidade da Rede — o agente deve estar na mesma rede local que os mineradores. Verifique com um ping: ping <IP-endereço do minerador> a partir do servidor onde o agente está em execução.
  4. Unlock Configs — se os dispositivos estiverem protegidos por senhas não padrão, o agente não conseguirá obter dados deles. Adicione as credenciais na aba Unlock Configs da Scan Task.
  5. Dispositivos Suportados — certifique-se de que o fabricante e o modelo do dispositivo estão na lista de suportados. Dispositivos desconhecidos são logados, mas não são adicionados aos Workers.
  6. Frequência de Scan — com um intervalo de 30 min ou 1 hora, novos dispositivos podem não aparecer imediatamente. Diminua o intervalo para a detecção inicial.

Dispositivos ficam Offline periodicamente

Sintoma: os dispositivos aparecem e desaparecem, ou ficam Offline regularmente sem motivos aparentes.

Verifique:

  1. Estabilidade da Rede — verifique a qualidade da conexão entre o agente e os dispositivos. Wi-Fi instável ou um switch sobrecarregado pode causar perdas de conexão periódicas.
  2. Carga no Agente — se o agente estiver atendendo a um grande número de dispositivos, ele pode não conseguir consultar todos no intervalo definido. Diminua o número de threads paralelas ou adicione um segundo agente para parte dos dispositivos.
  3. Recursos do Servidor — verifique o uso de CPU e RAM no servidor onde o agente está em execução. Com a falta de recursos, o agente funciona de forma instável.
  4. Timeout Offline — o dispositivo fica Offline se as métricas não forem recebidas por mais de 5 minutos. Este é um comportamento normal em caso de falhas de rede de curta duração.

O Agente não atualiza automaticamente

Sintoma: a versão do agente na lista está desatualizada, a atualização automática não ocorre.

Verifique:

  1. Acesso ao servidor de atualizações — O AgentUpdater acessa os servidores HashCore para verificar a versão. Certifique-se de que o tráfego de saída não está bloqueado.
  2. Permissões de escrita — o serviço do agente deve ter permissões de escrita no diretório de instalação para substituir os arquivos executáveis.
  3. Atualização manual — baixe a versão atual do agente da interface do Pulse (ao criar um novo agente ou via Show Credentials) e instale-a sobre a existente.

Relatório de diagnóstico do agente

Se não conseguir resolver o problema por conta própria — gere um relatório de diagnóstico e envie-o para o suporte HashCore.

  1. Vá para a seção Agents.
  2. Clique em ao lado do agente problemático → Diagnostic report.
  3. Aguarde a conclusão da operação no Activity Center.
  4. Baixe o arquivo (disponível por 2 horas).
  5. Anexe o arquivo à sua solicitação de suporte.

O relatório contém logs de conexão, estatísticas de scan e informações técnicas sobre o funcionamento do agente — isso acelera significativamente o diagnóstico por parte do suporte.