gonzo

Gonzo! The Go based TUI log analysis tool

What is gonzo?

Gonzo! The Go based TUI log analysis tool

Overview of gonzo

What it is

Gonzo is a Go-based terminal user interface (TUI) for real-time log analysis. It is inspired by k9s and provides live streaming, Kubernetes native integration, OpenTelemetry support, and an interactive dashboard. It can process logs from stdin, files, or network sources.

Key features

  • Real-time log streaming with automatic format detection (JSON, logfmt, plain text) and severity tracking.
  • Interactive dashboard with a k9s-inspired 2x2 grid layout, real-time charts, keyboard and mouse navigation, and a fullscreen log viewer.
  • Web dashboard (Dstl8 Lite) served from the binary, featuring WebSocket live updates, severity heatmaps, pattern analysis, and log search.
  • Advanced filtering with regex, attribute search, severity filtering, and Kubernetes namespace/pod filtering.
  • Customizable themes with 11+ built-in skins, light/dark modes, and YAML-based custom skins.
  • AI-powered insights for pattern detection, anomaly analysis, and root cause suggestions, supporting multiple models (GPT-4, Claude, local models via Ollama, etc.).

Use cases

  • Real-time monitoring and analysis of application logs from files, stdin, or Kubernetes clusters.
  • Debugging and troubleshooting with AI-assisted pattern detection and anomaly identification.
  • Integration with deployment platforms such as Vercel, Supabase, Railway, Cloudflare Workers, Netlify, Fly.io, Render, and AWS CloudWatch.
  • Local log analysis with a browser-based GUI (Dstl8 Lite) for richer visualization.

Getting started

Installation options: bash # Using Go go install github.com/control-theory/gonzo/cmd/gonzo@latest # Using Homebrew (macOS/Linux) brew install gonzo # Using Nix nix run github:control-theory/gonzo # Build from source git clone https://github.com/control-theory/gonzo.git cd gonzo make build Basic usage: bash gonzo -f application.log cat application.log | gonzo gonzo --k8s-enabled=true --k8s-namespaces=default For more details, see the repository README.

License and pricing

The project is licensed under MIT and is open source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/control-theorygonzo.svg)](https://yunodb.com/tools/control-theorygonzo?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/control-theorygonzo?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/control-theorygonzo.svg" alt="Featured on YunoDB" height="20"></a>