Cross Segmentos - Totvs Backoffice Protheus - SIGAGCT - Como diagnosticar e coletar logs de erros nos Relatórios SmartView

Tempo aproximado para leitura: 06:00:00 min

Dúvida

Qual o procedimento correto para tratar e diagnosticar as ocorrências de erro apresentadas na tela ao gerar relatórios SmartView no módulo Protheus Gestão de contratos?

Ambiente

Cross Segmento - TOTVS Backoffice (Linha Protheus) - TOTVS Protheus Gestão de Contratos - Todas as versões

Solução

Caso um relatório do SmartView apresente erro em tela ou qualquer tipo de inconsistência durante a execução, é fundamental realizar a coleta dos logs do ambiente, a fim de possibilitar uma análise precisa e a identificação da causa do problema, considerando o uso de chaves importantes para corroborar com a análise.

Importante: As validações dos relatórios SmartView funcionam com linguagens avançadas. Por isso, é extremamente importante certificar-se das atualizações mais recentes em seu ambiente como um todo, antes de prosseguir com a coleta de logs:

-Por gentileza realize teste em ambiente de Homologação com as atualizações a seguir:

- Acumulado Compras conforme sua versão
- Acumulado Gestão de Contratos conforme sua versão
- Acumulado SIGAGCP conforme sua versão
- LIB Atual - Harpia | Onca
- Appserver - Harpia R.33 | Onca

- Smartclient WebApp - Onca

- DBAccess - MP - FRAME - Atualização do DBAccess
 Obs: Recomendamos backup e validação primeiramente em ambiente teste. 

- Central de Atualizações

Configuração de Chaves para Mapeamento do Erro

Antes da reprodução do erro, recomendamos configurar as seguintes chaves no ambiente do REST utilizado no SmartView. A ativação dessas chaves é crucial para mapear a origem e o fluxo do erro, fornecendo detalhes técnicos essenciais para a análise do suporte:

• LogHttpFuncs=1
  Documentação: TDN - LogHttpFuncs

• TraceStack=1
  Documentação: TDN - TraceStack

• FWTRACELOG=1
  Documentação: TDN - FWTRACELOG

Essas chaves devem ser aplicadas no AppServer.ini do ambiente correspondente e estarão ativas durante a execução do serviço, após o processo de coleta, desative as chaves para evitar sobrecarga de logs desnecessários.

Procedimento para Captura de Logs:

1 - Após configurar as chaves acima no AppServer.ini, siga os passos a seguir imediatamente antes de reproduzir o erro:

2 - Apague o arquivo console.log da sessão atual do ambiente (presente na pasta log do AppServer ou onde você definiu para gravar o arquivo log).

3 - Reinicie o serviço do AppServer em modo exclusivo, se possível, para garantir integridade na coleta seja apenas nesse serviço. Caso não possa, certifique-se de que a coleta está sendo realizada no slave devido.

4 - Reproduza o erro novamente, executando o relatório que apresenta a falha.

5 - Envie o novo console.log gerado, juntamente com o log do SmartView (se possível)

6 - Capture uma imagem da rotina:

SIGACFG > Ambiente > Cadastros > Configuração TReports/Smart View (Opção: Token, no módulo Configurador).

7 - Informe se o problema ocorre em todos os relatórios ou apenas em um específico.

8 - Valide se o seu agent está atualizado e envie um print:

Onde é localizado os meus LOGS para coleta e envio?

Os logs ficam nas pastas internas do seu ambiente. Você deve solicitar ao seu TIME de TI que pegue os logs caso você não tenha acesso.

Meu ambiente é no T-CLOUD, como pego os logs?

Se o seu ambiente é na TOTVS Cloud (T-CLOUD), a limpeza do console.log acaba não sendo muito viável de início, pois você precisa abrir uma solicitação para o time CLOUD realizar essa ação caso você não tenha acesso ao servidor.

No entanto, você pode efetuar a coleta dos logs no portal normalmente, ou via FTP. Isso também é um processo que pode ser efetuado por seu time de T.I., ou por você, caso possua acesso ao portal do ambiente Cloud: CLOUD - MP - Download de logs (TCLOUD)

Saiba Mais:

Cross Segmentos - Totvs Backoffice Protheus - SIGAGCT - Relação dos relatórios SmartView do módulo Gestão de Contratos

Artigos Materiais - Gestão de Contratos - (SIGAGCT)