Debugging

Debugging

Check if the Kubermatic Kubernetes Platform (KKP) Components Are Running

1. Check on the KKP-pods by issuing a kubectl get pod -n kubermatic
2. If any of them is not running, 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

1. Find the cluster-id by selecting going to the details view of your cluster in the UI. The URL looks something like this, the cluster id is the last part: https://kubermatic/projects/project-id/dc/dc-name/clusters/cluster-id
2. Get the kubeconfig for your seed cluster
3. Check if there are any errors in the events for the cluster in question by issuing a kubectl describe cluster cluster-id
4. Check if all pods for the cluster are running by executing kubectl get pods -n cluster-$CLUSTER_ID
5. If that is not the case, check the log of the pod in question by issuing a kubectl logs -n cluster-$CLUSTER_ID $PODNAME
6. 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 .spec.pause to true
7. 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. -v=4

Check for Problems With Machines for an Individual User Cluster

1. Get the kubeconfig to your cluster via the UI
2. Configure kubectl to use it by running export KUBECONFIG=$DOWNLOADED_KUBECONFIG_FILE
3. Get the machines via kubectl get machine -n kube-system
4. Check the events for the machines by running kubectl describe machine -n kube-system $MACHINE_NAME