Name: Gonzo
SKU: -

소개

Gonzo!는 Go 언어로 작성된 TUI(터미널 사용자 인터페이스) 기반 로그 분석 도구입니다. k9s에서 영감을 받은 실시간 로그 분석 대시보드를 제공하며, 파일, stdin, Kubernetes 클러스터, OpenTelemetry 프로토콜(OTLP) 등 다양한 소스에서 로그를 수집하고 분석할 수 있습니다. 또한 AI 기반 인사이트와 웹 대시보드(Dstl8.Lite)를 지원합니다.

상세정보

실시간 로그 분석

Gonzo는 파일, stdin, Kubernetes 클러스터, OTLP 네트워크 등에서 로그를 실시간으로 스트리밍하여 분석합니다. JSON, logfmt, 일반 텍스트 형식을 자동 감지하며, YAML 설정을 통해 사용자 정의 로그 형식을 지원합니다.

대화형 대시보드

k9s에서 영감을 받은 2×2 그리드 인터페이스를 제공하며, 실시간 차트(단어 빈도, 속성, 심각도 분포, 시계열), 키보드 및 마우스 내비게이션, 스마트 로그 뷰어, 전체 화면 로그 뷰어, 전역 일시 정지, 로그 항목 상세 모달, 로그 카운트 분석(히트맵, 패턴 분석, 서비스 분포) 등을 포함합니다.

웹 대시보드 (Dstl8.Lite)

Gonzo 바이너리에 내장된 React 기반 웹 대시보드로, 별도 의존성 없이 실행됩니다. WebSocket을 통해 실시간으로 로그를 스트리밍하며, 심각도 분포 차트, 감성 히트맵, 패턴 분석, 로그 뷰어, 소스 브라우저, 라이트/다크 모드를 제공합니다. TUI에서 ‘d’ 키를 누르면 브라우저에서 실행됩니다.

고급 필터링

정규식 필터, 속성 검색, 심각도 필터(Ctrl+f), Kubernetes 필터(Ctrl+k), 다중 레벨 선택, 대화형 선택 기능을 제공합니다.

사용자 정의 테마

Dracula, Nord, Monokai, GitHub Light 등 11개 이상의 내장 테마와 라이트/다크 모드를 지원하며, YAML 설정으로 사용자 정의 스킨을 만들 수 있습니다.

AI 기반 인사이트

패턴 감지, 이상 분석, 근본 원인 제안을 제공하며, OpenAI, Claude Code, LM Studio, Ollama 등 다양한 AI 공급자를 지원합니다. 로컬 AI 모델을 사용하여 완전히 오프라인으로 실행할 수도 있습니다.

설치 방법

Windows에서는 winget 명령어로 설치할 수 있습니다:

winget install --id control-theory.gonzo --exact

또는 GitHub Releases 페이지에서 최신 바이너리를 다운로드할 수 있습니다. Go가 설치된 환경에서는 go install github.com/control-theory/gonzo/cmd/gonzo@latest로 설치할 수 있으며, macOS/Linux에서는 Homebrew(brew install gonzo)를 사용할 수 있습니다.

기본 사용법

파일에서 로그를 읽으려면 -f 플래그를 사용합니다:

gonzo -f application.log

여러 파일이나 glob 패턴을 지정할 수 있으며, --follow 플래그로 파일을 실시간으로 추적할 수 있습니다. stdin에서 로그를 파이프로 전달할 수도 있습니다:

cat application.log | gonzo

Kubernetes 클러스터에서 직접 로그를 스트리밍하려면 --k8s-enabled=true 플래그를 사용합니다:

gonzo --k8s-enabled=true --k8s-namespaces=default

OTLP 수신기를 활성화하려면 --otlp-enabled 플래그를 사용합니다. 기본적으로 gRPC는 4317 포트, HTTP는 4318 포트에서 수신합니다.

설정 파일

영구 설정은 ~/.config/gonzo/config.yml 파일에 저장할 수 있습니다. 파일 입력, 팔로우 모드, 업데이트 간격, 버퍼 크기, 스킨, AI 공급자, 웹 대시보드 포트 등을 설정할 수 있습니다.

활용 예시

애플리케이션 로그 파일을 실시간으로 모니터링하고 심각도 분포와 패턴을 분석합니다.
Kubernetes 클러스터의 포드 로그를 네임스페이스나 레이블로 필터링하여 스트리밍합니다.
OpenTelemetry 수집기나 애플리케이션에서 OTLP 프로토콜로 로그를 전송하여 분석합니다.
Docker 컨테이너 로그를 파이프로 연결하여 분석합니다.
AI 분석을 통해 로그 패턴의 이상 징후를 감지하고 근본 원인을 파악합니다.

지원 환경

Windows, macOS, Linux에서 실행할 수 있으며, Go 1.21 이상이 필요합니다. Windows에서는 winget으로 설치할 수 있고, macOS/Linux에서는 Homebrew를 지원합니다. 자세한 시스템 요구 사항은 공식 문서를 참조하세요.

버전 및 업데이트

현재 버전은 v0.4.3이며, GitHub Releases 페이지에서 최신 릴리스를 확인할 수 있습니다.

라이선스 및 확인 사항

Gonzo는 MIT 라이선스로 배포됩니다. AI 분석 기능을 사용하려면 OpenAI API 키 또는 Claude Code CLI 등 해당 AI 서비스의 인증이 필요할 수 있습니다. 로컬 AI 모델(LM Studio, Ollama)을 사용하는 경우 별도의 API 키가 필요하지 않을 수 있습니다.

시스템 요구사항

Windows 11 · x64 · Go 1.21+ (소스 빌드 시)