Gonzo Docs

Gonzo is a Go-based TUI (Terminal User Interface) log analysis tool that helps you analyze log streams with beautiful charts, AI-powered insights, and advanced filtering - all from your terminal.

Gonzo: a powerful, real-time log analysis terminal UI inspired by k9s.

✨ Key Features

• Live Streaming - Process logs as they arrive from stdin, files, or network

• OTLP Native - First-class support for OpenTelemetry (OTLP) log format

• Format Detection - Automatically detects JSON, logfmt, and plain text

• k9s-Inspired Layout - Familiar 2x2 grid interface

• Real-time Charts - Word frequency, attributes, severity distribution, and time series

• AI Analysis - Get intelligent insights about log patterns and anomalies

• Smart Navigation - Keyboard + mouse controls with vim-style shortcuts

🚀 Quick Start

Install Gonzo using your preferred method:

Go Install

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

Homebrew

brew install gonzo

Binary Download

Download the latest release for your platform from the releases page.

Start analyzing logs immediately:

# Analyze a log file
gonzo -f application.log

# Follow logs in real-time
gonzo -f /var/log/app.log --follow

# Analyze logs from stdin (traditional way)
cat application.log | gonzo

# Pipe from other commands
kubectl logs -f deployment/my-app | gonzo

📖 Documentation Sections

New to Gonzo? Start with the Getting Started section for installation and basic usage.

Essential Reading

• Installation - Get Gonzo up and running

• Quick Start - Your first log analysis

• Interface Overview - Understanding the dashboard

Core Features

• Log Input Methods - Files, stdin, and OTLP

• Patterns - Bubble up patterns and severity across your logs

• Filtering & Search - Find what matters

• AI Integration - (Optional) Intelligent log insights

Advanced Usage

• Configuration - Customize your experience

• Integration Examples - Real-world scenarios

• Troubleshooting - Common issues and solutions

🔗 Links

• GitHub Repository: control-theory/gonzo

• Report Issues: GitHub Issues

• Discussions: GitHub Discussions

🤝 Community

Gonzo is an open-source project built by the community. We welcome contributions, feedback, and bug reports!

• Star the project on GitHub if you find it useful

• Join the conversation in GitHub Discussions

• Join our Slack channel

• Check out our Contributing Guidelines

---

Made with ❤️ by ControlTheory and the Gonzo community