Páginas filhas
  • DT_Arquivo_de_Log_do_Integrador_Separado_por_Thread_

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Arquivo de

log

Log do

integrador separado

Integrador Separado por Thread

Características do Requisito

Linha de Produto:

TSA

Segmento:

Manufatura

Rotina:

Rotina

Nome Técnico

Suportabilidade
Geração de log do integrador
.

Cadastros Iniciais:

/conf/log4j.properties

Parâmetro(s):

tsa.log4j.generateLogByThread
Requisito (ISSUE):
PCREQ-5483

Versões/Release:

12.1.
7 em diante.
8

Descrição

Este é um requisito de suportabilidade  suportabilidade e visa possibilita possibilitar a geração das saídas de log do integrador separados em vários logsarquivos, sendo que cada arquivo um destes representa uma Thread (processo paralelo). Por exemplo, se existir dois dispositivos ativos da Telemática, são pelo menos duas Threads em execução e assim, cada uma gerará um arquivo de log independente (/log/TelematicaServer_01.txt /log/TelematicaServer_02).

Por questões de otimização, recomenda-se que a ativação deste parâmetro seja realizada a pedidos de um analista, técnico ou consultor e que o mesmo permaneça ativo apenas no período da analiseanálise. A ativação desse parâmetro requer que a capacidade mínima de disco reservada para os logs do TSA seja aumentada. Para saber a quantidade de disco mínima necessária, multiplique o valor do parâmetro "/conf/log4j.properties/*MaxFileSize" por 30. Ou seja, se o valor do parâmetro estiver "100MB", serão necessário 3GB mínimos de espaço em disco.

Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

  • Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
  • No módulo informe o nome do módulo acesse informe o caminho e verifique que o parâmetro informe o nome do parâmetro é criado conforme especificações abaixo:

    Para ativar a funcionalidade, é necessário inserir a chave abaixo no arquivo "/conf/log4j.propertiers", atribuindo-a o valor true.

    Nome da Variável:

    Informe o Nome da Variável
    tsa.log4j.generateLogByThread

    Tipo:

    Informe o Tipo
    Boolean (true - ativa) / false - desativa)

    Descrição:

    Informe a Descrição
    Cria vários arquivos de logs, um para cada Thread

    Valor Padrão:

    Informe o Valor Padrão

    Procedimento para Configuração

    (Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou  rotinas no menu).

     

    CONFIGURAÇÃO DE PARÂMETROS

     

    1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
      (É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)

    Itens/Pastas

    Descrição

    Nome:

     

    Tipo:

    Informe o Tipo do parâmetro

    Cont. Por.:

    Informe o Conteúdo padrão

    Descrição:

     

     

    CONFIGURAÇÃO DE MENUS

     

    2.  No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:

    Menu

    Informe o Menu em que estará localizada a rotina

    Submenu

    Informe o Submenu em que estará localizada a rotina

    Nome da Rotina

    Informe o Título da rotina

    Programa

    Informe o Fonte da rotina

    Módulo

    Informe o Nome do(s) produto(s) a ser utilizado ou “Todos”

    Tipo

    Informe a Função

    False

    Exemplo:

    Arquivo log4j.propertiesImage Added

    Para desativar a funcionalidade basta alterar o valor da chave "tsa.log4j.generateLogByThread" para false.

    ATENÇÃO:

    1. Em ambos os casos (Ativação/Desativação) o integrador precisa ser reiniciado.
    2. O arquivo server_log.txt continuará ser gerado com a ativação deste requisito.

    Procedimento para Configuração

    CONFIGURAÇÃO DE PARÂMETROS

    O appender padrão do arquivo /log/log4j.propertiers é o fileOut, assim, qualquer configuração colocada em suas chaves "log4j.appender.fileOut.*" serão replicadas para os arquivos de log das Threads. Por exemplo, caso a chave log4j.rootLogger esteja com o valor INFO, significa que o nível de log visualizado é INFO, então, se quiser que no arquivo TelematicaServer_01.txt, sejam mostrados logs de nível DEBUG, basta alterar de INFO para DEBUG neste parâmetro.

    Procedimento para Utilização

    Com a ativação do parâmetro, ao iniciar o integrador serão criados diversos arquivos de log, conforme imagem abaixo:

    Diretório de log do integradorImage Added

    No exemplo acima, a imagem refere-se a um integrador contendo apenas um dispositivo da Telemática ativo. Todos esses arquivos mostrados foram criados, pois, cada um representa uma Thread especifica.

    Abrindo um desses arquivos, o layout das mensagens pode ser lido da seguinte forma: na linha selecionada observe que antes do "->" refere-se ao nome da Thread pai, antes do "<|>" refere-se ao nome Thread corrente, e, após, refere-se a classe onde o log está inserido, veja:

    Arquivo de logImage Added

    ATENÇÃO:

    1. Quando a Thread A chamar a Thread B, todos os logs contidos na classe da Thread B serão mostrados na Thread A. Somente será criado um arquivo de log para a Thread B se ela instanciar alguma classe, assim, todos os logs contidos nesta classe sairão em seu arquivo de log.

    Procedimento para Utilização

    • Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:
    • Localização da rotina no menu;
    • Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
    • Caso seja necessário ter algum cadastro feito previamente, faça uma observação.

     

     

    Exemplo:

           1.            No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).

    O sistema apresenta a janela de produtos cadastrados.

           2.            Posicione o cursor em um produto e clique em Alterar.

           3.            Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.

           4.            Dê duplo clique no campo TP Prestador (BCW_TIPPRE).

    O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.

           5.            Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:

                          Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.

           6.            Confira os dados e confirme.