15.4. 故障排除
OpenShift Virtualization 提供用于对虚拟机和虚拟化组件进行故障排除的工具和日志。
您可以使用 web 控制台中提供的工具 或使用 oc CLI 工具排除 OpenShift Virtualization 组件。
15.4.1. 事件 复制链接链接已复制到粘贴板!
OpenShift Container Platform 事件是重要生命周期信息的记录,有助于监控虚拟机、命名空间和资源问题。
虚拟机事件 :进入 web 控制台中的 VirtualMachine 详情页中的事件 标签页。
- 命名空间事件
您可以运行以下命令来查看命名空间事件:
oc get events -n <namespace>
$ oc get events -n <namespace>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 有关特定事件的详情,请查看事件列表。
- 资源事件
您可以运行以下命令来查看资源事件:
oc describe <resource> <resource_name>
$ oc describe <resource> <resource_name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
15.4.2. 日志 复制链接链接已复制到粘贴板!
您可以查看以下日志进行故障排除:
15.4.2.1. 使用 web 控制台查看虚拟机日志 复制链接链接已复制到粘贴板!
您可以使用 OpenShift Container Platform web 控制台查看虚拟机日志。
流程
-
进入到 Virtualization
VirtualMachines。 - 选择虚拟机以打开 VirtualMachine 详情页面。
- 在 Details 标签页中,点 pod 名称以打开 Pod 详情页面。
- 点 Logs 选项卡查看日志。
15.4.2.2. 查看 OpenShift Virtualization pod 日志 复制链接链接已复制到粘贴板!
您可以使用 oc CLI 工具查看 OpenShift Virtualization pod 的日志。
您可以通过编辑 HyperConverged 自定义资源 (CR) 来配置日志的详细程度。
15.4.2.2.1. 使用 CLI 查看 OpenShift Virtualization pod 日志 复制链接链接已复制到粘贴板!
您可以使用 oc CLI 工具查看 OpenShift Virtualization pod 的日志。
流程
运行以下命令,查看 OpenShift Virtualization 命名空间中的 pod 列表:
oc get pods -n openshift-cnv
$ oc get pods -n openshift-cnvCopy to Clipboard Copied! Toggle word wrap Toggle overflow 例 15.3. 输出示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 运行以下命令来查看 pod 日志:
oc logs -n openshift-cnv <pod_name>
$ oc logs -n openshift-cnv <pod_name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注意如果 pod 无法启动,您可以使用
--previous选项查看最后一次尝试的日志。要实时监控日志输出,请使用
-f选项。例 15.4. 输出示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
15.4.2.2.2. 配置 OpenShift Virtualization pod 日志详细程度 复制链接链接已复制到粘贴板!
您可以通过编辑 HyperConverged 自定义资源 (CR) 来配置 OpenShift Virtualization pod 日志的详细程度。
流程
要为特定组件设置日志详细程度,请运行以下命令在默认文本编辑器中打开
HyperConvergedCR:oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv
$ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnvCopy to Clipboard Copied! Toggle word wrap Toggle overflow 通过编辑
spec.logVerbosityConfig小节,为一个或多个组件设置日志级别。例如:Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 日志详细程度值必须是范围
1-9中的一个整数,其中较高的数字表示更详细的日志。在本例中,如果优先级级别为5或更高版本,则virtAPI组件日志会公开。
- 通过保存并退出编辑器来应用您的更改。
15.4.2.2.3. 常见错误消息 复制链接链接已复制到粘贴板!
OpenShift Virtualization 日志中可能会出现以下出错信息:
ErrImagePull或ImagePullBackOff- 表示引用镜像的部署配置或问题。
15.4.2.3. 使用 LokiStack 查看聚合的 OpenShift Virtualization 日志 复制链接链接已复制到粘贴板!
您可以使用 web 控制台中的 LokiStack 查看 OpenShift Virtualization pod 和容器的聚合日志。
先决条件
- 您已部署了 LokiStack。
流程
-
在 web 控制台中进入 Observe
Logs。 -
从日志类型列表中选择 应用程序,对于
virt-launcherpod 日志或基础架构,为 OpenShift Virtualization control plane pod 和容器选择应用程序。 - 点 Show Query 以显示查询字段。
- 在查询字段中输入 LogQL 查询,然后点 Run Query 以显示过滤的日志。
15.4.2.3.1. OpenShift Virtualization LogQL 查询 复制链接链接已复制到粘贴板!
您可以通过在 web 控制台的 Observe
默认日志类型是 infrastructure。virt-launcher 日志类型是 application。
可选: 您可以使用行过滤器表达式来包含或排除字符串或正则表达式。
如果查询与大量日志匹配,查询可能会超时。
| 组件 | LogQL 查询 |
|---|---|
| All |
{log_type=~".+"}|json
|kubernetes_labels_app_kubernetes_io_part_of="hyperconverged-cluster"
|
|
|
{log_type=~".+"}|json
|kubernetes_labels_app_kubernetes_io_part_of="hyperconverged-cluster"
|kubernetes_labels_app_kubernetes_io_component="storage"
|
|
|
{log_type=~".+"}|json
|kubernetes_labels_app_kubernetes_io_part_of="hyperconverged-cluster"
|kubernetes_labels_app_kubernetes_io_component="deployment"
|
|
|
{log_type=~".+"}|json
|kubernetes_labels_app_kubernetes_io_part_of="hyperconverged-cluster"
|kubernetes_labels_app_kubernetes_io_component="network"
|
|
|
{log_type=~".+"}|json
|kubernetes_labels_app_kubernetes_io_part_of="hyperconverged-cluster"
|kubernetes_labels_app_kubernetes_io_component="compute"
|
|
|
{log_type=~".+"}|json
|kubernetes_labels_app_kubernetes_io_part_of="hyperconverged-cluster"
|kubernetes_labels_app_kubernetes_io_component="schedule"
|
| Container |
{log_type=~".+",kubernetes_container_name=~"<container>|<container>"}
|json|kubernetes_labels_app_kubernetes_io_part_of="hyperconverged-cluster"
|
|
| 在运行此查询前,您必须从日志类型列表中选择 应用程序。 {log_type=~".+", kubernetes_container_name="compute"}|json
|!= "custom-ga-command"
|
您可以使用行过滤器表达式过滤日志行使其包含或排除字符串或正则表达式。
| 行过滤器表达式 | 描述 |
|---|---|
|
| 日志行包含字符串 |
|
| 日志行不包含字符串 |
|
| 日志行包含正则表达式 |
|
| 日志行不包含正则表达式 |
行过滤器表达式示例
{log_type=~".+"}|json
|kubernetes_labels_app_kubernetes_io_part_of="hyperconverged-cluster"
|= "error" != "timeout"
{log_type=~".+"}|json
|kubernetes_labels_app_kubernetes_io_part_of="hyperconverged-cluster"
|= "error" != "timeout"
15.4.3. 数据卷故障排除 复制链接链接已复制到粘贴板!
您可以检查 DataVolume 对象的 Conditions 和 Events 部分,以分析并解决问题。
15.4.3.1. 关于数据卷条件和事件 复制链接链接已复制到粘贴板!
您可以通过检查命令生成的 Conditions 和 Events 部分的输出来诊断数据卷的问题:
oc describe dv <DataVolume>
$ oc describe dv <DataVolume>
Conditions 部分显示以下 类型 :
-
Bound -
Running -
Ready
Events 部分提供以下额外信息:
-
事件
类型 -
日志
原因 -
事件
源 -
包含其他诊断信息的
消息。
oc describe 的输出并不总是包含 Events。
当 Status、Reason 或 Message 改变时会产生一个事件。条件和事件均响应数据卷状态的变化。
例如,在导入操作中错误拼写了 URL,则导入会生成 404 信息。该消息的更改会生成一个带有原因的事件。Conditions 部分中的输出也会更新。
15.4.3.2. 分析数据卷条件和事件 复制链接链接已复制到粘贴板!
通过检查 describe 命令生成的 Conditions 和 Events 部分,您可以确定与 PVC相关的数据卷的状态,以及某个操作是否正在主动运行或完成。您可能还会收到信息,它们提供了有关数据卷状态的特定详情,以及如何处于当前状态。
有多种条件的组合。对每个条件组合的评估都必须其特定的环境下进行。
下面是各种组合的例子。
Bound- 本示例中会显示成功绑定 PVC。请注意,
Type是Bound,所以Status为True。如果 PVC 没有绑定,Status为False。当 PVC 被绑定时,会生成一个事件声明 PVC 已被绑定。在本例中,
Reason为Bound,Status为True。Message指明了哪个 PVC 拥有数据卷。在
Events部分,Message提供了更多详细信息,包括 PVC 被绑定的时间(Age)和它的源(From),在本例中是datavolume-controller:输出示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Running- 在本例中,请注意Type是Running,Status为False。这表示发生事件导致尝试的操作失败,将 Status 从True改为False。然而,请注意
Reason是Completed,Message显示Import Complete。在
Events部分,Reason和Message包含有关失败操作的额外故障排除信息。在这个示例中,Message显示因为404无法连接,这在Events部分的第一个Warning中列出。根据这些信息,您认为导入操作正在运行,并为试图访问数据卷的其他操作创建竞争:
输出示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Ready- 如果Type是Ready,Status为True,则代表数据卷已就绪,如下例所示。如果数据卷未就绪,则Status为False:输出示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow