Ctrlk
ControlTheory Website
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Community

Welcome to the Gonzo community! This page helps you connect with other users, contribute to the project, and get support.

Getting Involved

For Users

Share Your Experience:

  • ⭐ Star the project on GitHub

  • 📝 Write blog posts about using Gonzo

  • 🐦 Share tips and tricks on social media

  • 💬 Help answer questions in discussions

  • 📸 Share screenshots of your setups

Provide Feedback:

  • 🐛 Report bugs you encounter

  • 💡 Suggest new features

  • 📊 Share use cases we haven't considered

  • 🎨 Propose UI improvements

For Developers

Contribute Code:

  • 🔧 Fix bugs

  • ✨ Implement new features

  • 🧪 Add tests

  • 📚 Improve documentation

  • 🎨 Create custom skins

  • 📋 Create custom format parsers

Help Others:

  • 🤝 Review pull requests

  • 👥 Mentor new contributors

  • 💬 Answer technical questions

  • 📖 Improve documentation clarity

Blog & Content

ControlTheory Blog: Regular posts about Gonzo, log analysis, and SRE practices

Communication Channels

GitHub

Primary Platform: https://github.com/control-theory/gonzo

Issues: Report bugs and request features

  • Bug reports: Use the bug template

  • Feature requests: Use the enhancement template

  • Questions: Use the question label

  • Good first issues: Look for "good first issue" label

Discussions: General conversations

  • Q&A: Ask and answer questions

  • Ideas: Brainstorm new features

  • Show and tell: Share what you've built

  • General: Anything Gonzo-related

Pull Requests: Contribute code

  • Fork, branch, commit, push

  • Follow contribution guidelines

  • Wait for review and feedback

  • Iterate based on comments

ControlTheory Website

Blog: https://www.controltheory.com/blog/

  • Product announcements

  • Technical deep dives

  • Use case studies

  • Best practices

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

  • Comprehensive guides

  • API documentation

  • Examples and tutorials

  • Troubleshooting tips

Social Media

Twitter/X: Follow @ControlTheoryHQ

  • Product updates

  • Quick tips

  • Community highlights

LinkedIn: ControlTheory Company Page

  • Professional updates

  • Case studies

  • Job postings

Recognition

Contributors

We recognize and celebrate all contributors:

Hall of Fame:

  • Listed in GitHub contributors

  • Mentioned in release notes

  • Featured in project README

  • Community spotlight posts

Special Recognition:

  • 🥇 Top Contributors: Most impactful contributions

  • 🏆 Bug Hunters: Found and reported critical bugs

  • 📚 Documentation Heroes: Significantly improved docs

  • 🎨 Design Contributors: Created popular skins/themes

  • 🔧 Tool Builders: Created useful extensions

Star History

See our growth: Star History Chart

Help us reach more users by starring the project!

Resources

Learning Resources

Getting Started:

  • Quick Start Guide

  • Installation

  • Basic Usage

Advanced Topics:

  • AI Integration

  • OTLP Protocol

  • Custom Formats

For Contributors:

  • Development Setup

  • Contribution Guidelines

  • Architecture Overview

Example Configurations

Community Configs:

  • Check examples/ directory in repository

  • Browse community-shared configurations

  • Submit your own configs via PR

Custom Formats:

  • Apache/Nginx parsers

  • Application-specific formats

  • Cloud service integrations

Custom Skins:

  • Color scheme variations

  • Brand-specific themes

  • Accessibility-focused themes

Community Projects

Integrations

Log Shippers:

  • Fluent Bit configurations

  • Logstash pipelines

  • Vector configs

Monitoring Systems:

  • Prometheus integration

  • Grafana dashboards

  • Alertmanager rules

CI/CD:

  • GitHub Actions workflows

  • GitLab CI pipelines

  • Jenkins integrations

Tools & Extensions

Community Tools:

  • Log generators for testing

  • Format converters

  • Analysis scripts

  • Automation tools

Complementary Projects:

  • Log aggregation tools

  • Parsing libraries

  • Visualization tools

Submit your projects to be featured here!

Events & Activities

Hackathons

Participate in Gonzo-focused hackathons:

  • Build new features

  • Create integrations

  • Design themes

  • Write documentation

Past Hackathons:

  • Check GitHub discussions for recaps

  • See winning projects

  • Get inspired for future events

Community Calls

Monthly Community Calls (when scheduled):

  • Product roadmap discussions

  • Feature demonstrations

  • Q&A with maintainers

  • Community presentations

Watch for announcements in GitHub Discussions.

Meetups

Virtual Meetups:

  • User presentations

  • Live demos

  • Technical discussions

  • Networking

Local Meetups:

  • Connect with local users

  • In-person demos

  • Collaborative sessions

Interested in organizing? Reach out to maintainers!

Support

Getting Help

Documentation First:

Ask the Community:

  • Post in GitHub Discussions (Q&A)

  • Open an issue with "question" label

  • Share details about your setup

Commercial Support:

  • Email: support@controltheory.com

  • Enterprise support plans available

  • Custom feature development

Reporting Security Issues

⚠️ Do not open public issues for security vulnerabilities

Instead:

  • Email: security@controltheory.com

  • Provide detailed description

  • Include steps to reproduce

  • Suggest potential fixes if possible

We aim to respond within 48 hours.

Code of Conduct

Our Pledge

We pledge to make participation in our community a harassment-free experience for everyone, regardless of:

  • Age, body size, disability

  • Ethnicity, gender identity and expression

  • Experience level

  • Nationality, personal appearance

  • Race, religion

  • Sexual identity and orientation

Our Standards

Positive Behavior:

  • ✅ Using welcoming and inclusive language

  • ✅ Being respectful of differing viewpoints

  • ✅ Gracefully accepting constructive criticism

  • ✅ Focusing on what is best for the community

  • ✅ Showing empathy towards others

Unacceptable Behavior:

  • ❌ Trolling, insulting, or derogatory comments

  • ❌ Personal or political attacks

  • ❌ Public or private harassment

  • ❌ Publishing others' private information

  • ❌ Other conduct inappropriate in professional settings

Enforcement

Violations may result in:

  • Warning

  • Temporary ban

  • Permanent ban

Report issues to: conduct@controltheory.com

Roadmap

Current Focus

Short-term (Next 3 months):

  • Performance improvements

  • Bug fixes and stability

  • Documentation enhancements

  • Community feedback implementation

Medium-term (3-6 months):

  • New AI providers

  • Enhanced OTLP features

  • Additional integrations

  • Plugin system

Long-term (6+ months):

  • Distributed log analysis

  • Advanced visualizations

  • Cloud-native deployments

  • Enterprise features

See GitHub Projects for detailed roadmap.

Influence the Roadmap

Your input matters:

  • 👍 Upvote issues you care about

  • 💬 Comment on proposals

  • 📝 Submit feature requests

  • 🗳️ Participate in polls

Popular requests get prioritized!

Credits

Built With

Gonzo is built with these amazing open-source projects:

Inspiration

Inspired by:

  • k9s - Kubernetes TUI

  • stern - Multi-pod log tailing

  • lnav - Log file navigator

Team

Maintainers:

  • Core maintainers listed in GitHub

  • ControlTheory team

Contributors:

  • See Contributors

  • Everyone who reported bugs

  • Everyone who suggested features

  • Everyone who improved docs

Sponsors

Support Gonzo's development:

  • GitHub Sponsors (coming soon)

  • Open Collective (coming soon)

  • Corporate sponsorship inquiries: partnerships@controltheory.com

Stay Connected

Newsletter

Subscribe to our newsletter:

  • Product updates

  • Tips and tricks

  • Community highlights

  • Event announcements

Sign up at: https://www.controltheory.com/newsletter

Blog

Read the latest:

  • Gonzo Blog

  • Technical articles

  • Use cases

  • Best practices

Social Media

Follow us:

Contact

General Inquiries: hello@controltheory.com Support: support@controltheory.com Security: security@controltheory.com Press: press@controltheory.com Partnerships: partnerships@controltheory.com

Thank You! 🎉

Thank you for being part of the Gonzo community. Whether you're using it, contributing to it, or just checking it out - we appreciate you!

Together, we're making log analysis better for everyone.

Want to get involved? Start by starring the GitHub repo, join the discussions, and say hello!

PreviousContribution Guidelines
NextHow to Get Help

Last updated