…ou arrasta-os para aqui. Se abrires vários, intercalam-se por data. Nada é enviado para nenhum servidor.
Guia de utilização
O que é e para que serve
Cola um log ou abre um ficheiro e esta ferramenta entende-o: deteta o formato, agrupa as linhas em eventos (um rastreio de 40 linhas é UM evento, não 40), extrai os padrões que se repetem, assinala a causa raiz das exceções e reduz tudo para o colares numa IA sem gastar uma fortuna em tokens. Tudo no teu navegador: o log não sai do teu equipamento.
Porque um evento não é uma linha
Se filtras por ERROR linha a linha, ficas com o cabeçalho da falha e perdes o rastreio, que é justamente o que ias ler. Aqui as continuações (at …, Caused by:, File "…", line N) colam-se ao seu evento antes de filtrar, contar ou reduzir.
Padrões
«ligado a 10.0.0.1» e «ligado a 10.0.0.7» são a mesma mensagem. Agrupando-as, um log de um milhão de linhas transforma-se em duzentas coisas que uma pessoa consegue ler. Daí saem a taxa de erro por padrão, o que aparece uma só vez (que costuma ser o que procuravas) e a comparação entre duas execuções.
Para IA
Corta o log para um orçamento de tokens que tu defines, conservando os erros com o seu rastreio, o que aconteceu mesmo antes e o excecional; o repetido resume-se com a sua contagem. Os tokens contam-se com o tokenizador real do modelo, não com uma estimativa. E podes tapar os segredos antes de copiar.
Higiene
Verifica se o teu log está bem escrito: palavras-passe impressas, a mesma linha quarenta mil vezes, datas sem fuso horário (que tornam impossível cruzar duas máquinas), tudo no mesmo nível, ou nenhum identificador com que seguir um pedido.
Logs de contentores (envolvidos)
O que sai de docker logs em JSON, do Kubernetes (CRI), de journalctl -o json, do OpenTelemetry (OTLP JSON) ou do CloudTrail vem envolvido: o texto da tua aplicação vai lá dentro, e partido. Um rastreio Java chega como quarenta registos separados. Reconhece-se o invólucro, tira-se o texto de dentro, os pedaços voltam a juntar-se e analisa-se como se fosse o log original; a data e o nível do invólucro só se usam se o texto não trouxer os seus.
O que distingue estes eventos?
Filtra o que te interessa (os erros, uma faixa de tempo) e clica em O que distingue…?: diz-te que pares campo=valor aparecem muito mais aí do que no resto do log. «92 % dos erros são version=2.4.1, contra 10 % do resto» é a pista que não vês lendo trezentos erros um a um. É uma comparação de proporções, não um teste estatístico: os eventos de um log não são independentes.
Coletores
Como Filebeat, Fluent Bit, Alloy e Vector agrupariam este mesmo log com a sua regra multilinha, ao lado de como esta ferramenta o agrupa, com as diferenças marcadas: é a forma de ver, antes de implementar, que o teu coletor vai partir os rastreios. E escreve-te a regra dos quatro a partir do detetado, no dialeto de expressões regulares de cada um.
Seguir ao vivo
Como tail -f. Abre o ficheiro com Abrir ficheiro(s) e ativa Seguir ao vivo: a cada 2 segundos verifica-se se cresceu e, se sim, relê-se o final e o visualizador desce até ao último. Se for truncado ou rodado, diz-se. Precisa de um navegador que deixe voltar a ler um ficheiro já escolhido (Chrome ou Edge no computador); nos outros o interruptor não aparece, e abrir uma pasta continua a dar o estado de hoje de uma série rodada.
O que NÃO faz
Não se liga a nenhum servidor: o que se segue ao vivo é um ficheiro do teu disco, não um fluxo de rede. De um ficheiro muito grande analisa-se uma janela (princípio ou final) e diz-se-te qual — para percorrer centenas de GB existe o Visualizador de ficheiros gigantes.
