Getting Started with Kuberneat
Follow this guide to set up Prometheus, Grafana, and Kuberneat for visualizing your Kubernetes clusters.
Installation Steps
1. Prerequisites
Before you begin, ensure you have the following components installed and configured.
- •Kubernetes cluster (local or remote) with kubectl configured
- •Helm 3.x installed (installation guide)
- •Admin access to your Kubernetes cluster
You'll need administrative permissions on your Kubernetes cluster to install monitoring components.
🔧 Troubleshooting
Prometheus Connection Issues
If Kuberneat cannot connect to Prometheus, verify:
- •Prometheus is running:
kubectl get pods -n monitoring | grep prometheus - •Port forwarding is active and hasn't timed out
- •Correct Prometheus URL is configured in Kuberneat (default:
http://localhost:9090)
Check Prometheus API accessibility:
Should return a JSON response with Prometheus version information.
Visualization Not Rendering
If the D3 visualization doesn't appear:
- •Check browser console for JavaScript errors
- •Verify metrics are being collected:
curl http://localhost:9090/api/v1/query?query=up - •Ensure your browser supports the D3.js visualization library
Missing Metrics or Incomplete Data
If visualizations appear but show incomplete data:
- •Verify all Prometheus exporters are running:
kubectl get pods -n monitoring - •Check for scrape errors in Prometheus (Status → Targets in Prometheus UI)
- •Wait a few minutes for metrics collection to catch up with newly deployed services
For detailed debugging, check the Kuberneat application logs by running npm run dev in a terminal and watching the console output.
Start Visualizing Your Kubernetes Clusters
Once Kuberneat is running, you'll be able to see your entire Kubernetes environment in a beautiful, interactive graph with real-time metrics from Prometheus.