Skip to main content
Version: 2.0.2

📊 Monitoring & Observability

Cluster Metrics​

# General Hikube cluster status
kubectl get kubernetes <cluster-name> -o yaml

# Kubernetes cluster nodes
kubectl --kubeconfig=cluster-admin.yaml get nodes

# Resource metrics
kubectl --kubeconfig=cluster-admin.yaml top nodes
kubectl --kubeconfig=cluster-admin.yaml top pods

Logs & Debugging​

# Cluster events
kubectl describe kubernetes <cluster-name>

# Component logs
kubectl logs -n kamaji -l app.kubernetes.io/instance=<cluster-name>

# Detailed machine status
kubectl get machines -l cluster.x-k8s.io/cluster-name=<cluster-name>

🛠️ Lifecycle Management

Upgrade​

# Cluster upgrade
kubectl patch kubernetes <cluster-name> --type='merge' -p='
spec:
  version: "v1.29.0"  # New Kubernetes version
'

Scaling​

# Scale a node group
kubectl patch kubernetes <cluster-name> --type='merge' -p='
spec:
  nodeGroups:
    compute:
      maxReplicas: 20  # Increase limit
'

Deletion​

# WARNING: Irreversible cluster deletion
kubectl delete kubernetes <cluster-name>

🚨 Troubleshooting

Common Issues​

# Cluster stuck during creation
kubectl describe kubernetes <cluster-name>
kubectl get events --field-selector involvedObject.name=<cluster-name>

# Nodes not ready
kubectl --kubeconfig=cluster-admin.yaml describe nodes
kubectl get machines -l cluster.x-k8s.io/cluster-name=<cluster-name>

# Add-ons failing
kubectl --kubeconfig=cluster-admin.yaml get pods -A
kubectl --kubeconfig=cluster-admin.yaml describe helmreleases -A

Detailed Logs​

# Cluster API logs
kubectl logs -n capi-system -l control-plane=controller-manager

# Kamaji logs (control plane)
kubectl logs -n kamaji-system -l app.kubernetes.io/name=kamaji

# KubeVirt logs (workers)
kubectl logs -n kubevirt -l kubevirt.io=virt-controller