故障排查

当应用 pod 无法正常启动或出现异常时，通常需要查看 JuiceFS CSI 驱动的日志来排查问题。不同版本的 CSI 驱动查看日志的方式不同，以下分别介绍。

查看 JuiceFS CSI 驱动的版本

首先需要查看当前 Kubernetes 集群安装的 JuiceFS CSI 驱动版本，可以通过以下命令获取：

kubectl -n kube-system get pod -l app=juicefs-csi-controller -o yaml | grep 'image: '

以上命令会有类似 image: juicedata/juicefs-csi-driver:v0.13.2 这样的输出，最后的 v0.13.2 即为 JuiceFS CSI 驱动的版本。

查看 JuiceFS CSI 驱动日志

v0.10 及以后版本

找到 mount pod

找到您的 pod 所在的节点。比如，假设您的 pod 名为 juicefs-app：

$ kubectl get pod juicefs-app -o wide
NAME          READY   STATUS              RESTARTS   AGE   IP       NODE          NOMINATED NODE   READINESS GATES
juicefs-app   0/1     ContainerCreating   0          9s    <none>   172.16.2.87   <none>           <none>

从以上输出可以看出，pod 所在节点为 172.16.2.87。

找到您的 pod 所用的 PersistentVolume（PV）的 volume ID。

比如，您的 pod 所用的 PersistentVolumeClaim（PVC）名为 juicefs-pvc：

$ kubectl get pvc juicefs-pvc
NAME          STATUS   VOLUME       CAPACITY   ACCESS MODES   STORAGECLASS   AGE
juicefs-pvc   Bound    juicefs-pv   10Pi       RWX                           42d

从以上输出可以看出，PV 名为 juicefs-pv，然后获取这个 PV 的完整 YAML：

$ kubectl get pv -o yaml juicefs-pv
apiVersion: v1
kind: PersistentVolume
metadata:
  name: juicefs-pv
  ...
spec:
  ...
  csi:
    driver: csi.juicefs.com
    fsType: juicefs
    volumeHandle: juicefs-volume-abc
    ...

从以上输出可以看出，spec.csi.volumeHandle 为 volume ID，如：juicefs-volume-abc。

通过 node 名和 volume ID 找到 JuiceFS mount pod，比如：

$ kubectl -n kube-system get pod -l app.kubernetes.io/name=juicefs-mount -o wide | grep 172.16.2.87 | grep juicefs-volume-abc
juicefs-172.16.2.87-juicefs-volume-abc   1/1     Running   0          20h    172.16.2.100   172.16.2.87   <none>           <none>

从以上输出可以看出，JuiceFS mount pod 名为 juicefs-172.16.2.87-juicefs-volume-abc。

找到 mount pod 的日志

获取 JuiceFS mount pod 的日志，如：

kubectl -n kube-system logs juicefs-172.16.2.87-juicefs-volume-abc

找到所有包含 WARNING，ERROR 或 FATAL 的日志。

v0.10 以前的版本

找到您的 pod 所在的节点。比如，假设您的 pod 名为 juicefs-app：

$ kubectl get pod juicefs-app -o wide
NAME          READY   STATUS              RESTARTS   AGE   IP       NODE          NOMINATED NODE   READINESS GATES
juicefs-app   0/1     ContainerCreating   0          9s    <none>   172.16.2.87   <none>           <none>

从以上输出可以看出，pod 所在节点为 172.16.2.87。

找到相同节点上的 JuiceFS CSI driver pod。比如：

$ kubectl describe node 172.16.2.87 | grep juicefs-csi-node
kube-system                 juicefs-csi-node-hzczw                  1 (0%)        2 (1%)      1Gi (0%)         5Gi (0%)       61m

从以上输出可以看出，JuiceFS CSI driver pod 名为 juicefs-csi-node-hzczw。

获取 JuiceFS CSI Driver 的日志。如：

kubectl -n kube-system logs juicefs-csi-node-hzczw -c juicefs-plugin

找到所有包含 WARNING，ERROR 或 FATAL 的日志。

诊断脚本

你也可以使用诊断脚本来收集日志及相关信息。

在你的集群中可以执行 kubectl 的节点上，下载诊断脚本

wget https://raw.githubusercontent.com/juicedata/juicefs-csi-driver/master/scripts/diagnose.sh

给脚本添加执行权限
```
chmod a+x diagnose.sh
```

使用诊断脚本来收集信息。比如，你的 JuiceFS CSI Driver 部署在 kube-system 这个 namespace 下，并且你想收集 kube-node-2 这台节点上的信息。

$ ./diagnose.sh
Usage:
    ./diagnose-juicefs.sh COMMAND [OPTIONS]
COMMAND:
    help
        Display this help message.
    collect
        Collect pods logs of juicefs.
OPTIONS:
    -no, --node name
        Set the name of node.
    -n, --namespace name
        Set the namespace of juicefs csi driver.

$ ./diagnose.sh -n kube-system -no kube-node-2 collect
Start collecting, node-name=kube-node-2, juicefs-namespace=kube-system
...
please get diagnose_juicefs_1628069696.tar.gz for diagnostics

所有相关的信息都被收集和打包在了一个压缩包里。

查看 JuiceFS CSI 驱动的版本​

查看 JuiceFS CSI 驱动日志​

v0.10 及以后版本​

找到 mount pod​

找到 mount pod 的日志​

v0.10 以前的版本​

诊断脚本​