Como ler os logs no Fluig.

A análise de logs em servidores fluig

Há duas formas de acesso aos logs do fluig. Uma delas é através do arquivo gerado dentro da pasta do instalador do fluig, ou seja, você tem acesso ao arquivo .log gerado em tempo real.

Outra forma é através da ferramenta painel de controle > Controles de Logs > Baixar log completo. Entretanto esta opção é impraticável, uma vez que a análise se torna mais demorada, pois é necessário realizar o download de diversas versões de logs, apenas para acompanhar o seu desenvolvimento.

Ambiente próprio

Eu chamo de ambiente próprio aquele ambiente que você possui total autonomia na manutenção do servidor, ou seja, quando você tem acesso ao servidor.

Acessar o servidor do fluig te dará uma vantagem, pois é assim você poderá ter acesso às pastas de logs, que estão localizados no seguinte caminho: c:/[pasta de instalação do fluig]/appserver/domain/servers/fluig1/log/server.log

Você poderá utilizar editores de texto, ou softwares que fazem a análise em tempo real do arquivo.

Ambiente em nuvem

Se seu ambiente é em nuvem da TOTVS, sugiro que seja aberto um chamado questionando o acesso à pasta de logs.

Desenvolver soluções no Fluig utilizando a abordagem de leitura de logs em tempo no fluig é uma tarefa difícil, utilizar logs baixados pela plataforma é impraticável.

Você poderá também criar uma versão local do fluig para testes, desta forma você terá total autonomia na plataforma e conduzir seus testes com mais agilidade.

Ferramentas para análise de logs no fluig.

O log é um arquivo de texto. A analise dos logs consiste em utilizar bons editores de textos, ou softwares de análise logs em tempo real. Para isso sugiro o uso das ferramentas: baretail ou notepad++ .

Baretail

A página de download do baretail contém uma breve instrução de como utilizar a ferramenta.

Notepad++

O uso do notepad++ não analisa em tempo real, mas pode ser utilizado como alternativa, pois é possível definir cores para o código, utilizar comandos de busca e facilitar a leitura do log.

Análise dos logs.

Geração de logs

Durante o desenvolvimento você poderá utilizar do recurso log para forçar a escrita de logs no arquivo e acompanhar o seu desenvolvimento. Considere o código abaixo.

var n1 = 1;
var n2 = 2;
var resultado = n1 + n2 ;
//Cria um arquivo do tipo INFO no LOG
log.info("MEULOG=>>"+ n1);
//Cria um arquivo do tipo WARN no LOG.
log.warn("MEULOG=>>"+ n2);

O código acima é um exemplo de como poderá utilizar dos recursos de análise de log.

As variáveis n1 e n2 recebem valores fixos, então não seria necessário uma análise neste nível, entretanto quando se tem valores dinâmicos é interessante utilizar este recurso para validar se o comportamento da plataforma será o esperado.

O comando log irá forçar a escrita no arquivo server.log do que você definir.

No exemplo acima temos log.info(“MEULOG=>>”+ n1).

O uso do texto MEULOG é para facilitar durante a busca e leitura do log, uma vez que são geradas diversas informações.

Exceções e controle de erros.

Confira este artigo da página Caelum para entender os conceitos e uso dos controles de erros.

O uso de controles de erros nos permite reduzir o comportamento indesejado no sistema, quando há falhas. Neste caso é possível utilizar de recursos para capturar e tratar erros. Estes erros também serão descritos no arquivo de log.

Try, Catch

O uso de blocos Try é utilizado para circular um determinado código e o catch será para capturar os erros.

Throw

O comando throw possibilita forçar a exibição de uma mensagem de erro a ser capturada pelo catch, dentro dos eventos de processo do Fluig.

Referências

https://tdn.totvs.com/pages/releaseview.action?pageId=203764136

https://tdn.totvs.com/pages/releaseview.action?pageId=235336390