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 (8080)
kubegraf --web

# Start on custom port
kubegraf web --port 3000

# 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 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

The left sidebar provides quick access to:

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

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 with columns for:

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 showing:

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

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

Log Viewer

The web log viewer provides enhanced log viewing 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

Resource Map (Visual)

The web dashboard includes an interactive resource map:

Pan & Zoom - Navigate large graphs easily
Click to Select - Click nodes to view resource details
Hover Info - See quick info on hover
Layout Options - Choose between force-directed, hierarchical, or circular layouts
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