Skip to content
GreenKube

Real-time Dashboard

GreenKube ships with a modern SvelteKit dashboard that provides a complete overview of your Kubernetes cluster’s energy consumption, carbon emissions, and cost metrics — all in real time.

Overview

Section titled “Overview”

The dashboard is served directly from the GreenKube container alongside the REST API, so there’s nothing extra to install. Once deployed, access it at http://<your-service>:8000.

Key Capabilities

Section titled “Key Capabilities”

Cluster Overview

Section titled “Cluster Overview”
  • Energy consumption (Watts) per node and per namespace
  • Carbon emissions (gCO₂e) with breakdown by workload
  • Cost estimates from OpenCost integration
  • Sustainability score — composite 0–100 rating across 7 dimensions
  • Recommendation summary with estimated savings

Per-Pod Metrics

Section titled “Per-Pod Metrics”

Drill down into individual pods to see:

  • CPU and memory utilization vs. requests/limits
  • Network I/O (bytes sent/received)
  • Disk I/O and storage usage
  • Pod restart count and uptime

Node Inventory

Section titled “Node Inventory”

A complete view of your cluster nodes including:

  • Hardware specs (CPU model, cores, RAM, TDP)
  • Cloud provider and region
  • Carbon zone mapping
  • Current power draw (estimated)

Report Builder

Section titled “Report Builder”

The /report page lets you:

  • Configure time range (1 h → 1 y), namespace filter, and aggregation (hourly/daily/weekly/monthly/yearly)
  • Preview totals (CO₂e, embodied CO₂e, energy, cost) before downloading
  • Export to CSV or JSON directly from the browser — no CLI or kubectl exec required

Service Health & Configuration

Section titled “Service Health & Configuration”
  • Settings page: Color-coded health cards for each data source (green=healthy, yellow=degraded, red=unreachable, gray=unconfigured) with latency and auto-discovery status
  • Startup health popup: On first load, a modal alerts you if any data source is unreachable and offers inline fields to configure missing URLs/tokens
  • Sidebar health indicators: Per-service health dots visible from any page
  • Runtime configuration: Override Prometheus URL, OpenCost URL, Electricity Maps token, and Boavizta URL directly from the browser

Interactive Charts

Section titled “Interactive Charts”
  • Time-series charts with configurable time ranges
  • Stacked area charts for namespace comparison
  • Trend analysis with daily/weekly/monthly grouping
  • Export chart data as CSV or JSON

Architecture

Section titled “Architecture”

The dashboard is a SvelteKit SPA (Single Page Application) that communicates with the GreenKube FastAPI backend:

Browser → SvelteKit SPA → FastAPI REST API → PostgreSQL/SQLite/ES

All static assets are bundled and served by the same container, ensuring zero additional infrastructure is required.

Screenshots

Section titled “Screenshots”

The dashboard automatically adapts to light and dark themes and is fully responsive for tablet and desktop use.

Getting Started

Section titled “Getting Started”

After installing GreenKube, access the dashboard:

Terminal window
kubectl port-forward svc/greenkube-api 8000:8000 -n greenkube

Then open http://localhost:8000 in your browser.

Section titled “Related”