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 no módulo de Estoque/Custos ou áreas relacionadas, é 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?

Principais mensagens apresentadas

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;
• 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

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.

Esta seção foi criada para ajudar você a encontrar informações importantes e soluções rápidas para eventuais problemas que possam surgir. Explore os tópicos do link abaixo para esclarecer suas dúvidas e facilitar sua experiência!
FAQ - Protheus/Smart View

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

Configuração das chaves no AppServer.ini (PREFERENCIALMENTE EM AMBIENTE EXCLUSIVO)

Antes de reproduzir o problema, inclua temporariamente as seguintes chaves no AppServer.ini do ambiente onde ocorre o erro, exclusivo preferencialmente, assim voce podera coletar o CONSOLE.LOG correto da sessão onde ocorreu o erro.

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

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

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

Essas chaves permitem gerar informações adicionais que auxiliam a equipe técnica na identificação da origem do erro.

Após concluir a coleta, elas devem ser removidas ou desativadas para evitar geração desnecessária de logs.

Coleta de Log pelo Smart View

Adicionalmente, é possível obter informações relevantes diretamente do próprio serviço do SmartView, o que contribui para uma análise complementar dos logs da aplicação e do serviço.

Acesse:
FAQ – Protheus/Smart View
TDN - FAQ Smart View

Consulte a sessão “Dúvidas Frequentes”, item “Quais logs devo analisar/enviar caso tenha um erro/problema”.

Procedimento para Captura de Logs

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

1. 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).

2. 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.

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

4. Envie o novo console.log gerado do APPSERVER, juntamente com o log do REST se possivel do Smartview.

5. Anexe o Inspetor de Objetos para uma verificação técnica mais detalhada da data dos fontes

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 o seu agent esta atualizado:

Meu ambiente está no T-Cloud. Como coletar os logs?

Se o seu ambiente é em Cloud TOTVS, a limpeza do console acaba não sendo muito viavel de inicio, pois voce precisa abrir uma solicitação para o CLOUD realizar essa ação caso você não tenha acesso. Mas você pode efetuar a coleta dos logs no portal normalmente, ou via FTP, isso também é um processo que pode ser efetuado normalmente pelo seu time de T.I, ou caso voce tenha acesso ao portal. 

Atenção: Basta se atentar, se esta realizando a coleta do ambiente correto, bem como o log correto, veja o horario gravado antes de coletar, por exemplo: se voce fez um teste em 28/07/2025 as 10:00am, mas voce visualizou que o log do serviço que voce fez o procedimento é de uma data e horario antes disso, então não é esse log que voce deve coletar, de alguns refresh F5 na pagina, para verificar se o log é atualizado, e caso não seja, devera acionar o time CLOUD.

CLOUD - MP - Download de logs (TCLOUD)

Pontual erro: Não foi possível consultar as informações de configuração do DiscoveryEndpoint

Validar se a comunicação dentro do appsever, não esteja apontando para instancia de um serviço integrado, por exemplo a tag Module=46.

[HTTPURI]             
URL=/rest             
PrepareIn=T1         
Instances=2,5,1,1     
CORSEnable=1          
AllowOrigin=*         
Module=46

Observação: Essa TAG deve ser informada somente se não tiver as licenças FULL e T em seu ambiente, ela ativa ira concorrer com o REST, gerando o erro na tentativa de conexão com o ERP 

Principais ocorrências

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

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