control-theory/gonzo

これは何？

主な機能

• 01stdin、ファイル、KubernetesのPodから届くログをリアルタイムに分析
• 02gRPCとHTTPに対応する組み込みOTLP receiver
• 03JSON、logfmt、プレーンテキストを自動判別し、YAMLでカスタム形式を定義
• 04正規表現、重大度、KubernetesのnamespaceやPodによるフィルタリング
• 05ターミナルで重大度ヒートマップと時系列チャートを表示
• 06OpenAI互換API、Ollama、LM Studio、Claude Codeを使った任意のAI分析

ユースケース

• デバッグ中にサーバーやコンテナ上のアプリケーションログを追跡する
• k9sを介する方法も含め、KubernetesのPodログをリアルタイムで監視する
• 開発中にローカルアプリケーションやcollectorからOpenTelemetryログを受信する
• ローカルまたはホスト型のLLMに、ログストリームで繰り返し発生するエラーの要約を依頼する

クイックスタート

1. 1

   Goでインストール

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

   またはHomebrewでインストール（macOS/Linux）

   brew install gonzo
3. 3

   ログファイルを分析

   gonzo -f application.log

使う前に知っておきたいこと

• !go installでインストールする場合はGoツールチェーンが必要です。それ以外の場合はHomebrewまたはリリースバイナリでインストールできます。
• !AI分析にはAPIキー、またはOllamaやLM Studioなどのローカルで実行中のモデルが必要です。

トピック

よくある質問

gonzo とは？

リアルタイムのログ分析に対応したGo製ターミナルUI。ライブチャート、重大度の内訳、正規表現フィルタリング、任意で利用できるAI分析を備えています。 Gonzoは、k9sに着想を得た、到着するログストリームを分析するためのターミナルUIです。stdin、ファイル（globパターンや追従モードにも対応）、KubernetesのPod、またはgRPCとHTTPでログを受け付けるOTLP receiverからログを読み込みます。JSON、logfmt、プレーンテキストの形式を自動判別し、YAMLでカスタム形式も定義できます。

gonzo は無料で使えますか？ライセンスは？

gonzo は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

gonzo は今もメンテナンスされていますか？

活発にメンテナンス中。gonzo の最終コミットは 2026年9月23日 です。

gonzo は何に使えますか？

デバッグ中にサーバーやコンテナ上のアプリケーションログを追跡する k9sを介する方法も含め、KubernetesのPodログをリアルタイムで監視する 開発中にローカルアプリケーションやcollectorからOpenTelemetryログを受信する ローカルまたはホスト型のLLMに、ログストリームで繰り返し発生するエラーの要約を依頼する

gonzo のインストール方法は？

Goでインストール: go install github.com/control-theory/gonzo/cmd/gonzo@latest またはHomebrewでインストール（macOS/Linux）: brew install gonzo ログファイルを分析: gonzo -f application.log

gonzo はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/control-theory/gonzo