Objetivo

  • Centralizar o acesso aos logs do Datasul
  • Possibilitar consultas ágeis e inteligentes
  • Possibilitar monitoramento de palavras chave, como erros e alertas
  • Evitar consulta direta nos arquivos, que são muito grandes e complicados
  • Evitar perda de logs rotacionados, que são eliminados frequentemente devido ao tamanho


Esta documentação foi criada para o time interno da Totvs, mas pode ser consultada pelos clientes como base para utilização na sua própria estrutura.


Acesso

Solicite url, usuário e senha ao administrador do sistema.


Ao logar no portal, o usuário é direcionado para uma visão default, que traz todos os campos do log, o que pode ser confuso no primeiro momento.

Recomenda-se utilizar o filtro PASOE pré-cadastrado:


Ao selecionar o filtro acima, passarão a ser exibidos os dados mais relevantes:

Os campos podem ser customizados e novos filtros podem ser salvos a qualquer momento.


Casos de uso

Selecionar o log desejado na lista


Selecionar o período desejado

  • Atualmente os logs estão sendo mantidos por 7 dias.


Procurar uma palavra chave simples


Procurar uma palavra chave em modo case-sensitive

Abaixo do campo pasoe.message existe um atributo keyword, que possui o mesmo conteúdo de messagem, porém é Case Sensitive:


Esconder do log um tipo de mensagem indesejado

Ao clicar no botão - (menos)...

... é criado um filtro para omitir aquele padrão de mensagens, que pode ser editado e/ou removido a qualquer momento:


Filtrar o log por um processo

Como o PASOE é multi-thread, diversos processo são exibidos, poluindo a consulta.

Ao selecionar o tid (thread ID) do processo que você deseja consultar (botão +)...

... a consulta ficará muito mais fluída:


Filtrar pontualmente um período

Ao encontrar uma mensagem específica, pode ser necesário consultar pontualmente aquele período e os momentos seguintes. Para isso:

Ao clicar no + será criado o filtro daquele timestamp...

... que pode ser editado para considerar os próximos segundos ou minutos:

Resultando no log filtrado com aquela sequência de processamentos:



Filtros com caracteres especiais

Para usar caracteres especiais nos filtros, como : ( ) e outros, usar contrabarra. Exemplo: pasoe.message.keyword: *\(Procedure\:*


Criar novos filtros

Consultas relevantes podem ser salvas para uso posterior e colaboração com os outros Totvers.

Basta configurar o filtro desejado e na hora de Salvar, atenção para informar um Title diferente dos já existentes e marcar a opção Save as new search:



Filtros importantes

Erro cláusula FIELDS (8826)

Listando as ocorrências do erro referente à utilização de campo que não consta na cláusula FIELDS da leitura:


Erro de CRC (1896)


Erro Mismatched Parameters (3230)



Gráfico com resumo dos erros

No menu Dashboards podem ser criados gráficos para mostrar a ocorrência de erros em formato big numbers:



Importar logs enviados pelo cliente

O cliente pode exportar fragmentos de logs em formato CSV (por exemplo, filtrando apenas a fração de segundos do erro e apenas o TID do processo sob análise, entre outros), e o suporte pode importar internamente para agilizar a análise, evitando arquivos gigantes e sujos, e pegando a situação real que aconteceu em produção ao invés de ter que tentar reproduzir o problema em homologação.


Como exportar um fragmento do log para CSV


Como importar