Páginas filhas
  • 11187613 DFWKTOOLS-4766 DT Melhoria no registro de LOGs de requisições HTTP REST


01. DADOS GERAIS

Produto:

TOTVS Manufatura

Linha de Produto:

Linha Logix

Segmento:

Tecnologia

Módulo:Administração Logix - Framework
Função:Comunicação HTTP REST
País:Brasil
Ticket:11187613
Requisito/Story/Issue (informe o requisito relacionado) :DFWKTOOLS-4766


02. SITUAÇÃO/REQUISITO

Na ocorrência de alguma exceção de uma API através do acionamento de uma função 4GL durante uma requisição HTTP REST, o retorno da requisição não reportava de forma clara o problema e através do LOG do AppServer também fica difícil identificar o problema.

03. SOLUÇÃO

Foram realizadas algumas melhorias em relação ao tratamento de erros nas execuções de funções a partir das requisições HTTP REST, fazendo o devido retorno com melhor detalhamento da falha, bem como registro de mensagens de LOG no AppServer para facilitar a identificação da origem do problema.

04. DEMAIS INFORMAÇÕES


Ativação de chaves para geração de LOG em requisições HTTP REST


Para ativar a geração de mensagens de LOG no AppServer durante o processamento de requisições HTTP REST, com objetivo de facilitar a identificação de problemas através de um nível mais detalhado de informações, pode-se ativar algumas chaves no AppServer e Profile Logix, sendo:

  • No arquivo INI do AppServer, ativar as seguintes chaves na seção do ambiente utilizado pela requisição HTTP REST, sendo este identificado pelo conteúdo da chave ENVIRONMENT na seção HTTPJOB.  Na seção deste ENVIRONMENT indicado, é preciso ativar as chaves abaixo para registrar mensagens de LOG de toda comunicação HTTP REST recebida pelo AppServer:

                     FWTRACELOG=1

                     FWLOGMSG_DEBUG=1

  • No arquivo de Profile Logix utilizado no mesmo ambiente das requisições HTTP REST, ative a geração de outro conjunto de mensagens de LOG gerenciadas pela camada de funcionalidades Framework Logix através das chaves a seguir:

                     logix.debug=1

                     logix.source.debug=1

Com a ativação destas chaves todo detalhamento das informações recebidas pelo AppServer nas requisições HTTP REST serão devidamente registrados com mensagens de DEBUG no arquivo de LOG do AppServer, sendo alguns dados como:

  • STATUS 
  • Horário 
  • Tempo de execução
  • Método da requisição
  • Informações das seções HEADER e BODY
  • URL de requisição


(ideia) Observação (ideia) 

     Caso surja algum problema relacionado a formatação de conteúdos em JSON, é possível também ativar a chave de profile logix.json.debug=1, onde no arquivo de LOG do AppServer serão registradas informações de conversões de dados no formato JSON. Neste caso as mensagens no LOG do AppServer serão precedidas da TAG [JSON].


IMPORTANTE!

Disponível a partir do pacote oficial 12.1.33 ou Framework Fix 12.1.32.(fix01)


05. ASSUNTOS RELACIONADOS