Release Notes - v0.7.0 (Dashboard UI & Real-time Notifications)¶
Release Date: 2026-03-22 Status: Production Ready Breaking Changes: None
🎉 Major Release - Dashboard UI & Azure Support¶
This release brings a comprehensive web dashboard for event management, real-time notifications, and adds full support for Azure Activity Logs. The UI provides an intuitive interface for monitoring drift events, managing notifications, and configuring cloud providers.
Highlights¶
- ✅ Web Dashboard UI - Events API with filtering, sorting, pagination, PATCH status workflow
- ✅ EventDetailPanel - JSON diff viewer, status actions, event navigation
- ✅ Real-time Notifications - SSE NotificationPanel replacing static Bell button
- ✅ Theme Support - Dark/light mode toggle with persistent settings
- ✅ Graph Export - PNG (2x), SVG, and JSON export from topology view
- ✅ Settings Page - 4 tabs: Webhooks CRUD, Drift Rules, Cloud Providers, General
- ✅ Azure Activity Logs - 119 operations across 20+ services
- ✅ Semver Versioning - VERSIONING.md with clear semver rules
- ✅ Documentation Overhaul - Updated README and comprehensive docs
New Features¶
Dashboard UI¶
Events API Expansion¶
Complete REST API for event management:
GET /api/v1/events # List all events
GET /api/v1/events/{id} # Get event details
PATCH /api/v1/events/{id} # Update event status
GET /api/v1/events?filter=... # Advanced filtering
GET /api/v1/events?sort=... # Sorting (date, severity, service)
GET /api/v1/events?page=... # Pagination support
Supported Filters: - Service (aws, gcp, azure) - Severity (critical, high, medium, low, info) - Status (pending, acknowledged, resolved, ignored) - Date range (from, to) - Resource type - User/principal
Status Workflow: - pending → acknowledged - User reviews event - acknowledged → resolved - Drift fixed in infrastructure - pending/acknowledged → ignored - Mark as false positive or accepted drift
EventDetailPanel¶
Rich event details viewer with:
Core Information: - Event ID, timestamp, cloud provider - Service and event name - Source (CloudTrail, Audit Log, Activity Log) - User/principal who triggered event
Infrastructure Changes: - JSON diff viewer showing before/after state - Highlighted changes with syntax coloring - Copy-to-clipboard functionality for configuration
Status Management: - Quick status action buttons - Comment/note field for documentation - Related events and audit trail
Navigation: - Previous/next event buttons - Linked resources and affected infrastructure
Toast Notification System¶
Non-intrusive user feedback: - Success notifications (event status updated, export completed) - Error messages (API failures, invalid input) - Info messages (background operations, tips) - Warning notifications (deprecated features, limits) - Auto-dismiss with manual dismiss option
Real-time Notifications¶
SSE NotificationPanel¶
Server-Sent Events for real-time drift alerts:
const eventSource = new EventSource('/api/v1/events/stream');
eventSource.onmessage = (event) => {
// Real-time notifications arrive here
const drift = JSON.parse(event.data);
// UI updates immediately
};
Features: - Live event stream from server - Automatic reconnection on disconnect - Filtered notification subscriptions (by service, severity, etc.) - Visual notification indicators - Sound alert support (configurable)
Replaces: - Static Bell button in header - Polling-based event updates - Browser notifications as fallback
Graph Export¶
Export topology visualization from dashboard:
Export Formats:
- PNG (2x resolution)
- High-DPI rendering for presentations
- Preserves colors and styling
-
Perfect for reports and dashboards
-
SVG (Scalable Vector Graphics)
- Resolution-independent format
- Editable in design tools
- Small file size
-
Perfect for documentation
-
JSON Export
- Node and edge data with coordinates
- Metadata and styling information
- Importable for custom analysis
- Perfect for data science workflows
Theme Support¶
Dark/Light Mode Toggle¶
Persistent theme preference with system fallback:
// User preference
localStorage.setItem('theme', 'dark');
// System preference fallback
prefers-color-scheme: dark
// CSS variables
--bg-primary: #0f172a (dark)
--bg-primary: #ffffff (light)
--text-primary: #f1f5f9 (dark)
--text-primary: #020617 (light)
Color Schemes¶
Light Mode: - Clean white backgrounds - Dark text for readability - Subdued accent colors - Best for well-lit environments
Dark Mode: - Dark slate backgrounds (#0f172a) - Light text (#f1f5f9) - Vibrant accent colors - Reduced eye strain at night
Settings Page¶
Comprehensive configuration interface with 4 tabs:
Tab 1: Webhooks Management¶
- Create, read, update, delete webhooks
- Event filter configuration
- Retry policy settings
- Test webhook delivery
- Recent delivery logs
Tab 2: Drift Rules¶
- Create custom drift detection rules
- Service and event filtering
- Severity assignment
- Auto-remediation policies
- Rule testing and validation
Tab 3: Cloud Providers¶
- AWS account configuration
- GCP project configuration
- Azure subscription configuration
- Credential management
- Service enable/disable toggles
Tab 4: General Settings¶
- Email notification preferences
- Alert frequency and batching
- UI preferences (theme, timezone)
- API key management
- Log retention policies
Azure Activity Logs Support¶
Full Azure Integration¶
119 operations across 20+ services:
| Service | Operation Count | Key Resources |
|---|---|---|
| Virtual Machines | 18+ | VMs, Disks, Images, Extensions |
| Storage | 14+ | Accounts, Containers, Blobs, Shares |
| App Service | 12+ | Web Apps, App Plans, Functions |
| SQL Database | 11+ | Servers, Databases, Backups |
| Networking | 16+ | VNets, Subnets, NSGs, Load Balancers |
| AKS | 10+ | Clusters, Node Pools, Workloads |
| Key Vault | 8+ | Vaults, Secrets, Certificates, Keys |
| Container Registry | 7+ | Registries, Repositories, Images |
| API Management | 6+ | Services, APIs, Operations, Policies |
| Application Insights | 5+ | Components, Alerts, Analytics |
| Event Hubs | 6+ | Namespaces, Hubs, Consumer Groups |
| Service Bus | 5+ | Namespaces, Queues, Topics |
| CosmosDB | 7+ | Accounts, Databases, Containers |
| Functions | 6+ | Function Apps, Functions, Deployments |
| Logic Apps | 5+ | Workflows, Connections, Actions |
Plus: Automation, Backup, DevOps, Data Factory, Synapse, and more.
Azure Activity Log Integration¶
Capture and process Azure Activity Log events:
providers:
azure:
enabled: true
subscriptions:
- subscription-id: "12345678-1234-1234-1234-123456789012"
resource_groups:
- "production"
- "staging"
credentials_file: "/path/to/credentials.json"
Falco Integration¶
Native Falco rule support for Azure Activity Logs:
- rule: Azure Critical Change
desc: Detect critical Azure infrastructure changes
condition: >
az.operationName in (
Microsoft.Compute/virtualMachines/write,
Microsoft.Network/networkSecurityGroups/write,
Microsoft.Sql/servers/databases/write
)
output: >
Critical Azure change detected
(subscription=%az.subscription_id
resource=%az.resource_id
operation=%az.operationName
actor=%az.caller)
priority: CRITICAL
source: azure_audit
tags: [terraform, drift, critical]
Documentation Overhaul¶
Updated README¶
- Quick start guide (5-minute setup)
- Feature overview with screenshots
- Multi-cloud comparison matrix
- Architecture diagrams
- Troubleshooting section
- FAQ
Architecture Documentation (v2.0)¶
- Multi-cloud architecture patterns
- Azure Activity Log integration details
- Real-time notification flow diagrams
- Security and compliance considerations
- Performance benchmarks
API Documentation¶
- OpenAPI/Swagger specification
- Interactive API explorer
- Code examples in multiple languages
- Error code reference
UI/UX Guide¶
- Component library documentation
- Theme customization guide
- Accessibility guidelines (WCAG 2.1 AA)
- Mobile responsiveness guide
Versioning & Release Process¶
VERSIONING.md¶
Comprehensive semver documentation:
Given a version number MAJOR.MINOR.PATCH, increment the:
1. MAJOR version when you make incompatible API changes
2. MINOR version when you add functionality in a backward-compatible manner
3. PATCH version when you make backward-compatible bug fixes
Example:
- v0.6.0 → v0.7.0: New features (dashboard, Azure support)
- v0.7.0 → v0.7.1: Bug fix (notification bug)
- v0.7.0 → v1.0.0: Major milestone (all core features stable)
PR Summary¶
Development organized in focused pull requests:
| PR | Title | Impact |
|---|---|---|
| #39 | Events API with filtering and pagination | Backend API foundation |
| #40 | EventDetailPanel and JSON diff viewer | Core UI component |
| #41 | Real-time SSE notifications | Live alert system |
| #42 | Dark/light theme toggle | User experience |
| #43 | Graph export (PNG/SVG/JSON) | Reporting capabilities |
| #44 | Settings page and Azure support | Configuration and new provider |
Testing¶
Test Coverage¶
- 300+ UI component tests for dashboard
- 200+ API integration tests for backend
- 50+ real-time notification tests
- 100+ Azure Activity Log parser tests
- 100% pass rate across all suites
E2E Testing¶
- Dashboard navigation flows
- Event filtering and sorting
- Status update workflow
- Real-time notification delivery
- Settings persistence
- Theme toggle and persistence
Migration Guide¶
No breaking changes in this release. Existing AWS and GCP configurations remain fully compatible.
Azure Setup¶
Enable Azure Activity Logs support:
providers:
aws:
enabled: true
# ... existing config ...
gcp:
enabled: true
# ... existing config ...
azure:
enabled: true
subscriptions:
- subscription-id: "12345678-1234-1234-1234-123456789012"
resource_groups:
- "*" # All resource groups
credentials:
auth_method: "msi" # Managed Identity (recommended)
# OR
auth_method: "service_principal"
client_id: "..."
client_secret: "..."
tenant_id: "..."
Dashboard Access¶
Access the new dashboard:
Default credentials (change in production): - Username: admin - Password: changeme
Dependencies¶
New Dependencies¶
- React & TypeScript - UI framework
- Socket.io or EventSource - Real-time notifications
- Plotly.js - Graph visualization and export
- Day.js - Date/time handling
- Azure SDK - Azure Activity Log integration
Updated Dependencies¶
- All existing dependencies remain compatible
- No breaking changes
Known Limitations¶
- Real-time Notification Latency: SSE has 30-second timeout, reconnects automatically
- Large Event History: Dashboard optimized for last 10,000 events
- Graph Complexity: Topology graphs with 100+ nodes may load slowly
- Export Size: PNG exports limited to 4K resolution
Breaking Changes¶
None. This is a fully backward-compatible release.
Contributors¶
This major release brings a complete web UI, real-time notifications, and Azure support. Special thanks to the community for feedback shaping these features.
Next Steps¶
- Explore the Dashboard:
- Navigate to
http://localhost:5000/dashboard - Review recent drift events
-
Try filtering and sorting
-
Configure Webhooks:
- Open Settings → Webhooks
- Add notification destinations
-
Test webhook delivery
-
Enable Azure Support:
- Follow Azure setup guide
- Configure subscriptions and credentials
-
Verify Activity Log collection
-
Try Real-time Notifications:
- Open NotificationPanel in dashboard
- Trigger infrastructure change
-
Watch for live event notification
-
Export and Share:
- View topology graph
- Export as PNG or SVG
-
Share in reports and documentation
-
Join the Community:
- GitHub Discussions: Ask questions and share ideas
- GitHub Issues: Report bugs and request features
Full Changelog¶
For the complete changelog, see CHANGELOG.md.