Cross Segmento - Backoffice (Linha Protheus) - SIGAEST - Coleta de Logs para análise de erros nos relatórios SmartView

Tempo aproximado para leitura: 00:03:00 min

Dúvida
Ao executar um relatório do SmartView é apresentada uma mensagem de erro ou comportamento inesperado.

Como identificar quais informações devem ser verificadas e quais logs devem ser coletados para análise do suporte?

Causa

Algumas das mensagens que podem ocorrer durante a execução dos relatórios SmartView são:

• O ERP TOTVS teve um comportamento inesperado
• connectors.native.internal-server-error
• connectors.native.failed-to-deserialize
• 400 BadRequest
• 500 InternalServerError
• Http failure response for
• Relatório não existe ou não está cadastrado corretamente na tabela De/Para
• O conteúdo retornado pelo ERP TOTVS não condiz com o padrão esperado
• Não foi possível consultar as informações de configuração do DiscoveryEndpoint

Essas mensagens podem estar relacionadas a diferentes situações, como Fontes desatualizados, LIB desatualizada, AppServer ou SmartClient incompatíveis, Procedures desatualizadas, Configuração incorreta do AppServer, Problemas de comunicação entre o Protheus e o SmartView, Configuração do relatório, Problemas no serviço do SmartView ou Inconsistências no retorno das informações do ERP.

Por esse motivo, antes da abertura de uma análise técnica, é importante seguir as validações e realizar a coleta correta dos logs.

Ambiente
Cross Segmento - TOTVS Backoffice (Linha Protheus) - Estoque/Custos - A partir da versão 12.1.2310

Solução

1. Pré-requisitos antes da coleta

   Antes de iniciar a coleta dos logs, recomendamos validar se o ambiente está atualizado. Os relatórios SmartView dependem de diversos componentes do Protheus e, em muitos casos, uma atualização já contempla correções relacionadas ao comportamento apresentado.

   Verifique se o ambiente possui as versões atualizadas de:
   - Acumulado BackOffice conforme sua versão
   - LIB Atual - Logo Guará | Harpia
   - Appserver
   - Smartclient - Lobo Guará | Harpia
   - DBAccess
   - Central de Atualizações

   Importante: realize qualquer atualização primeiro em um ambiente de homologação/teste e efetue backup antes do procedimento.
    

2. Configuração das chaves no AppServer.ini 

   As chaves indicadas devem ser configuradas no AppServer que está configurado o REST do SmartView, preferencialmente em acesso exclusivo:

   • LogHttpFuncs=1

   • TraceStack=1

   • FWTRACELOG=1 

   Após concluir a coleta, elas devem ser removidas ou desativadas para evitar consumo de memória e queda de performance.

   Após configurar as chaves acima, siga os passos a seguir:

   • Apague o arquivo console.log da sessão atual do ambiente (presente na pasta log do AppServer ou onde voce definiu para gravar o arquivo log).

   • 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 puder fazer, certifique-se que a coleta esta sendo realizada no slave devido.

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

   • Envie o novo console.log gerado do APPSERVER

   • Anexe o Inspetor de Objetos ou central ID para uma verificação técnica mais detalhada da data dos fontes

   Mas o meu ambiente é em CLOUD TOTVS, e não posso alterar os arquivos .ini

   Voce pode abrir uma solicitação diretamente ao time Cloud, solicitando os passados do boletim, ou caso ja exista uma solicitação com o modulo que cuida do relatorio, forneça:

   - Nome do ambiente
   - Data do agendamento
   - Horário do agendamento:
   Dessa forma, podemos gerar ticket filho ao time CLOUD para realizarem a ação em questão, e assim que configurarem as chaves, faça o procedimento, colete os logs, e envie ao suporte do modulo para analise.
   CLOUD - PROTHEUS - Download de logs (TCLOUD)
    

3. Logs específicos do SmartView 

   Ao ocorrerem mensagens ou falhas de processamento no SmartView, alguns logs são gerados na pasta de instalação, para coletá-los siga as orientações abaixo, conforme documento de referência FAQ - Protheus/Smart View

   • Acesse a página de diagnósticos do SmartView: O caminho para acesso será: 
     IP do Rest que o SmartView esta configurado + porta 7019 + a palavra "diagnostic"
     Exemplo: http://localhost:7019/diagnostic
   • Você tera na tela principal o link onde os logs do smartview são gravados:
     
   • Basta acessar este caminho e coletar os logs com data e horário do incidente

Casos com solução possivel

- O ERP TOTVS teve um comportamento inesperado
- connectors.native.internal-server-error

Caso voce tenha efetuado atualizações recentemente, e esses dois erros apresentem apenas em algum relatorio especifico de estoque custos, uma sugestão é a reinstalação das procedures de 14 ate 22, e após tentar novamente gerar o relatorio.

Cross Segmento - Backoffice (Linha Protheus) - SIGAEST - Procedure Desatualizada ou Incompatível

Acesse a documentação dos relatorios MATR* aqui: 

Cross Segmento - Backoffice (Linha Protheus) - SIGAEST - Relatórios Legados MATR - Estoque/Custos