Log de erros

Peça ao usuário o horário aproximado e a tela, e filtre por aqui. A coluna de URL costuma identificar o caso mais rápido do que a mensagem, porque a mesma falha técnica aparece com textos parecidos em lugares diferentes.

O nome da classe vem abreviado na coluna; o nome completo está no tooltip.

Visualização de erros do sistema — este é o papel da tela "Log de Erros" dentro da plataforma.

Um usuário relata "deu erro ao salvar": (1) pesquise no filtro um trecho da mensagem que ele viu, ou a URL da tela; (2) na linha encontrada, passe o mouse sobre Classe e Mensagem — a dica de contexto mostra o texto completo; (3) cite o código da primeira coluna no chamado — ele identifica o registro exato sem depender de data e hora, e a coluna de usuário confirma se era a mesma pessoa.

O campo de filtro busca por classe, mensagem ou URL, e a tecla Enter dispara a pesquisa sem precisar do mouse. O menu Exportar no rodapé gera Excel, CSV ou PDF do conjunto retornado — lembrando que a consulta traz no máximo 1.000 registros, então em investigações longas filtre primeiro para caber no recorte e só então exporte o resultado.

É um teto rígido, e a exportação exporta esses mesmos 1.000. Num dia de incidente, o log estoura o limite facilmente e o resto simplesmente não aparece — inclusive o começo do problema, que é a parte que interessa.

Por isso: filtre antes de contar. Uma busca por parte da mensagem ou da URL devolve o recorte certo; olhar a lista solta leva à conclusão errada sobre volume.

O acesso é restrito ao administrador da plataforma, e nesse contexto a tela mostra os erros de todas as empresas — por isso a coluna de empresa importa tanto quanto a mensagem.

A coluna de usuário pode trazer um cliente do portal, e não um usuário interno: falha vinda do portal é sempre mais urgente, porque quem viu a tela de erro foi o cliente.

O selo de lido/não lido é apenas informativo nesta tela: não há ação de marcar como lido aqui.

Cada linha é uma falha capturada com data, tela, usuário e a pilha técnica. Serve para o suporte entender o que aconteceu sem depender do relato. Erro repetido na mesma tela é sinal de defeito, não de uso errado — vale abrir um chamado com o número da linha.

Ao salvar uma visão pelo botão Visões, ela guarda quatro coisas: o texto da busca, os filtros aplicados, quais colunas aparecem (e em que ordem) e por qual coluna a lista está ordenada. Aplicar a visão restaura tudo de uma vez — inclusive zerando a ordenação e a página em que você estava, para o resultado ser exatamente o que a visão descreve. Visões salvas antes desta versão continuam válidas: o que elas não guardaram simplesmente não muda ao aplicar.

Nas fichas, sair de um campo já dispara a conferência do que dá para conferir na hora: campo obrigatório deixado em branco e e-mail mal formado. O aviso aparece embaixo do campo e desaparece quando você começa a corrigir. Campo numérico não precisa de aviso: ele simplesmente não aceita letra enquanto você digita. Isso é conforto, não a validação final: ao salvar, o sistema confere tudo de novo do lado do servidor.

O detalhe de cada erro começa com a cadeia de causas — uma linha por camada, da mais externa até a origem — e, logo abaixo, o ponto do nosso código onde o problema apareceu. É aí que está a resposta na maioria das vezes. O restante é a pilha completa, útil para quem vai depurar, e ela pode aparecer cortada no fim: o registro tem tamanho máximo, e preferimos garantir a causa a garantir o rodapé. Se um erro aparecer muitas vezes seguidas com a mesma causa, é um problema só — não vários.

Esta lista é só de leitura: o registro não se edita nem se apaga por aqui, porque é prova do que aconteceu. A busca do topo procura nos campos de texto; o botão Filtros abre o painel lateral com os recortes (situação, tipo, empresa…); a combinação pode ser salva como visão e reaberta com um clique. No menu ⋮, Excel e PDF levam o conjunto inteiro filtrado — não só a página da tela — e o "exportar tudo" pede a senha. O olho da linha abre o detalhe ao lado.

A lista não para mais nos 1.000 erros mais recentes: ela pagina no banco, o número do rodapé é o total do filtro e o export leva todos. Para achar um erro antigo, busque pela mensagem, pela classe completa ou pelo rastreamento da pilha.

Abra o registro e olhe a Linha do tempo, à direita: ela mostra cada alteração como "de um valor para outro", com a pessoa e a data. Quando há muita alteração, use os dois filtros no topo da linha do tempo — um por campo, outro por pessoa. A procura é feita no banco, então alteração antiga aparece do mesmo jeito. Você também pode perguntar ao Tenkai: "quem mudou o contrato 482?".

Esta tela lista FALHAS: o sistema tentou fazer algo que sabe fazer e não conseguiu. Quando ele recusa de propósito — excluir um cliente que tem contrato, baixar um título já baixado, aprovar sem alçada —, isso não é falha, é o sistema funcionando, e a explicação vai direto para quem clicou. Misturar as duas coisas faria o painel de erros contar decisões corretas como problemas e esconderia as falhas de verdade no meio delas.

Todo perfil que administra a conta — em termos práticos, quem pode alterar configurações da empresa, acessos ou alçadas. É leitura apenas: ninguém apaga nem edita registro de erro por aqui, e conceder a visão desta tela não concede mais nada em nenhuma outra. Se alguém do seu time precisa acompanhar erros sem administrar a conta, o caminho é conceder a visualização desta tela ao perfil dessa pessoa, pela tela de Acessos.