Sentry

Sentry

O Sentry é uma plataforma de monitoramento de erros e observabilidade que ajuda desenvolvedores a identificar, diagnosticar e corrigir falhas em suas aplicações em tempo real. Diferente de logs tradicionais, que exigem uma busca manual, o Sentry é proativo e focado na experiência do desenvolvedor.

Ativamento

O Sentry captura todas os erros automaticamente desde que a aplicação execute no perfil de Produção (Ver mais em: https://touchcomp.mywikis.wiki/wiki/Configurando_perfil_execucao_spring#Perfil_e_Sentry).

Caso seja necessário desativar o Sentry momentaneamente, o processo a ser feito é desativar o DSN fazendo com que os erros enviados pela aplicação sejam rejeitados pelos servidores do Sentry. Esse processo pode ser feito através do passo a passo abaixo:

• Acesse o projeto desejado no menu lateral.
• Vá em Settings (Configurações) > Client Keys (DSN).
• Clique no ícone de engrenagem ao lado da chave e mude o status para Disabled (Desativar). Isso mantém a chave salva, mas ela para de funcionar.

Para que o Sentry volte a ouvir os eventos novamente, basta realizar o mesmo processo descrito acima ativando a chave.

Configuração dos erros

Por default, todos os erros que ocorrem no Touch Web são enviados ao Sentry mas é possível configurar para que determinadas exceções não sejam enviadas quando ocorrerem. Veja as opções abaixo:

• Erros do Tipo Warning (W.ERP): Não são enviados
• Erros com o prefixo "E.N.": Não são enviados
• Erros cujos códigos estão mapeados no recurso 1962 - Gerenciamento de Exceções: Não são enviados

Recurso 1962 - Gerenciamento de Exceções

Nesse recurso, é possível mapear códigos de exceções que, quando ocorrerem, não serão enviadas ao Sentry. No recurso, há duas abas: Principal e Pesquisar.

1. Na aba Principal, há apenas um campo de texto onde o usuário deve informar o código da mensagem de erro ou um label único que identifique o erro. Caso seja um erro corretamente mapeado no sistema, irá ser exibido o código junto com a mensagem, se não retornar a mensagem verifique o código informado. Por outro lado, se o label mapeado é uma label do erro, será retornado o próprio texto no campo da mensagem. Ao clicar em Adicionar, o erro será adicionado a lista de exceções que não serão reportadas. Os sistemas dos clientes realizam consultas de hora em hora para consultar essa lista, então demora um tempo até que todos os sistemas deixem de reportar o erro.

2. Na aba Pesquisa, há um campo de texto e uma tabela. O usuário informa um texto e clica em Enter e os erros já mapeados que correspondem a pesquisa são exibidos na tabela. Pode-se remover uma exceção da lista ao clicar no botão de Remover da respectiva linha.

Os erros mapeados nesse recurso são salvos em um arquivo no servidor da Touch Comp e cada aplicação executando o Touch Api consulta esse arquivo a cada 1 hora para atualizar sua lista de exceções que não serão reportadas.