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 necessário consultar pontualmente aquele período e poucos segundos antes e depois. Para isso:
Ao clicar no + será criado o filtro daquele timestamp...
... que pode ser editado para considerar alguns segundos antes e/ou depois:
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), 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
Após filtrar o trecho desejado:
Como importar
Informe um nome significativo, lembrando que ficará visível para outros usuários, e deixe marcada a opção Create data view:
Se não estiver formatado como desejado, basta adicionar as colunas:
Pronto! Agora temos o log do cliente para ser analisado internamente:
Veja também: documentação detalhada para instalação da ferramenta: Gestao de logs Datasul com Elasticsearch |