O objetivo desta página é descrever as diversas técnicas e ferramentas que estão à disposição para o monitoramento, suporte e resolução de problemas do Smart eSocial. A ordem escolhida para apresentar os itens aqui descritos remete à linha do tempo da resolução de um problema.
O acesso aos serviços aqui descritos devem ser solicitados à area de Segurança da Informação de Cloud.
O Smart eSocial é disponibilizado através de um cluster de Kubernetes 1.10. O cluster é único para todos os clientes. Ao conjunto de recursos destinados à um cliente damos o nome de topologia. Cada cliente do serviço possui um código chamado organization id, ou simplesmente código do cliente, que identifica a topologia nos diversos serviços que apresentaremos aqui. Problemas relacionado ao cluster em si devem ser destinados ao TOTVS Cloud. Mais detalhes técnicos da arquitetura da solução estão disponíveis em Arquitetura do Smart eSocial.
A instalação do Smart eSocial possui um processo de auto-cura que resolve alguns problemas nas topologias de maneira automática. No entanto é possível que por problemas ainda não mapeados, a topologia fique fora do ar. Para identificar as topologias com problemas, utilizamos um serviço chamado UptimeRobotm, que deve ser acessado na URL:
https://uptimerobot.com/dashboard.php#mainDashboard
A tela apresentada deve ser conforme a imagem adiante.
À esquerda da tela uma lista com todos os monitores é exibida. Lembrando que cada cliente possui dois monitores, um para o environment de homologação, outro para o environment de produção. Ambos apontam para a mesma topologia no entanto possuem alguns processos separados. O nome dos monitores é formado pelo código do cliente mais o nome do environment.
O Kubernetic (https://kubernetic.com/) é uma ferramenta desktop que ajuda na gestão do cluster de Kubernetes. Caso alguma topologia apresente instabilidade ou mesmo algum monitor esteja alarmado, o primeiro passo é verificar o estado desta topologia no Kubernetic.
O logdna é um serviço de armazenamento e consulta de logs. Todos os processos da topologia do Smart eSocial enviam seus logs para este serviço. Acesse-o através da URL:
https://app.logdna.com/ce391081e7/logs/view?q=namespace:XXXXXX
Substituindo XXXXXX pelo código do cliente. Uma tela como a imagem adiante deve ser apresentada.
Ao entrar no seriviço pela URL descrita anteriormente, visualizamos os logs de todos os processos da topologia. É possível filtrar somente um processo, como por exemplo, o dbaccess. Para isso, devemos clicar no menu All Apps, localizado na barra de menu na parte superior da tela. O menu deve ser exibido conforme imagem adiante.
Faça a busca por dbaccess e marque o checkbox do container retornado, conforme imagem adiante.
Clique na tela na região dos logs e aguarde o recarregamento da página. A partir deste momento, somente os logs do dbaccess serão exibidos.
Com um olhar mais atento podemos verificar que após a aplicação do filtro a url mudou, conforme imagem adiante.
Isso significa que para facilitar o processo, basta substituir o parâmetro de consulta apps da URL e recarregar a página para exibir o log desejado. Os parâmetros podem variar de acordo com os containers e podem assumir os seguintes valores:
Existem diversas funcionalidades no painel web do logdna. Para mais detalhes sobre buscas, filtros e afins, consulte a documentação https://docs.logdna.com/docs/getting-started.