Tem algo de errado com meu LigeroSmart. O que fazer?

Vamos listar aqui algumas estratégias para entender o que está errado e também como proceder se não descobrir o problema que está deixando você triste com o LigeroSmart ;(

Quais são os canais para reportar dúvidas e BUGs?

Você pode tentar uma solução rápida através do nosso grupo no Telegram, mas antes, veja os logs da sua aplicação conforme mostraremos a seguir, tudo bem?

Caso não consiga resolver de maneira rápida, você deve reportar um BUG do LigeroSmart no GitHub, com o máximo de informações possíveis.

A aplicação está rodando corretamente?

O primeiro teste que você pode fazer, é verificar se a aplicação está rodando corretamente, acesse a pasta da aplicação:

cd ligerosmart-stack

A seguir, rode o comando abaixo:

docker-compose ps

Verifique se o status dos containers está como “Up”, como na imagem abaixo:

Como ver os logs da aplicação?

Em linhas gerais, sempre é bom monitorar a saúde da sua Stack LigeroSmart, através do comando docker-compose logs. É simples!

Acesse a pasta do projeto, normalmente ligerosmart-stack:

cd ligerosmart-stack

A seguir, rode o comando abaixo:

docker-compose logs -f

Este comando irá trazer o log de todos os serviços que compõe a stack:

Por padrão, o serviços que compões a stack são:

• web: Serviço/Container responsável pelo frontend web do LigeroSmart. Se você está com alguma dificuldade de acessar a interface, ou se está com algum problema de erro do sistema, Javascript etc, você deve ficar ligado nas linhas do log deste serviço.
• database: Serviço/Container do MySQL ou Postgre. Caso o sistema apresente algum erro de banco-de-dados, dê uma olhada neste serviço.
• elasticsearch: Serviço/Container responsável pela indexação de tickets, base de conhecimento e itens do catálogo de clientes.
• grafana: Serviço/Container responsável pelo Grafana. Se estiver com algum problema para acessá-lo dê uma olhada neste log.

Outros serviços que podem ser adicionados ou que fazem parte de versões customizadas do docker-compose.yml:

• router: se você está utilizando o traefik para gerar um certificado HTTPS para o LigeroSmart.
• rocketchat: se você também está usando o serviço de chats do Rocket.Chat.

Se preferir, você pode analisar individualmente o log de cada serviço. Por exemplo, se quiser olhar apenas o log da interface web, inclua o nome do serviço no final do comando:

docker-compose logs -f web

Com o tempo, o log do serviço ou do container pode ficar muito extenso, e este comando pode trazer milhares de linhas antes de chegar no final. Você pode então limitar o tamanho do histórico a ser retornado com a opção tail:

docker-compose logs -f --tail=100 web

O comando acima retorna as últimas 100 linhas do log do container web (frontend) e continua monitorando por novos logs.

Então você já sabe: se estiver com algum problema, sempre consulte o log por erros 🙂

Problemas com a busca do catálogo de serviços

Se você estiver com um problema na busca de seu catálogo de serviços (portal do cliente), por favor, veja este artigo!

Problemas com envio de e-mail

Verifique se você realizou a configuração correta do e-mail conforme este artigo. Se quiser ter mais pistas, você também pode acessar o Log de Comunicações do sistema em “Administração” -> “Log de Comunicação”.

Se houverem erros no envio e recebimento de e-mails, você poderá verificar por aqui, clicando nos logs e expandindo as informações.