Dúvida

Como identificar o Log da instância do Middleware a partir do PID da execução de um processo?

 

Solução

Importante

Para que haja possibilidade de verificação do Log do Middleware, o mesmo deverá ser ativado previamente. Para maiores informações, verifique o artigo TECNOLOGIA – Middleware – Como habilitar a geração de logs de texto do Senior Middleware.

 

 

1. Localizando o PID da instância que você deseja verificar o Log

Para localizar o Log de uma instância específica do Middleware, primeiramente você precisa identificar o PID dessa instância.

 

Importante

• Um PID (do inglês Process ID) é um número inteiro exclusivo atribuído pelo sistema operacional a cada processo em execução. Ele serve para identificar e gerenciar individualmente os processos no sistema operacional.
• Lembre-se de que em servidores diferentes podem haver PIDs com o mesmo número. Portanto, quando você utilizar as informações presentes neste artigo para localizar Logs baseados em PIDs, leve sempre em consideração a verificação do Servidor do Middleware onde a instância foi executada também.

 

Para localizar o PID de um processo executado no Senior Middleware, você terá três opções, conforme listado abaixo:

• SeniorMonitorCenter: você conseguirá visualizar o PID da instância que está ativa em algum Servidor do Middleware.
  • Você poderá utilizar essa opção caso o processo esteja em execução no momento que você está acessando o SeniorMonitorCenter.
  • O SeniorMonitorCenter não disponibiliza a informação de qual o WebService e XML que está em processamento. Portanto, a possibilidade de localização do PID pelo SeniorMonitorCenter faz mais sentido para verificação de Processos Automáticos que estejam em execução no exato momento em que você está visualizando as informações;
• WebServices: para essa opção, será utilizada a Consulta de Requisições de WebServices;
• Processos Agendados: para essa opção, serão utilizados os Logs de processos automáticos.

 

 

1.1. SeniorMonitorCenter

Para efetuar a verificação do PID através do SeniorMonitorCenter, execute os passos abaixo:

 

1.1.1. Verifique no artigo TECNOLOGIA – Middleware – Como acessar o SeniorMonitorCenter (Central de Monitoramento) informações sobre como efetuar o acesso ao SeniorMonitorCenter.

 

1.1.2. No menu da lateral esquerda, acesse as opções  'Monitoramento / Middleware / Aplicativos'.

 

Será aberta a nova tela de visualização de Aplicativos, conforme exemplo abaixo:

 

Na imagem acima você poderá verificar:

• Tipo:
  • Web 5.0 (nenhum): instância responsável por executar processos agendados e AçõesSID (que passem pelo Conector);
  • Web Services: instância que executa WebServices;
• Servidor: nome do Servidor onde a instância está sendo executada;
• PID: Proccess ID da instância.

 

1.1.3. Busque o Servidor e o PID da instância que você deseja analisar o Log.

Lembre-se de que pelo SeniorMonitorCenter você terá maior facilidade de verificar o PID para Processos Agendados que estejam em execução. Portanto, esse será o foco de exemplificação deste artigo.

Abaixo segue imagem que demonstra a execução de dois processos agendados em instâncias do Middleware, onde é possível verificar:

• Status: Qual processo agendado que é executado (código) e quando ele foi iniciado;
• Servidor: servidor da instância;
• PID: Proccess ID da instância;
• Usuário: qual o usuário do sistema que está executando o processo.

 

 

Anote o Servidor + PID que você localizou e siga para o tópico 2 deste artigo.

 

 

1.2. WebServices - Consulta de Requisições de WebService

Para efetuar a verificação do PID através da Consulta de Requisições de WebServices, execute os passos abaixo:

 

1.2.1. Verifique no artigo ERP - WebServices - Como efetuar a Consulta de Requisições de WebServices informações sobre como efetuar o processo de Consulta de Requisições;

 

1.2.2. Realize a consulta de requisições normalmente conforme a sua necessidade. Assim que você localizar a requisição do WebService sendo processada, verifique no campo 'Servidor' o nome do Servidor e o PID da execução, conforme exemplo abaixo:

 

 

Anote o Servidor + PID que você localizou e siga para o tópico 2 deste artigo.

 

 

1.3. Processos Agendados - Execução de um processo agendado

Para efetuar a verificação do PID através da Consulta de Logs de Execução de Processos Agendados, execute os passos abaixo:

 

1.3.1. Acesse a tela F000LPA - Recursos / Processos Automáticos / Consulta Logs;

 

1.3.2. Efetue a consulta da execução do Processo Agendado desejado;

 

1.3.3. Verifique nos detalhes da execução do processo no quadro inferior da tela a informação do PID da instância o SapiensServer (sapienssrv.exe) que executou o processo, conforme exemplo da imagem abaixo:

 

 

Importante

A tela não exibirá o nome do Servidor. Desta forma, pode ocorrer que você encontrará mais de um Log com o mesmo PID, caso em Servidores de Middleware distintos coincidentemente tenham ocorrido a inicialização de uma instância de Middleware com o mesmo PID. Neste caso, você analisar os Logs para validar qual deles apresenta as informações do processo que você deseja verificar.

 

Anote o PID que você localizou e siga para o tópico 2 deste artigo.

 

 

 

2. Efetuando o acesso ao Log do Middleware da instância que executou o WebService/processo.

Com o Servidor (opcional, no caso de Processos Agendados) )e o PID (obrigatório) em mãos, execute os passos abaixo para localizar o Log da instância do Middleware que executou o processo.

 

2.1. Calcule o PID em valor Hexadecimal

 

2.1.1. Acesse a Calculadora do Windows;

 

2.1.2. Altere o tipo da calculadora para 'Programador', conforme exemplo abaixo:

 

Essa opção fará com que o valor do PID definido como numérico seja convertido para Hexadecimal.

 

Importante

A Calculadora do Windows pode apresentar instabilidade quando efetuada esta alteração. Em caso de dúvidas sobre o cálculo, feche a calculador e abra novamente, ou utilize outro aplicativo de calculadora que permita fazer esse tipo de cálculo.

 

2.1.3. Digite o PID que você deseja converter na Calculadora. Para efeito de exemplo, utilizaremos um PID da execução de um WebService de Pedidos do ERP (com.senior.g5.co.mcm.ven.pedidos@GravarPedidos_13). No caso exemplificado, o nome do Servidor é NB019086 e o PID é 28116.

 

 

O valor 28116 convertido em Hexadecimal é 6DD4, conforme exemplo abaixo:

 

Armazene essa informação e siga para o tópico 2.2.

 

2.2. Acessando os Logs do Middleware

Acesse os Logs do Middleware Senior, conforme configurações definidas no SeniorConfigCenter. Para maiores informações sobre configuração dos diretórios dos Logs, verifique o artigo TECNOLOGIA – Middleware – Como habilitar a geração de logs de texto do Senior Middleware.

 

Importante

Os Logs tem um padrão de nomenclatura específico. Acesse a Documentação relacionada aos Logs do Middleware dentro do Manual da Tecnologia para maiores informações.

Para os processos diretamente ligados ao ERP, os logs das instâncias começaram com os seguintes prefixos:

• Instância de WebService: MD-APP-SAPIENS
• Instância de Processos Agendados e AçõesSID: MD-APP-SAPIENSSRV

 

 

2.2.1. Caso você saiba já exatamente a pasta de Logs do Servidor do Middleware que executou o processo, acesse diretamente essa pasta (no nosso exemplo deste artigo, seria a pasta do Servidor NB019086).

 

2.2.2. Utilize a procura do Windows Explorer para procurar pelo trecho do valor hexadecial. Exemplo: *6DD4* (neste caso são utilizados asteriscos no início e fim do termo para indicar que esse texto poderá ser encontrado no meio de qualquer parte do nome do arquivo).

 

 

Observação

Você pode utilizar a data/hora de última modificação do arquivo como ponto de apoio para validar se faz sentido o arquivo de Log que você encontrou com o processo que você deseja verificar logs.

 

Atenção

Lembre-se de que os Logs do Middleware são compactados diariamente, conforme descrito no artigo TECNOLOGIA – Middleware – Como habilitar a geração de logs de texto do Senior Middleware. Desta forma, se você está procurando logs de datas anteriores, você precisará primeiro descompactar os Logs que tenham sido compactados pelo Middleware. Neste caso, sugere-se a descompatação em diretório diferente do diretório de gravação dos Logs, para não causar problemas de Performance de escrita na mesma pasta onde o Middleware armazena os Logs recentes,

 

 

2.2.3. Abra o arquivo encontrado e verifique as informações relacionadas a execução do processo que você deseja verificar.

 

Importante 

Lembre-se de que o Log que você abrirá de uma instância do Middleware que poderá ter processado diversas requisições diferentes. Sendo assim, a data/hora em que o processo foi executado será essencial para você chegar ao ponto adequado do Log que você deseja verificar.

 

Na abertura do Log você poderá verificar se os dados presentes no Log batem com Servidor e PID que você deseja verificar:

 

No exemplo indicado neste artigo (execução do WebService de Pedido), é possível utilizar data/hora para chegar as informações do processo no Log que foi identificado, conforme exemplo abaixo:

 

 

Observação

Devido a variação de horários nos Servidores envolvidos, podem haver diferenças de segundos/minutos com relação entre as informações dos diversos Logs e registros envolvidos.

 

 

 

Para mais informações sobre os WebServices do Gestão Empresarial | ERP, consulte o artigo ERP - WebServices - Onde é possível encontrar informações diversas sobre processo de integração via WebServices (índice).