Repolode
control-theory

control-theory/gonzo

Una interfaz de terminal en Go para analizar logs en tiempo real, con gráficos dinámicos, desglose por nivel de severidad, filtros regex y análisis opcional con IA.

Estrellas
2,787
Forks
116
Issues abiertos
17
Último commit
hace 28 días

¿Qué es?

Gonzo es una interfaz de terminal para analizar flujos de logs a medida que llegan, inspirada en k9s. Lee logs desde stdin, archivos (incluidos patrones glob y el modo follow), pods de Kubernetes o un receptor OTLP que acepta logs por gRPC y HTTP. Detecta formatos JSON, logfmt y texto sin formato, y permite definir formatos personalizados en YAML.

El panel usa una cuadrícula de 2 × 2 con gráficos de frecuencia de palabras, atributos, distribución por nivel de severidad y series temporales, además de un mapa de calor de la severidad durante los últimos 60 minutos. Se pueden aplicar filtros con expresiones regulares, por nivel de severidad o por namespace y pod de Kubernetes, y consultar los detalles de los logs. El análisis con IA puede usar APIs compatibles con OpenAI, Ollama, LM Studio o la CLI de Claude Code.

Un panel web integrado llamado Dstl8 Lite, servido desde el mismo binario en el puerto 5718, muestra los mismos flujos de logs en un navegador e incluye espacios de trabajo, detección de patrones y búsqueda de logs. Se puede abrir desde la interfaz de terminal presionando d.

Funciones clave

  • 01Análisis de logs en tiempo real desde stdin, archivos y pods de Kubernetes
  • 02Receptor OTLP integrado por gRPC y HTTP
  • 03Detección automática de formatos JSON, logfmt y texto sin formato, con formatos personalizados en YAML
  • 04Filtros regex, por nivel de severidad y por namespace y pod de Kubernetes
  • 05Mapa de calor de severidad y gráficos de series temporales en la terminal
  • 06Análisis opcional con IA mediante APIs compatibles con OpenAI, Ollama, LM Studio o Claude Code

Casos de uso

  • Seguir logs de aplicaciones en un servidor o contenedor durante la depuración
  • Observar en tiempo real los logs de pods de Kubernetes, directamente o mediante k9s
  • Recibir logs de OpenTelemetry desde una aplicación o un collector local durante el desarrollo
  • Pedir a un LLM local o alojado que resuma errores recurrentes en un flujo de logs

Inicio rápido

  1. 1

    Instalar con Go

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

    O instalar con Homebrew (macOS/Linux)

    brew install gonzo
  3. 3

    Analizar un archivo de registro

    gonzo -f application.log

Antes de usarlo

  • La instalación mediante go install requiere una cadena de herramientas de Go; también puedes instalarlo con Homebrew o con un binario de una versión publicada.
  • Los análisis de IA requieren una clave de API o un modelo ejecutado localmente, como Ollama o LM Studio.

Temas

Preguntas frecuentes

¿Qué es gonzo?
Una interfaz de terminal en Go para analizar logs en tiempo real, con gráficos dinámicos, desglose por nivel de severidad, filtros regex y análisis opcional con IA. Gonzo es una interfaz de terminal para analizar flujos de logs a medida que llegan, inspirada en k9s. Lee logs desde stdin, archivos (incluidos patrones glob y el modo follow), pods de Kubernetes o un receptor OTLP que acepta logs por gRPC y HTTP. Detecta formatos JSON, logfmt y texto sin formato, y permite definir formatos personalizados en YAML.
¿gonzo es gratuito? ¿Qué licencia tiene?
gonzo es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿gonzo sigue mantenido?
Mantenimiento activo. El último commit de gonzo fue el 23 sept 2026.
¿Para qué puedo usar gonzo?
Seguir logs de aplicaciones en un servidor o contenedor durante la depuración Observar en tiempo real los logs de pods de Kubernetes, directamente o mediante k9s Recibir logs de OpenTelemetry desde una aplicación o un collector local durante el desarrollo Pedir a un LLM local o alojado que resuma errores recurrentes en un flujo de logs
¿Cómo se instala gonzo?
Instalar con Go: go install github.com/control-theory/gonzo/cmd/gonzo@latest O instalar con Homebrew (macOS/Linux): brew install gonzo Analizar un archivo de registro: gonzo -f application.log
¿Dónde consigo gonzo?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/control-theory/gonzo

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados