Relatórios

Gerar relatórios é um processo que exige recursos substanciais. Envolve reunir informações diversas de múltiplas tabelas em um banco de dados e mesclá‑las em um documento unificado. Vamos explorar os desafios que podem surgir ao criar relatórios em uma instância On‑Premise. Essas questões decorrem principalmente do hardware do servidor, porém sua detecção costuma ser discreta. Portanto, é imperativa uma compreensão abrangente das causas subjacentes.

Relatórios não são gerados

Este é um problema bastante comum em instâncias Navixy standalone que não são administradas adequadamente. Quando você tenta gerar um relatório, vê uma indicação de carregamento, mas ele demora infinitamente e o relatório não é de fato gerado. Se você abrir a aba Network das ferramentas de desenvolvedor do seu navegador, pode ver que a requisição da API para gerar o relatório falha com 504 Gateway Time-out erro.

A razão é espaço livre insuficiente no disco. Se sua plataforma estiver rodando em dois servidores, aqui estamos falando do servidor de aplicação (onde os serviços Java estão em execução).

A plataforma está configurada para suspender processos que consomem muitos recursos quando o disco está 99% cheio. Em alguns casos (em instâncias implantadas antes de 2022), isso acontece quando o disco está com mais de 90% de uso. Isso visa preservar a funcionalidade básica, evitar o transbordamento completo do disco e dar tempo para que você resolva o problema.

A primeira coisa a fazer é certificar‑se de que o disco está realmente cheio. Se não estiver, pode ser uma falha da plataforma que deve ser reportada ao suporte técnico.

Verifique se o disco tem o tamanho recomendado de acordo com os requisitos do sistema para hardware do servidor. Se o espaço em disco for menor do que o recomendado, você deve tomar medidas de emergência para aumentá‑lo.

O próximo passo é descobrir o que causou o preenchimento do disco. Se você tiver apenas a plataforma Navixy em seu servidor, o espaço livre geralmente é consumido pelos logs da plataforma. O banco de dados também pode estar ocupando espaço se estiver localizado na mesma unidade — ele inevitavelmente cresce em tamanho com o tempo. Neste último caso, você deve agir imediatamente, pois a falta de espaço livre para gravação no banco de dados pode levar à sua inoperabilidade e perda de informação.

Se você tiver muitos dispositivos registrados em seu servidor (mais de alguns milhares), os logs dos serviços de backend podem ocupar uma quantidade significativa de espaço — às vezes um único arquivo pode ultrapassar 1 GB. Contudo, os logs não crescem indefinidamente, pois seu ciclo de vida padrão é de 7 dias, após os quais são excluídos.

Como solução temporária (e não recomendada) para o problema de espaço em casos de emergência, você pode excluir arquivos de log de dias anteriores, já que eles não são necessários para o funcionamento atual da plataforma. No entanto, considere que, dentro de uma semana, os logs voltam a se acumular e ocupar aproximadamente a mesma quantidade de espaço em disco.

Relatórios demoram muito para ser gerados

Diante desse cenário, torna‑se crucial avaliar o problema considerando tanto o período de tempo quanto o número de dispositivos para os quais o relatório é gerado. Naturalmente, à medida que o número de dispositivos e a duração aumentam, a plataforma requer tempo e recursos adicionais para recuperar os dados necessários do banco de dados e gerar o relatório.

Possíveis razões para a geração lenta de relatórios:

• Falta de RAM ou velocidade insuficiente do disco é a razão mais comum. Com o aumento do número de dispositivos e usuários, seu servidor pode começar a faltar em recursos para operar com eficiência. Seus administradores de sistema precisam analisar o desempenho do servidor.

• Alta carga no servidor durante o horário de trabalho. Se seus usuários gerarem muitos relatórios simultaneamente, ou se muitos dados forem solicitados via API, isso pode afetar o desempenho geral da plataforma.

• Limites excessivos para relatórios. Se você anteriormente alterou os limites padrão, a carga pode aumentar dramaticamente.

• Configuração incorreta do MySQL. Se a configuração foi alterada por qualquer motivo e difere do padrão, o próprio banco de dados pode não funcionar de forma eficiente.

• Software extrâneo no servidor ou carga externa no banco de dados. Às vezes clientes usam algum software de terceiros (não relacionado ao Navixy) no mesmo servidor da plataforma para executar tarefas específicas. Até acontece de software de terceiros coletar informações diretamente do banco de dados, gerando cargas imprevisíveis. Isso é fortemente desaconselhável.

• Mal funcionamento da plataforma. Infelizmente, falhas de software às vezes ocorrem, mas são bastante raras, por isso você deve primeiro excluir todas as causas acima. Se tiver certeza de que a geração lenta de relatórios é causada por uma falha na plataforma, reporte‑a ao suporte técnico com todas as informações que lhe permitiram chegar a essa conclusão.