第 23 章 诊断虚拟机问题
使用虚拟机(VM)时,您可能会遇到不同严重等级的问题。有些问题可能很快且容易修复,而另外一些问题,您可能需要捕获与虚拟机相关的数据和日志来报告或诊断问题。
以下章节提供了有关生成日志、诊断一些常见虚拟机问题以及报告这些问题的详细信息。
23.1. 生成 libvirt 调试日志 复制链接链接已复制到粘贴板!
要诊断虚拟机(VM)问题,生成和查看 libvirt 调试日志会很有帮助。当请求支持解决与虚拟机相关的问题时,附加调试日志也很有用。
以下章节解释了 什么是调试日志,如何 将它们设为永久 ,在运行时启用它们,以及在报告问题时 附加它们。
23.1.1. 了解 libvirt 调试日志 复制链接链接已复制到粘贴板!
调试日志在虚拟机(VM)运行时记录事件,包括主机库、libvirt 守护进程以及所有正在运行的虚拟机的标准输出(stderr)的信息。
默认不启用 debug 日志记录,且必须在 libvirt 启动时启用。您可以对单个会话启用日志记录,也可以 永久启用记录。您还可以通过 修改守护进程运行时设置,在 libvirt 守护进程会话运行时启用日志。
在请求对虚拟机问题的支持时,附加 libvirt 调试日志也很有用。
23.1.2. 为 libvirt 调试日志启用持久性设置 复制链接链接已复制到粘贴板!
要确保您的虚拟化主机自动记录调试信息,请将 libvirt 调试日志配置为在 libvirt 启动时自动启用。
您可以将 libvirt debug 日志记录配置为在 libvirt 启动时自动启用。默认情况下,virtqemud 是 RHEL 9 中的主要 libvirt 守护进程。要在 libvirt 配置中进行持久更改,您必须编辑位于 /etc/libvirt 目录中的 virtqemud.conf 文件。
在某些情况下,例如,当您从 RHEL 8 升级时,libvirtd 可能仍为已启用的 libvirt 守护进程。在这种情况下,您必须编辑 libvirtd.conf 文件。
流程
-
在编辑器中打开
virtqemud.conf文件。 根据您的要求替换或设置过滤器。
表 23.1. 调试过滤器的值 1
记录 libvirt 生成的所有消息。
2
记录所有非调试信息。
3
记录所有警告和错误消息。这是默认值。
4
仅记录错误消息。
例 23.1. 日志过滤器的守护进程设置示例
以下设置:
-
记录来自
remote,util.json和rpc层的所有错误和警告消息 -
仅记录来自
event层的错误消息。 -
将过滤的日志保存到
/var/log/libvirt/libvirt.log
log_filters="3:remote 4:event 3:util.json 3:rpc" log_outputs="1:file:/var/log/libvirt/libvirt.log"-
记录来自
- 保存并退出。
重启 libvirt 守护进程。
$ systemctl restart virtqemud.service
23.1.3. 在运行时启用 libvirt 调试日志 复制链接链接已复制到粘贴板!
要临时收集虚拟化调试信息,您可以修改 libvirt 守护进程的运行时设置来启用调试日志并将其保存到输出文件中。
在以下情况下修改 libvirt 运行时设置很有用:
-
当无法重启
libvirt守护进程时,因为重启解决了这个问题。 - 当另一个进程(如迁移或备份)同时运行时。
- 当您要在不编辑配置文件或重新启动守护进程的情况下尝试命令。
先决条件
-
确保
libvirt-admin软件包已安装。
流程
可选:备份活跃的日志过滤器集合。
# virt-admin -c virtqemud:///system daemon-log-filters >> virt-filters-backup注意建议您备份一组处于活动状态的过滤器,以便在生成日志后恢复它们。如果您没有恢复过滤器,则会继续记录消息,这可能会影响系统性能。
使用
virt-admin工具启用调试,并根据您的要求设置过滤器。表 23.2. 调试过滤器的值 1
记录 libvirt 生成的所有消息。
2
记录所有非调试信息。
3
记录所有警告和错误消息。这是默认值。
4
仅记录错误消息。
例 23.2. 日志过滤器的 virt-admin 设置示例
以下命令:
-
记录来自
远程、util.json和rpc层的所有错误和警告消息 -
仅记录来自
event层的错误消息。
# virt-admin -c virtqemud:///system daemon-log-filters "3:remote 4:event 3:util.json 3:rpc"-
记录来自
使用
virt-admin工具将日志保存到特定的文件或目录中。例如,以下命令将日志输出保存到
/var/log/libvirt/目录中的libvirt.log文件中:# virt-admin -c virtqemud:///system daemon-log-outputs "1:file:/var/log/libvirt/libvirt.log"可选:您还可以删除过滤器,来生成包含所有与虚拟机相关的信息的日志文件。但不建议您这样做,因为这个文件可能包含由 libvirt 模块生成的大量冗余信息。
使用
virt-admin工具指定一组空白的过滤器。# virt-admin -c virtqemud:///system daemon-log-filters Logging filters:
-
可选:使用备份文件将过滤器恢复到其原始状态。
使用保存的值执行第二步,以恢复过滤器。
23.1.4. 将 libvirt 调试日志附加到支持请求中 复制链接链接已复制到粘贴板!
要诊断并解决虚拟机(VM)问题,您可能需要请求额外的支持。强烈建议将调试日志附加到支持请求中,以确保支持团队可以访问所需的所有信息,以便为与虚拟机相关的问题提供解决方案。
流程
- 要报告问题并请求支持,创建一个支持问题单。
根据遇到的问题,将以下日志与您的报告一起附加:
-
对于 libvirt 服务的问题,请附加主机上的
/var/log/libvirt/libvirt.log文件。 对于特定虚拟机的问题,请附加对应的日志文件。
例如,对于 testguest1 虚拟机,请附加
testguest1.log文件,该文件可在/var/log/libvirt/qemu/testguest1.log中找到。
-
对于 libvirt 服务的问题,请附加主机上的