Web Dashboard
The KubeGraf web dashboard provides a modern, browser-based interface for visualizing and managing
your Kubernetes clusters with real-time updates.
Starting the Dashboard
# Start on default port (3000)
kubegraf --web
# Start on custom port
kubegraf web --port 4000
# Auto-open browser
kubegraf web --open
# Bind to all interfaces (for remote access)
kubegraf web --host 0.0.0.0 --port 8080
Note: By default, the dashboard binds to localhost only. Use --host 0.0.0.0 to allow remote connections.
Dashboard Preview
Dashboard Features
Real-time Updates
WebSocket-powered live updates. See resource changes instantly without refreshing.
Resource Browser
Browse all Kubernetes resources with filtering, sorting, and search capabilities.
Visual Resource Map
Interactive graph visualization showing relationships between resources.
Log Streaming
Stream container logs in real-time with search and filtering.
Navigation
Sidebar Navigation
The left sidebar provides quick access to resource categories:
- Workloads - Pods, Deployments, StatefulSets, DaemonSets, Jobs
- Networking - Services, Ingresses, Endpoints
- Config - ConfigMaps, Secrets
- Storage - PersistentVolumes, PersistentVolumeClaims
- Cluster - Nodes, Namespaces, Events
- Resource Map - Visual relationship graph
- Security - Security analysis dashboard
Top Bar Controls
Quick access controls in the header:
- Context Switcher - Switch between Kubernetes contexts
- Namespace Selector - Filter by namespace or view all
- Search - Global search across all resources
- Theme Toggle - Switch between dark and light themes
Resource Views
List View
The default view shows resources in a sortable table:
- Name, Namespace, Status
- Age (with relative time)
- Resource-specific columns (e.g., Ready count for Pods)
- Quick action buttons
Detail View
Click any resource to open its detail panel:
- Overview - Key metadata and status
- YAML - Full resource definition with syntax highlighting
- Events - Related Kubernetes events
- Logs - Container logs (for Pods)
- Related - Links to related resources
Common Actions
Available actions depend on the resource type:
Pod Actions
- View Logs - Stream logs from any container
- Exec Shell - Open a terminal session (opens in new tab)
- Port Forward - Create a port forwarding tunnel
- Delete - Delete the pod (with confirmation)
Deployment Actions
- Scale - Adjust replica count
- Restart - Trigger a rolling restart
- Edit - Modify the deployment YAML
- View Pods - Show pods managed by this deployment
Advanced Features
Enhanced Log Viewer
The web log viewer provides enhanced capabilities:
- Multi-container - View logs from multiple containers simultaneously
- Search - Full-text search within logs
- Filter - Filter by log level (if structured logging is used)
- Download - Export logs to a file
- Timestamps - Toggle timestamp display
- Auto-scroll - Follow new log entries in real-time
Interactive Resource Map
Visual graph showing resource relationships:
- Pan & Zoom - Navigate large graphs easily
- Click to Select - Click nodes to view resource details
- Hover Info - See quick info on hover
- Layout Options - Force-directed, hierarchical, or circular
- Filters - Show/hide specific resource types
Keyboard Shortcuts
The web dashboard supports keyboard navigation:
- / or Ctrl+K - Focus search
- Esc - Close dialogs/panels
- ? - Show keyboard shortcuts
- r - Refresh current view
- n - Change namespace
Security Considerations
When exposing the dashboard:
- The dashboard uses your local kubeconfig credentials
- Do not expose to the public internet without authentication
- Consider using a reverse proxy (nginx, Traefik) with authentication
- Use TLS when accessing over a network
# Example: Run behind nginx with basic auth
# See Configuration for full reverse proxy setup