Cross Segmentos - Backoffice Linha Protheus - SIGAFIN - Coleta de Logs para Análise de erros nos relatórios SmartView

Tempo aproximado para leitura: 00:15 min

Dúvida
Durante a geração de relatórios SmartView no financeiro, são apresentados erros em tela. Como avaliar os logs gerados e coletá-los para validação?

Erros comuns

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

Ambiente
Cross Segmento - TOTVS Backoffice (Linha Protheus) - Financeiro – A partir da release 12.1.2310

Solução

Caso algum relatório do Smart View apresente erro em tela ou qualquer tipo de inconsistência durante a execução, é fundamental realizar a coleta dos logs do ambiente.

Esses registros são essenciais para uma análise precisa e para a identificação da causa do problema, permitindo correlacionar as informações técnicas por meio das chaves e parâmetros utilizados na execução.

IMPORTANTE

As validações dos relatórios SmartView funcionam com linguagens avançadas e, com isso, é extremamente importante certificar-se das atualizações mais recentes em seu ambiente.

1. Pacote Acumulado (conforme sua versão)
2. Pacotes LIB
3. Pacotes DBAccess
4. Binário AppServer
5. Binário SmartClient / WebApp
6. Central de Atualizações
    

Um ponto fundamental nas atualizações é a validação da equivalência entre o RPO principal e o RPO do REST, especialmente quando este estiver alocado em um servidor separado.

É importante manter seu produto sempre atualizado, utilizando a última versão disponível no Portal de Clientes (Central de Download). Dessa forma, você garante que todas as melhorias e correções disponibilizadas estejam contempladas no ambiente.

Reforçamos que todos os procedimentos devem ser realizados primeiro em ambiente de TESTE, devidamente atualizado e validado, antes da aplicação em produção.

Esta seção foi criada para reunir informações importantes e soluções rápidas para eventuais situações que possam ocorrer.
Explore os tópicos disponíveis no link abaixo para esclarecer suas dúvidas e facilitar sua experiência:

Configuração de Chaves para Coleta de Logs

Antes da reprodução do erro, recomendamos configurar as seguintes chaves na seção [ambiente]: insira

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

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

Na sessão General:

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

• ConsoleMaxSize=10485760
  Documentação: TDN - ConsoleMaxSize

• Rest_log_level=6

  Documentação: TDN - rest_log_level

Essas chaves devem ser aplicadas no arquivo AppServer.ini do ambiente correspondente e permanecerão ativas durante a execução do serviço.
Após a conclusão do processo de coleta, é necessário desativar as chaves para retornar à configuração padrão do ambiente.

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 definiu para gravar o arquivo log).

2. Reinicie o serviço do AppServer em modo exclusivo, se possível, para garantir que a integridade na coleta seja apenas nesse serviço. Caso não possa fazer, certifique-se de que a coleta está 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, juntamente com o log do SmartView se possível.

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

   

A correta coleta e envio dessas informações são essenciais para que a equipe do suporte possa avaliar com precisão o cenário reportado e dar continuidade à tratativa do incidente, seja no módulo de financeiro ou áreas relacionadas.
 

Onde é que ficam os meus LOGS para coleta e envio?

Os logs estão armazenados nas pastas internas do ambiente. Recomenda-se solicitar ao time de TI a extração desses arquivos. Caso não possua acesso, encaminhe este boletim à equipe responsável, pois assim será mais fácil realizar o procedimento conforme as instruções.
 

Mas o meu ambiente fica no T-CLOUD. Como pego os logs no T-CLOUD?

Caso o seu ambiente esteja hospedado na Cloud TOTVS, a limpeza do console pode não ser viável de forma imediata. Se você não possuir acesso direto, será necessário abrir uma solicitação para que a equipe da Cloud realize essa ação.

No entanto, é possível coletar os logs, diretamente pelo Portal ou via FTP.
Esse procedimento pode ser executado normalmente pelo time de TI ou por você, caso tenha acesso ao portal.

🔹 Atenção:
Certifique-se de coletar os logs do ambiente correto e referentes ao período exato do teste.
Por exemplo: se o teste foi executado em 28/07/2025 às 10h00, mas o log disponível apresenta data e hora anteriores, o arquivo está incorreto.

Nessa situação, atualize a página (F5) algumas vezes para verificar se o log foi atualizado.
Se o problema persistir, entre em contato com o time da Cloud para verificar a atualização ou disponibilização correta do log.

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 appserver não está apontando para a instância 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 utilizada apenas quando o ambiente não possuir as licenças FULL e T. Caso esteja ativa indevidamente, ela entrará em concorrência com o REST, ocasionando erro na tentativa de conexão com o ERP.

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

Cross Segmento - Backoffice (Linha Protheus) - SIGAEST - Como enviar dados pela Central de Diagnóstico?

Validações pontuais pela sua equipe de infra que possa interessar:

Em determinadas situações, o problema pode estar relacionado à compatibilidade do banco de dados. Nesse caso, recomenda-se verificar a versão do banco e, se possível, nos encaminhar o resultado dessas consultas. Essas informações são importantes para análise e, se necessário, para o encaminhamento ao time de Framework.

Exemplo em SQL:

SELECT @@VERSION AS 'SQL Server Version

Valide também a configuração de Level de compatibilidade de seu banco de dados.

SELECT compatibility_level
FROM sys.databases
WHERE [name] = 'NomeDaBase'

Importante

'NomeDaBase' é o nome do banco utilizado na configuração do Smart View.

Saiba mais

Nível de compatibilidade Microsoft