Repolode
Enviar
control-theory

control-theory/gonzo

Uma interface de terminal em Go para analisar logs em tempo real, com gráficos ao vivo, distribuição por severidade, filtros por regex e insights opcionais com IA.

Ver no GitHubSite
Estrelas
2,787
Forks
116
Issues abertas
17
Último commit
há 28 dias

O que é?

Gonzo é uma interface de terminal para analisar fluxos de logs à medida que chegam, inspirada no k9s. Lê logs do stdin, de arquivos (incluindo padrões glob e modo follow), de pods do Kubernetes ou de um receiver OTLP que aceita logs via gRPC e HTTP. A detecção de formato abrange JSON, logfmt e texto simples, e é possível definir formatos personalizados em YAML.

O dashboard usa uma grade 2x2 com gráficos de frequência de palavras, atributos, distribuição por severidade e séries temporais, além de um mapa de calor da severidade nos últimos 60 minutos. É possível filtrar com expressões regulares, por severidade ou por namespace e pod do Kubernetes, além de abrir os detalhes dos logs. A análise com IA pode usar APIs compatíveis com OpenAI, Ollama, LM Studio ou a CLI do Claude Code.

Um dashboard web integrado chamado Dstl8 Lite, servido pelo mesmo binário na porta 5718, exibe os mesmos fluxos de logs no navegador, com workspaces, detecção de padrões e logs pesquisáveis. Ele pode ser aberto pela TUI pressionando d.

Recursos principais

  • 01Análise de logs em tempo real a partir de stdin, arquivos e pods do Kubernetes
  • 02Receiver OTLP integrado via gRPC e HTTP
  • 03Detecção automática dos formatos JSON, logfmt e texto simples, com suporte a formatos YAML personalizados
  • 04Filtros por regex, severidade, namespace e pod do Kubernetes
  • 05Mapa de calor de severidade e gráficos de séries temporais no terminal
  • 06Análise opcional com IA usando APIs compatíveis com OpenAI, Ollama, LM Studio ou Claude Code

Casos de uso

  • Acompanhar logs de aplicações em um servidor ou contêiner durante a depuração
  • Monitorar logs de pods do Kubernetes em tempo real, diretamente ou via k9s
  • Receber logs do OpenTelemetry de uma aplicação ou collector local durante o desenvolvimento
  • Pedir a um LLM local ou hospedado que resuma erros recorrentes em um fluxo de logs

Início rápido

  1. 1

    Instalar com Go

    go install github.com/control-theory/gonzo/cmd/gonzo@latest
  2. 2

    Ou instalar com Homebrew (macOS/Linux)

    brew install gonzo
  3. 3

    Analisar um arquivo de log

    gonzo -f application.log

Antes de usar

  • A instalação com go install requer uma toolchain do Go; como alternativa, instale com o Homebrew ou com um binário de uma versão lançada.
  • Os insights de IA precisam de uma chave de API ou de um modelo executado localmente, como o Ollama ou o LM Studio.

Tópicos

#logging#tui#terminal#log-analysis#opentelemetry#kubernetes#golang#ai#logs#ollama

Perguntas frequentes

O que é gonzo?
Uma interface de terminal em Go para analisar logs em tempo real, com gráficos ao vivo, distribuição por severidade, filtros por regex e insights opcionais com IA. Gonzo é uma interface de terminal para analisar fluxos de logs à medida que chegam, inspirada no k9s. Lê logs do stdin, de arquivos (incluindo padrões glob e modo follow), de pods do Kubernetes ou de um receiver OTLP que aceita logs via gRPC e HTTP. A detecção de formato abrange JSON, logfmt e texto simples, e é possível definir formatos personalizados em YAML.
gonzo é gratuito? Qual é a licença?
gonzo é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
gonzo ainda é mantido?
Manutenção ativa. O último commit de gonzo foi em 23 de set. de 2026.
Para que posso usar gonzo?
Acompanhar logs de aplicações em um servidor ou contêiner durante a depuração Monitorar logs de pods do Kubernetes em tempo real, diretamente ou via k9s Receber logs do OpenTelemetry de uma aplicação ou collector local durante o desenvolvimento Pedir a um LLM local ou hospedado que resuma erros recorrentes em um fluxo de logs
Como instalar gonzo?
Instalar com Go: go install github.com/control-theory/gonzo/cmd/gonzo@latest Ou instalar com Homebrew (macOS/Linux): brew install gonzo Analisar um arquivo de log: gonzo -f application.log
Onde consigo gonzo?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/control-theory/gonzo

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados