How To
Summary
When you are using Kubernetes: Container Storage Interface (CSI) plugin to connect your Kubernetes container environment to IBM Storage, this document describes how to collect diagnostic data. This diagnostic data is required for IBM Support to diagnose and analyze your support case.
If you gather this documentation before contacting support, it will expedite the troubleshooting process and save time.
Environment
In case of an issue with the CSI driver, you (or PFE) should log into the Kubernetes primary node and run the commands from there
- Check the nodes status
$>kubectl get nodes - Check the status of CSI driver components
$>kubectl get -n kube-system pod -o wide | grep ibm-block-csi - Check if PVCs are bounded or not
$>kubectl get pvc
Steps
How to collect the CSI plugin logs:
- At the primary host, create directory for the logs (you can change the directory name if you wish):
$> mkdir logs - Collect csi-controller logs
$> kubectl logs -n kube-system ibm-block-csi-controller-0 --all-containers > logs/ibm-block-csi-controller - Collect csi-node logs
$> nodepods=`kubectl get -n kube-system pod -l app.kubernetes.io/component=csi-node --output=jsonpath={.items..metadata.name}` $> for pod in $nodepods; do kubectl logs -n kube-system --all-containers $pod > logs/$pod; done - Collect csi-operator logs
$> operatorpod=`kubectl get pods --all-namespaces |grep ibm-block-csi-operator|awk '{print $2}'` $> kubectl logs $operatorpod -n kube-system > logs/operator - Describe detail from all csi components
$> kubectl describe all -l csi -n kube-system > logs/describe_csi - If the PVC/s is not bounded, collect the PVC describe to see the events
$> kubectl describe pvc [PVC-NAME] > logs/pvc_not_bounded - if Application is not Running, collect the Application describe to see the events
$> kubectl describe pod [POD-NAME] > logs/pod_not_running - If the issue is related to IBM FlashSystem A9000, collect Xray, if the issue is related to IBM System Storage V7000, SVC or IBM FlashSystem FS9100, collect a SNAP.
Document Location
Worldwide
[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSJTBP","label":"IBM Cloud Kubernetes Service"},"Component":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF006","label":"CentOS"},{"code":"PF016","label":"Linux"},{"code":"PF043","label":"Red Hat"},{"code":"PF040","label":"RedHat OpenShift"},{"code":"PF048","label":"SUSE"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB21","label":"Public Cloud Platform"}}]
Was this topic helpful?
Document Information
Modified date:
12 March 2025
UID
ibm11142560