13.3. 故障排除

流程

1. 要为特定组件设置日志详细程度，请运行以下命令在默认文本编辑器中打开 HyperConverged CR：

   $ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv

2. 通过编辑 spec.logVerbosityConfig 小节，为一个或多个组件设置日志级别。例如：

   apiVersion: hco.kubevirt.io/v1beta1
   kind: HyperConverged
   metadata:
     name: kubevirt-hyperconverged
   spec:
     logVerbosityConfig:
       kubevirt:
         virtAPI: 5 1
         virtController: 4
         virtHandler: 3
         virtLauncher: 2
         virtOperator: 6

   1

   日志详细程度值必须是范围 1-9 中的一个整数，其中较高的数字表示更详细的日志。在本例中，如果优先级级别为 5 或更高版本，则 virtAPI 组件日志会公开。

3. 通过保存并退出编辑器来应用您的更改。

流程

1. 进入到 Virtualization VirtualMachines。
2. 选择虚拟机以打开 VirtualMachine 详情页面。
3. 在 General 标题中，点 pod 名称打开 Pod 详情页面。
4. 点 Logs 选项卡查看日志。

流程

1. 运行以下命令，查看 OpenShift Virtualization 命名空间中的 pod 列表：

   $ oc get pods -n openshift-cnv

   例 13.1. 输出示例

   NAME                               READY   STATUS    RESTARTS   AGE
   disks-images-provider-7gqbc        1/1     Running   0          32m
   disks-images-provider-vg4kx        1/1     Running   0          32m
   virt-api-57fcc4497b-7qfmc          1/1     Running   0          31m
   virt-api-57fcc4497b-tx9nc          1/1     Running   0          31m
   virt-controller-76c784655f-7fp6m   1/1     Running   0          30m
   virt-controller-76c784655f-f4pbd   1/1     Running   0          30m
   virt-handler-2m86x                 1/1     Running   0          30m
   virt-handler-9qs6z                 1/1     Running   0          30m
   virt-operator-7ccfdbf65f-q5snk     1/1     Running   0          32m
   virt-operator-7ccfdbf65f-vllz8     1/1     Running   0          32m

2. 运行以下命令来查看 pod 日志：

   $ oc logs -n openshift-cnv <pod_name>

   注意

   如果 pod 无法启动，您可以使用 --previous 选项查看最后一次尝试的日志。

   要实时监控日志输出，请使用 -f 选项。

   例 13.2. 输出示例

   {"component":"virt-handler","level":"info","msg":"set verbosity to 2","pos":"virt-handler.go:453","timestamp":"2022-04-17T08:58:37.373695Z"}
   {"component":"virt-handler","level":"info","msg":"set verbosity to 2","pos":"virt-handler.go:453","timestamp":"2022-04-17T08:58:37.373726Z"}
   {"component":"virt-handler","level":"info","msg":"setting rate limiter to 5 QPS and 10 Burst","pos":"virt-handler.go:462","timestamp":"2022-04-17T08:58:37.373782Z"}
   {"component":"virt-handler","level":"info","msg":"CPU features of a minimum baseline CPU model: map[apic:true clflush:true cmov:true cx16:true cx8:true de:true fpu:true fxsr:true lahf_lm:true lm:true mca:true mce:true mmx:true msr:true mtrr:true nx:true pae:true pat:true pge:true pni:true pse:true pse36:true sep:true sse:true sse2:true sse4.1:true ssse3:true syscall:true tsc:true]","pos":"cpu_plugin.go:96","timestamp":"2022-04-17T08:58:37.390221Z"}
   {"component":"virt-handler","level":"warning","msg":"host model mode is expected to contain only one model","pos":"cpu_plugin.go:103","timestamp":"2022-04-17T08:58:37.390263Z"}
   {"component":"virt-handler","level":"info","msg":"node-labeller is running","pos":"node_labeller.go:94","timestamp":"2022-04-17T08:58:37.391011Z"}

流程

1. 在侧边菜单中点 Virtualization Overview。
2. 点 Settings 选项卡。
3. 点 Cluster Guest Management。
4. 设置 Enable guest system log access 为 on。

流程

1. 运行以下命令，在默认编辑器中打开 HyperConverged CR：

   $ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv

2. 更新 disableSerialConsoleLog 值。例如：

   kind: HyperConverged
   metadata:
     name: kubevirt-hyperconverged
   spec:
     virtualMachineOptions:
       disableSerialConsoleLog: true 1
   #...

   1

   如果您希望默认启用串口控制台访问，请将 disableSerialConsoleLog 的值设置为 false。

流程

1. 在侧边菜单中点 Virtualization VirtualMachines。
2. 选择虚拟机以打开 VirtualMachine 详情页面。
3. 点 Configuration 选项卡。
4. 将 Guest system log access 设置为 on 或 off。

流程

1. 运行以下命令来编辑虚拟机清单：

   $ oc edit vm <vm_name>

2. 更新 logSerialConsole 字段的值。例如：

   apiVersion: kubevirt.io/v1
   kind: VirtualMachine
   metadata:
     name: example-vm
   spec:
     template:
       spec:
         domain:
           devices:
             logSerialConsole: true 1
   #...

   1

   要启用对客户机的串行控制台日志的访问，请将 logSerialConsole 值设置为 true。

3. 运行以下命令，将新配置应用到虚拟机：

   $ oc apply vm <vm_name>

4. 可选：如果您编辑了正在运行的虚拟机，重启虚拟机以应用新配置。例如：

   $ virtctl restart <vm_name> -n <namespace>

流程

1. 在侧边菜单中点 Virtualization VirtualMachines。
2. 选择虚拟机以打开 VirtualMachine 详情页面。
3. 点 Diagnostics 选项卡。
4. 点 Guest system logs 以加载串行控制台。

流程

1. 在 web 控制台中进入 Observe Logs。
2. 从日志类型列表中选择 应用程序，对于 virt-launcher pod 日志或基础架构，为 OpenShift Virtualization control plane pod 和容器选择应用程序。
3. 点 Show Query 以显示查询字段。
4. 在查询字段中输入 LogQL 查询，然后点 Run Query 以显示过滤的日志。