Changelog

All notable changes to Gonzo are documented in this file. The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

Added

• Additional documentation and examples

• Enhanced GitBook documentation site

Changed

• Improved error messages and user feedback

Fixed

• Various bug fixes and stability improvements

0.1.6 - 2024-08-27

Added

• Full screen log viewing with f key

• Extended character limit for search and filter (200 chars)

• Increased OTLP receive message size for larger log payloads

Changed

• Improved search and filter input handling

• Enhanced OTLP receiver performance

Fixed

• Search and filter character limit issues

• OTLP message size limitations

Contributors

• @destari - Full screen viewing feature

• @rbg - OTLP message size improvements

• @jon-spyder - Search/filter character limit

• @vine-mxm - Documentation updates

0.1.5 - 2024-08-24

Fixed

• OTLP handling now matches stdin processing

• Improved OTLP log receiver stability

Changed

• Unified OTLP and stdin log processing pipeline

• Better error handling for OTLP connections

Contributors

• @destari - OTLP handling fixes

0.1.4 - 2024-08-21

Added

• Enhanced pattern extraction with drain3 algorithm

• Improved service distribution tracking

• Better severity-specific pattern analysis

Changed

• Optimized pattern detection performance

• Improved Counts modal visualization

Fixed

• Pattern extraction accuracy improvements

• Service tracking edge cases

0.1.3 - 2024-08-15

Added

• AI model selection modal (m key)

• Support for multiple AI providers (OpenAI, Ollama, LM Studio)

• Automatic model detection and selection

• AI chat mode for interactive log analysis

Changed

• Improved AI integration architecture

• Better model compatibility checking

• Enhanced AI response formatting

Fixed

• AI provider connection issues

• Model switching stability

0.1.2 - 2024-08-10

Added

• Custom log format support

• Format configuration via YAML files

• Built-in formats for Loki and common log types

• Format auto-detection improvements

Changed

• Enhanced log parsing flexibility

• Improved format detection accuracy

Fixed

• Format detection edge cases

• Custom format loading issues

0.1.1 - 2024-08-05

Added

• Custom skins/themes support

• Multiple built-in themes (Dracula, Nord, Monokai, etc.)

• Theme configuration via YAML

• ControlTheory branded themes

Changed

• Improved color scheme architecture

• Better theme switching performance

Fixed

• Theme rendering issues

• Color contrast problems

0.1.0 - 2024-08-01

Added

• Initial public release

• Real-time log analysis TUI

• OTLP receiver (gRPC and HTTP)

• AI-powered log insights

• Pattern detection with drain3

• Word frequency tracking

• Attribute extraction and analysis

• Counts modal with heatmap visualization

• File input with glob support

• Follow mode (tail -f behavior)

• Multiple log format support (JSON, logfmt, plain text)

• Configurable update intervals

• Pause/resume functionality

• Search and filter capabilities

• Vim-style navigation

• Mouse support

• 11+ built-in themes

• Configuration file support

Technical Details

• Built with Bubble Tea TUI framework

• Lipgloss for styling

• Cobra for CLI

• Viper for configuration

• OpenTelemetry OTLP support

• Go 1.21+ required

Version History Summary

Version	Date	Highlights
0.1.6	2024-08-27	Full screen viewing, extended search
0.1.5	2024-08-24	OTLP handling improvements
0.1.4	2024-08-21	Enhanced pattern extraction
0.1.3	2024-08-15	AI model selection, multi-provider
0.1.2	2024-08-10	Custom log formats
0.1.1	2024-08-05	Custom skins/themes
0.1.0	2024-08-01	Initial release

Upgrade Notes

Upgrading to 0.1.6

No breaking changes. New features available immediately:

• Press f in log viewer for full screen mode

• Search and filter now support up to 200 characters

• OTLP receiver handles larger messages

Upgrading to 0.1.5

No breaking changes. OTLP improvements are automatic.

Upgrading to 0.1.4

No breaking changes. Pattern extraction improvements are automatic.

Upgrading to 0.1.3

New AI features:

• Press m to select AI models

• Automatic model detection for Ollama and LM Studio

• No configuration changes needed

Upgrading to 0.1.2

Custom formats now supported:

• Place format files in ~/.config/gonzo/formats/

• Use --format=name to specify custom format

• See documentation for format syntax

Upgrading to 0.1.1

Custom skins now supported:

• Place skin files in ~/.config/gonzo/skins/

• Use --skin=name or set in config file

• See documentation for skin syntax

Upgrading to 0.1.0

Initial release - no upgrade path.

Installation Methods

Go Install

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

Homebrew

brew tap control-theory/gonzo
brew install gonzo

Binary Download

Download from GitHub Releases

Build from Source

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

Deprecations

No features have been deprecated yet.

Breaking Changes

No breaking changes in any release to date.

Known Issues

Current Known Issues

• Custom formats: Some complex regex patterns may have performance impact

• OTLP: Very large batch sizes may cause memory spikes

• AI: Rate limiting may occur with high-frequency analysis requests

• Terminal: Some older terminals may have limited mouse support

See GitHub Issues for complete list.

Roadmap

Upcoming Features

Short-term (Next Release):

• Performance optimizations for high-volume logs

• Additional built-in log formats

• Enhanced AI prompt templates

• Better error messages

Medium-term (3-6 months):

• Plugin system for custom extensions

• Export and reporting capabilities

• Additional AI provider support

• Advanced filtering DSL

Long-term (6+ months):

• Distributed log analysis

• Web-based interface option

• Log aggregation features

• Enterprise features

See GitHub Projects for detailed roadmap.

Contributing

We welcome contributions! See:

• Contributing Guidelines

• Development Setup

• GitHub Issues

Release Process

1. Version Bump: Update version in code

2. Changelog: Update this file

3. Tag: Create git tag (e.g., v0.1.6)

4. Push: Push tag to GitHub

5. Build: GitHub Actions builds binaries

6. Release: Automated release creation

7. Announce: Community announcement

Support

• Documentation: https://docs.controltheory.com/gonzo

• Issues: https://github.com/control-theory/gonzo/issues

• Discussions: https://github.com/control-theory/gonzo/discussions

• Email: [email protected]

License

Gonzo is licensed under the MIT License. See LICENSE for details.

Credits

Core Team

• ControlTheory - Development and maintenance

Contributors

Thanks to all contributors! See Contributors for complete list.

Special Thanks

• Charm - Bubble Tea, Lipgloss, Bubbles

• OpenTelemetry - OTLP specification

• k9s - TUI inspiration

• Community contributors and users

Archive

For historical versions before 0.1.0, see the Git history.

---

Changelog Format

This changelog follows these conventions:

• Added: New features

• Changed: Changes to existing functionality

• Deprecated: Soon-to-be removed features

• Removed: Removed features

• Fixed: Bug fixes

• Security: Security fixes

Version Format: MAJOR.MINOR.PATCH

• MAJOR: Breaking changes

• MINOR: New features (backward compatible)

• PATCH: Bug fixes (backward compatible)

---

Stay Updated: Watch the GitHub repository to be notified of new releases.

Latest Version: Check Releases for the most recent version and download links.