KROS Log Viewer
Enhanced Visual Studio Code extension for viewing and analyzing KROS application logs with advanced filtering and visualization capabilities.
✨ Features
- 🎯 Smart Log Parsing: Automatically parses KROS log format with timestamp, level, category, and message detection
- 🔍 Advanced Filtering: Filter logs by categories and severity levels with multi-select dropdowns
- 🎨 Color-coded Display: Different colors for log levels (Error, Warning, Info, Debug, Verbose)
- 📊 Multi-line Log Support: Properly groups continuation lines and stack traces
- ⚡ Performance Optimized: Efficiently handles large log files with virtual scrolling
- 🖱️ Context Menu Integration: Right-click on .log files to open in KROS Log Viewer
- 🔄 Real-time Updates: Refresh functionality to reload log files
- 📋 Visual Indicators: Clear distinction between main log entries and continuation lines
🚀 Installation
From Visual Studio Code Marketplace
- Open Visual Studio Code
- Go to Extensions (Ctrl+Shift+X)
- Search for "KROS Log Viewer"
- Click Install
From VSIX Package
- Download the
.vsix file
- Open VS Code
- Press
Ctrl+Shift+P and type "Extensions: Install from VSIX"
- Select the downloaded file
📖 Usage
Opening Log Files
- Context Menu: Right-click any
.log file in Explorer → "Show KROS Log"
- Command Palette:
Ctrl+Shift+P → "Show KROS Log"
Filtering Logs
- Categories: Select specific categories (MyDocuments, Partners, etc.) or "All Categories"
- Log Levels: Choose severity levels (ERR, WRN, INF, DBG, VRB) or "All Levels"
- Apply Filters: Click "Apply" to update the view
- Reset: Click "Reset" to clear all filters
- Refresh: Click "Refresh" to reload the log file
Visual Elements
- Color-coded borders: Left border indicates log level severity
- Category badges: Colored pills showing log categories
- Continuation lines: Subtle background for multi-line log entries
- Line numbers: Easy navigation and reference
The extension recognizes KROS log format:
2025-07-21 13:08:34.239 +00:00 [INF] [Partners] Log message here
2025-07-21 13:08:34.385 +00:00 [DBG] Debug message without category
2025-07-21 13:08:34.535 +00:00 [ERR] [MyDocuments] Error message
Stack trace continuation line
Another continuation line
Log Levels
ERR - Error (red)WRN - Warning (orange)INF - Information (blue)DBG - Debug (green)VRB - Verbose (purple)
Categories
Categories are specified in square brackets [CategoryName]. If no category is present, it displays as MAIN.
🛠️ Development
Prerequisites
- Node.js (v16 or higher)
- Visual Studio Code
- TypeScript
Building from Source
# Clone the repository
git clone https://github.com/Burgyn/MMLib.LogsReader.git
cd MMLib.LogsReader
# Install dependencies
npm install
# Compile TypeScript
npm run compile
# Package extension
npm install -g vsce
vsce package
Development Mode
- Clone the repository
- Open in VS Code
- Press
F5 to launch Extension Development Host
- Test your changes in the new VS Code window
📝 Configuration
No additional configuration required. The extension works out of the box with KROS log files.
🐛 Known Limitations
- Maximum 1000 log entries displayed at once for performance
- Large files may take a moment to parse initially
- Only supports KROS log format pattern
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature)
- Commit your changes (
git commit -m 'Add some AmazingFeature')
- Push to the branch (
git push origin feature/AmazingFeature)
- Open a Pull Request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
- Built for KROS application log analysis
- Inspired by developer needs for better log visualization
- Community feedback and suggestions
⚠️ AI Disclosure
This Visual Studio Code extension was developed with significant assistance from artificial intelligence (Claude AI). The AI helped with:
- Code architecture and implementation
- TypeScript and JavaScript development
- CSS styling and responsive design
- Regular expressions for log parsing
- Performance optimization strategies
- Documentation and README creation
While AI assisted in the development process, all code has been reviewed, tested, and customized for the specific needs of KROS log file analysis. The extension functionality, user experience design, and final implementation decisions were guided by human oversight and testing.
📞 Support
For support, bug reports, or feature requests:
Made with ❤️ for better log analysis
