Check if the Kubermatic Kubernetes Platform (KKP) Components are Running
- List the kubermatic pods to verify the status by executing the command
kubectl get pod -n kubermatic.
- If any of the listed pod is not running status, execute
kubectl logs -n kubermatic $PODNAME to find out the issue.
The individual components and their purpose are:
kubermatic-ui: Provides the UI.
kubermatic-api: Provides the API.
master-controller: Sets up access for users to projects and clusters.
controller-manager: Creates all the components required for a cluster control plane.
Check for Problems With an Individual User Cluster
- Find the cluster-id by navigating to the details view of your cluster in the UI. The URL looks something like this, the cluster id is the last part:
- Get the
kubeconfig of your seed cluster.
- Check if there are any errors in the events for your cluster by executing
kubectl describe cluster cluster-id.
- Check if all pods for the cluster are in running status by executing
kubectl get pods -n cluster-$CLUSTER_ID.
- Check the log of the pod that is not running status by executing
kubectl logs -n cluster-$CLUSTER_ID $PODNAME.
- If you want to play around with flags or other settings for a pod, you can make KKP stop managing the cluster by running
kubectl edit cluster $CLUSTER_ID and setting
- If you want more detailed logs from KKP, you can edit one of its deployments, e.G.
kubectl edit deployment kubermatic-controller-manager-v1 -n kubermatic, and set the verbosity by adjusting the default of
-v=2 to e.g.
Check for Problems With Machines for an Individual User Cluster
- Get the
kubeconfig of your cluster via the UI.
kubectl to use it by executing
- Get the machines by executing
kubectl get machine -n kube-system.
- Check the events for the machines by executing
kubectl describe machine -n kube-system $MACHINE_NAME.