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:
Start analyzing logs immediately:
📖 Documentation Sections
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
Last updated