Join our Slack

GONZO

Gonzo is a powerful, real-time log analysis terminal UI inspired by k9s. Analyze log streams with beautiful charts, AI-powered insights, and advanced filtering – all from your terminal.

Get Started on Github
Install Now

Key Features

Real-Time Analysis

Process logs from multiple sources with OTLP and Victoria Logs native support, automatic format detection, and color-coded severity tracking.

Interactive Dashboard

k9s-inspired 2×2 grid interface with real-time charts, stay in-flow with vim-style navigation, and expandable modal views for deep log analysis.

Advanced Filtering

Drill down faster, surface what matters with regex support, attribute search, severity filtering, and interactive keyboard/mouse navigation.

AI-Powered Insights

Get intelligent pattern detection, anomaly analysis, and root cause suggestions. Works with OpenAI, Ollama, LM Studio, and more.

Multiple Log Sources

Stream from Victoria Logs, receive via OTLP (OpenTelemetry), tail log files, or pipe from kubectl and other tools.

Customizable Themes

11+ beautiful themes available including Dracula, Nord, and GitHub Light. Create custom skins with YAML or use ControlTheory’s original themes.

0 stars
Star us to stay updated!

TUI tool for log analysis. It looks cool and seems
really good. It even has a heatmap.
It can also receive logs in real-time via
OpenTelemetry. It’s super modern. Yay yay!

It’s exactly what I’ve been dreaming about as the
ideal UX for logs analysis in Uncloud CLI/TUI.

This is a great tool and it immediately became
part of my toolset.

I decided to give it a shot. It’s really nice! One of
the things I always loved about datadog’s log
analysis tool was its ability to surface log patterns.

Great tool ! awesome job!

See Gonzo in Action

See Gonzo in Action

Gonzo’s Main Deshboards

Gonzo’s Main Deshboards

Stats!

Stats!

Heatmaps!

Heatmaps!

Quick Installation

Using Go

IInstall directly with Go (requires Go 1.21+)

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

Using Homebrew

Available on macOS and Linux

brew install gonzo

Download Binary

Get the latest release for your
platform

-> Download from GitHub Releases

Build from Source

Clone and build the project yourself

git clone https://github.com/control-theory/gonzo.git
cd gonzo
make build

Quick Start

Start analyzing logs in seconds:

# Analyze logs from a file
$ cat application.log | gonzo

# Stream Kubernetes logs
$ kubectl logs -f deployment/my-app | gonzo

# Stream from Victoria Logs
$ gonzo –vmlogs-url=”http://localhost:9428″ –vmlogs-query=”*”

# Receive OTLP logs
$ gonzo –otlp-enabled

# With AI analysis
$ export OPENAI_API_KEY=sk-your-key-here
$ cat logs.json | gonzo

Learn More

Troubleshoot Infrastructure and App Logs Together
Tail AWS CloudWatch Logs with Gonzo
Using Gonzo with K9s and Stern
Live Tailing Grafana Loki Logs 
Analyzing Vercel Logs with Open Source TUI