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:
- Conexão com a Internet — o servidor onde o agente está em execução deve ter acesso à internet. Verifique a acessibilidade de
pulse.hashcore.coma partir da linha de comando:ping pulse.hashcore.com - 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.
- Agent ID e Agent Secret — certifique-se de que as credenciais corretas foram inseridas sem espaços extras ao configurar o agente.
- 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
- 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:
- Scan Task ativada — certifique-se de que a Scan Task tem o status Enabled. Se desativada — ative-a através do menu de contexto.
- 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.
- 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. - 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.
- 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.
- 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:
- 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.
- 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.
- 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.
- 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:
- 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.
- 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.
- 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.
- Vá para a seção Agents.
- Clique em ⋯ ao lado do agente problemático → Diagnostic report.
- Aguarde a conclusão da operação no Activity Center.
- Baixe o arquivo (disponível por 2 horas).
- 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.