Skip to content

Releases: telemorph-prime/open-telemorph-prime

Release Notes v0.2.1

16 Oct 13:09
@nadx nadx
v0.2.1
fa8704f

Choose a tag to compare

View all tags
Release Notes v0.2.1 Pre-release
Pre-release

Release Date: October 14, 2025
Release Type: Pre-release
Status: Ready for Testing

🚀 What's New

OTLP Ingestion Improvements

  • Fixed OTLP Port Configuration: Now uses standard OpenTelemetry Collector ports
    • Port 4317: OTLP gRPC endpoint for traces, metrics, and logs
    • Port 4318: OTLP HTTP endpoint for traces, metrics, and logs
    • Port 8080: Web UI and REST API (unchanged)
  • Separate HTTP/gRPC Servers: Implemented dedicated servers for each OTLP protocol
  • Configurable Endpoints: Added enable/disable checkboxes for each OTLP port in admin panel

User Interface Enhancements

  • Dynamic Version Display: Version now updates automatically across all pages
  • Client-Side Filtering: Implemented filtering for traces, logs, and metrics pages
  • Dynamic Service Loading: Service dropdowns now populate from actual API data
  • Consistent Page Layout: Standardized metrics page to match traces and logs format
  • Fixed HTML Structure: Resolved table rendering issues in data display pages

Admin Panel Updates

  • Separate Endpoint Configuration:
    • HTTP Endpoint: 0.0.0.0:4318 (configurable)
    • gRPC Endpoint: 0.0.0.0:4317 (configurable)
  • Enable/Disable Controls: Individual checkboxes for each OTLP port
  • Real-time Configuration: Changes take effect immediately

Docker & Deployment

  • Optimized Dockerfile: Reduced build context with .dockerignore
  • Improved Health Checks: Added wget dependency for reliable health monitoring
  • Security Enhancements: Config file mounted as read-only
  • Better Documentation: Updated port mappings and usage examples

Documentation & Organization

  • Organized Documentation: Moved all markdown files to docs/ folder
  • Updated README: Corrected port information and usage examples
  • Test Scripts: Added comprehensive OTLP endpoint testing tools
  • Clean Project Structure: Removed temporary files and build artifacts

🐛 Bug Fixes

  • UI Data Display: Fixed traces and logs not appearing in web interface
  • JavaScript Execution: Resolved timing issues with data loading
  • HTML Structure: Fixed invalid table markup causing display errors
  • Port Listening: Ensured both OTLP ports (4317/4318) are properly listening
  • Filter Functionality: Fixed "Apply Filters" button not working on data pages

🔧 Technical Improvements

  • Backend Architecture: Separated OTLP ingestion from main web server
  • Template System: Added dynamic version passing to all HTML templates
  • API Consistency: Standardized response formats across all endpoints
  • Error Handling: Improved error messages and debugging information
  • Code Organization: Better separation of concerns between services

📋 Testing

New Test Scripts

  • test_otel_simple.sh: Simple HTTP endpoint testing
  • test_otel.sh: Comprehensive OTLP endpoint validation

Test Coverage

  • ✅ OTLP HTTP endpoint (port 4318)
  • ✅ OTLP gRPC endpoint (port 4317)
  • ✅ Web UI functionality
  • ✅ Admin panel configuration
  • ✅ Data filtering and display
  • ✅ Docker containerization

🚨 Breaking Changes

  • Port Changes: OTLP ingestion moved from port 8080 to dedicated ports 4317/4318
  • Configuration: New grpc_enabled and http_enabled flags in config.yaml
  • File Structure: Documentation moved to docs/ folder

📦 Installation & Upgrade

New Installation

# Clone and build
git clone <repository-url>
cd open-telemorph-prime
go build -o open-telemorph-prime .

# Run with default configuration
./open-telemorph-prime

Docker Deployment

# Build and run with docker-compose
docker-compose up -d

# Or build directly
docker build -t open-telemorph-prime .

Configuration Update

If upgrading from v0.2.0, update your config.yaml:

ingestion:
  grpc_port: 4317
  http_port: 4318
  grpc_enabled: true    # New
  http_enabled: true    # New

🔗 Endpoints

OTLP Ingestion

  • HTTP: http://localhost:4318/v1/{traces,metrics,logs}
  • gRPC: localhost:4317 (traces, metrics, logs)

Web Interface

  • Main UI: http://localhost:8080
  • API: http://localhost:8080/api/v1/{metrics,traces,logs,services}

🎯 Next Steps

  • Full OTLP gRPC Implementation: Complete protobuf service registration
  • Server-Side Filtering: Implement backend filtering for better performance
  • Time Range Filtering: Add date/time range selection for logs
  • Export Functionality: Implement data export features
  • Performance Optimization: Add caching and query optimization

📞 Support

For issues, questions, or contributions:

  • Issues: GitHub Issues
  • Documentation: docs/ folder
  • Testing: Use provided test scripts

Note: This is a pre-release version. Please test thoroughly before using in production environments.

Loading

Release Instructions for v0.2.0

12 Oct 14:21
@nadx nadx
v0.2.0
337c462

Choose a tag to compare

View all tags
Release Instructions for v0.2.0 Pre-release
Pre-release

Git Repository Updates

  • ✅ All code changes committed to main branch
  • ✅ Git tag v0.2.0 created and pushed
  • ✅ Release notes file created: RELEASE_NOTES_v0.2.0.md
  • ✅ All changes pushed to GitHub repository

Release Summary

  • Tag: v0.2.0
  • Branch: main
  • Commit: 337c462 (latest)
  • Files Changed: 13 files modified, 1 new file added

🚀 Creating the GitHub Release

Option 1: Using GitHub Web Interface

  1. Navigate to the Repository

  2. Create a New Release

    • Click on "Releases" in the right sidebar
    • Click "Create a new release"

  3. Fill in Release Details

    • Tag version: v0.2.0 (should auto-populate)
    • Release title: Open-Telemorph-Prime v0.2.0 - Complete UI Overhaul
    • Description: Copy the content from RELEASE_NOTES_v0.2.0.md

  4. Release Options

    • ✅ Check "Set as the latest release"
    • ✅ Check "Create a discussion for this release" (optional)

  5. Publish Release

    • Click "Publish release"

Option 2: Using GitHub CLI (if installed)

# Install GitHub CLI first (if not installed)
# brew install gh  # on macOS
# or download from: https://cli.github.com/

# Authenticate with GitHub
gh auth login

# Create the release
gh release create v0.2.0 \
  --title "Open-Telemorph-Prime v0.2.0 - Complete UI Overhaul" \
  --notes-file RELEASE_NOTES_v0.2.0.md \
  --latest

📋 Release Content Summary

Major Features Added

  • ✨ Complete web interface redesign
  • 🆕 Services Management page (/services)
  • 🆕 Alerts System page (/alerts)
  • 🆕 Query Builder page (/query)
  • 🆕 Administration Panel (/admin)
  • 🔄 Enhanced existing pages (Logs, Traces, Metrics)

Technical Improvements

  • 🛠 New admin API endpoints
  • 🎨 Professional UI with responsive design
  • 🌙 Dark/light theme support
  • 📱 Mobile navigation with collapsible sidebar
  • ⌨️ Keyboard shortcuts (Ctrl+K, Ctrl+D, Escape)
  • 🔍 Global search with debouncing
  • 🔔 Notification system

Files Modified

  • internal/web/service.go - Added new page handlers and admin APIs
  • main.go - Added new routes
  • web/admin.html - New admin page
  • web/alerts.html - New alerts page
  • web/query.html - New query builder page
  • web/services.html - New services page
  • web/logs.html - Redesigned logs page
  • web/traces.html - Redesigned traces page
  • web/static/styles.css - Enhanced styling
  • web/static/app.js - Enhanced functionality
  • UI_DESIGN_SPECIFICATION.md - New design documentation

🎯 Next Steps After Release

Immediate Actions

  1. Test the Release

    • Download and test the new version
    • Verify all pages work correctly
    • Test responsive design on mobile/tablet

  2. Update Documentation

    • Update README.md with new features
    • Add screenshots of the new UI
    • Update installation instructions

  3. Community Outreach

    • Share the release on social media
    • Post in relevant communities
    • Update project status pages

Future Releases

  • v0.2.1 - Bug fixes and minor improvements
  • v0.3.0 - Real-time data updates and advanced visualizations
  • v0.4.0 - User authentication and role-based access control

📊 Release Metrics

  • Lines of Code Added: ~2,000+ lines
  • New Files: 5 new HTML pages + 1 documentation file
  • API Endpoints Added: 3 new admin endpoints
  • UI Components: 20+ new components
  • Pages: 8 total pages (4 new, 4 enhanced)

🔗 Useful Links

📝 Release Notes Template

Use this as the release description:

# Open-Telemorph-Prime v0.2.0 - Complete UI Overhaul

## 🎉 Major Features

### ✨ Complete Web Interface Overhaul
- Professional UI design with modern aesthetics
- Consistent sidebar + main content layout
- Responsive design for all screen sizes
- Dark/light theme support with smooth transitions

### 🆕 New Pages & Features
- **Services Management** - Service health monitoring and management
- **Alerts System** - Alert management with filtering and resolution
- **Query Builder** - Advanced query interface for metrics, traces, and logs
- **Administration Panel** - Complete system configuration management

### 🔧 Enhanced Existing Pages
- **Logs Viewer** - Redesigned with advanced filtering
- **Traces Explorer** - Unified layout with enhanced features
- **Metrics Explorer** - Consistent design with improved visualization

## 🛠 Technical Improvements
- New admin API endpoints for configuration management
- Component system with reusable UI components
- Mobile navigation with collapsible sidebar
- Global search with keyboard shortcuts
- Notification system with badge updates
- Smooth animations and transitions

## 📱 Responsive Design
- Mobile-first design approach
- Touch-friendly interface
- Optimized layouts for tablet and desktop
- Collapsible sidebar navigation

## 🎨 Design System
- Professional color palette (light/dark themes)
- Consistent typography and spacing
- Reusable components (cards, buttons, badges, forms)
- Status indicators and visual feedback

## 🚀 Getting Started
1. Download the latest release
2. Run `./open-telemorph-prime`
3. Open `http://localhost:8080` in your browser
4. Explore the new interface!

## 📚 Documentation
- Complete UI Design Specification included
- Component documentation
- API reference
- Configuration guide

---

**Full Changelog**: https://github.com/nadx/open-telemorph-prime/compare/v0.1.0...v0.2.0

✅ Verification Checklist

Before publishing, verify:

  • All code is committed and pushed
  • Git tag v0.2.0 exists and is pushed
  • Release notes are complete and accurate
  • Application builds and runs successfully
  • All pages are accessible and functional
  • Responsive design works on mobile/tablet
  • Theme switching works correctly
  • Admin panel functions properly

Status: ✅ Ready for GitHub Release
Last Updated: October 12, 2025

Loading