工具使用指南

vmtop使用指南

vmtop使用指南

概述

vmtop 是运行在宿主机host上的用户态工具。使用vmtop可以实时动态地查看虚拟机资源的使用情况，例如CPU占用率、内存占用率、vCPU陷入陷出次数等。因此，可以使用vmtop作为虚拟化问题定位和性能调优的工具。

多架构支持

当前vmtop支持AArch64和x86_64处理器架构。

显示项说明

不同处理器架构的操作系统，vmtop的显示项存在差异，这里给出各个显示项的含义及其是否在对应架构呈现。说明：以下采样差是指指定时间间隔内获取的两次数据的差值。

AArch64和x86_64架构公共显示项

VM/task-name: 虚拟机/进程名称
DID: 虚拟机id
PID: 虚拟机qemu进程的pid
%CPU: 进程的CPU占用率
EXTsum: kvm exit总次数（采样差）
S: 进程状态
P: 进程所占用的物理CPU号
%ST: 被抢占时间与cpu运行时间的比
%GUE: 虚拟机内部占用时间与CPU运行时间的比
%HYP: 虚拟化开销占比

仅AArch64架构的显示项

EXThvc: hvc-exit次数（采样差）
EXTwfe: wfe-exit次数（采样差）
EXTwfi: wfi-exit次数（采样差）
EXTmmioU: mmioU-exit次数（采样差）
EXTmmioK: mmioK-exit次数（采样差）
EXTfp: fp-exit次数（采样差）
EXTirq: irq-exit次数（采样差）
EXTsys64: sys64 exit次数（采样差）
EXTmabt: mem abort exit次数（采样差）

仅x86_64架构的显示项

PFfix: 缺页次数（采样差）
PFgu: 向guest OS注入缺页次数（采样差）
INvlpg: 冲刷tlb某项次数(tlb其中一项，并不固定)
EXTio: io VM-exit次数（采样差）
EXTmmio: mmio VM-exit次数（采样差）
EXThalt: halt VM-exit次数（采样差）
EXTsig: 信号处理引起的VM-exit次数（采样差）
EXTirq: 中断引起的VM-exit次数（采样差）
EXTnmiW: 处理不可屏蔽中断引起的VM-exit次数（采样差）
EXTirqW: interruptwindow机制，开启中断使能时exit，以便注入中断（采样差）
IrqIn: 注入irq中断次数（采样差）
NmiIn: 注入nmi中断次数（采样差）
TLBfl: 冲刷整个tlb次数（采样差）
HostReL: 重载主机状态次数（采样差）
Hyperv: 模拟Guest操作系统辅助虚拟化调用hypercall的处理次数（采样差）
EXTcr: 访问CR寄存器退出次数（采样差）
EXTrmsr: 读msr退出次数（采样差）
EXTwmsr: 写msr退出次数（采样差）
EXTapic: 写apic次数（采样差）
EXTeptv: Ept缺页退出次数（采样差）
EXTeptm: Ept错误退出次数（采样差）
EXTpau: Vcpu暂停退出次数（采样差）

使用方法

vmtop是一款命令行工具，直接以命令行的方式运行 vmtop 即可。另外，vmtop还提供了不同可选选项，用于查询不同信息。

语法格式

vmtop [选项]

选项说明

-d: 设置显示刷新的时间间隔，单位：秒
-H: 显示虚拟机的线程信息
-n: 设置显示刷新的次数，刷新完成后退出
-b: Batch模式显示，可以用于重定向到文件
-h: 显示帮助信息
-v: 显示版本
-p: 监控指定id的虚拟机

快捷键

在vmtop运行状态下使用的快捷键

H: 显示或关闭虚拟机线程信息，默认显示该信息
up/down: 向上/向下移动显示的虚拟机列表
left/right: 向左/向右移动显示的信息，从而显示因屏幕宽度被隐藏的列
f: 进入监控项编辑模式，选择要开启的监控项
q: 退出vmtop进程

示例

在host上直接以命令行的方式运行vmtop

vmtop

输出如下:

vmtop - 2020-09-14 09:54:48 - 1.0
Domains: 1 running

  DID  VM/task-name     PID  %CPU    EXThvc    EXTwfe    EXTwfi  EXTmmioU  EXTmmioK     EXTfp    EXTirq  EXTsys64   EXTmabt    EXTsum    S    P   %ST  %GUE  %HYP
    2       example 4054916  13.0         0         0      1206        10         0       144        62       174         0      1452    S  106   0.0  99.7  16.0

可以看到，host上只有一台名称为“example”的虚拟机，ID为2，CPU占用率是13.0%，在1秒内的陷入陷出总次数是1452，虚拟机进程占用的物理CPU为106号CPU，虚拟机内部占用时间与CPU运行时间的比是99.7%。

1.显示虚拟机线程信息按下‘H’后可以显示线程信息：

vmtop - 2020-09-14 10:11:27 - 1.0
Domains: 1 running

  DID  VM/task-name     PID  %CPU    EXThvc    EXTwfe    EXTwfi  EXTmmioU  EXTmmioK     EXTfp    EXTirq  EXTsys64   EXTmabt    EXTsum    S    P   %ST  %GUE  %HYP
    2       example 4054916  13.0         0         0	   1191        17         4       120        76       147         0      1435    S  119   0.0 123.7   4.0
   |_      qemu-kvm 4054916   0.0         0         0         0         0         0         0         0         0         0         0    S  119   0.0   0.0   0.0
   |_      qemu-kvm 4054928   0.0         0         0         0         0         0         0         0         0         0         0    S  119   0.0   0.0   0.0
   |_  signalfd_com 4054929   0.0         0         0         0         0         0         0         0         0         0         0    S  120   0.0   0.0   0.0
   |_  IO mon_iothr 4054932   0.0         0         0         0         0         0         0         0         0         0         0    S  117   0.0   0.0   0.0
   |_     CPU 0/KVM 4054933   3.0         0         0       280         6         4        28        19        41         0       350    S  105   0.0  27.9   0.0
   |_     CPU 1/KVM 4054934   3.0         0         0       260         0         0        16        12        36         0       308    S   31   0.0  20.0   0.0
   |_     CPU 2/KVM 4054935   3.0         0         0       341         0         0        44        20        26         0       387    R  108   0.0  27.9   4.0
   |_     CPU 3/KVM 4054936   5.0         0         0       310        11         0        32        25        44         0       390    S  103   0.0  47.9   0.0
   |_   memory_lock 4054940   0.0         0         0         0         0         0         0         0         0         0         0    S  126   0.0   0.0   0.0
   |_    vnc_worker 4054944   0.0         0         0         0         0         0         0         0         0         0         0    S  118   0.0   0.0   0.0
   |_        worker 4143738   0.0         0         0         0         0         0         0         0         0         0         0    S  120   0.0   0.0   0.0

example虚拟机有11个线程，其中包括vCPU线程、vnc_worker、IO mon_iotreads等等，每个线程同样会显示详细CPU占用、陷入陷出等信息。

2.选择监控项按下‘f’进入监控项编辑模式：

field filter - select which field to be showed
Use up/down to navigate, use space to set whether chosen filed to be showed
'q' to quit to normal display

 * DID
 * VM/task-name
 * PID
 * %CPU
 * EXThvc
 * EXTwfe
 * EXTwfi
 * EXTmmioU
 * EXTmmioK
 * EXTfp
 * EXTirq
 * EXTsys64
 * EXTmabt
 * EXTsum
 * S
 * P
 * %ST
 * %GUE
 * %HYP

当前所有监控项都默认显示，通过up/down键选择，用space键来设置对应显示项是否显示/隐藏，按‘q’键退出。将%ST、%GUE、%HYP设置为隐藏后，输出如下:

vmtop - 2020-09-14 10:23:25 - 1.0
Domains: 1 running

  DID  VM/task-name     PID  %CPU    EXThvc    EXTwfe    EXTwfi  EXTmmioU  EXTmmioK     EXTfp    EXTirq  EXTsys64   EXTmabt    EXTsum    S    P
    2       example 4054916  12.0         0         0	   1213        14         1       144        68       168         0      1464    S  125
   |_	   qemu-kvm 4054916   0.0         0         0         0         0         0         0         0         0         0         0    S  125
   |_	   qemu-kvm 4054928   0.0         0         0         0         0         0         0         0         0         0         0    S  119
   |_  signalfd_com 4054929   0.0         0         0         0         0         0         0         0         0         0         0    S  120
   |_  IO mon_iothr 4054932   0.0         0         0         0         0         0         0         0         0         0         0    S  117
   |_     CPU 0/KVM 4054933   2.0         0         0       303         6         0        29        10        35         0       354    S   98
   |_     CPU 1/KVM 4054934   4.0         0         0       279         0         0        39        17        49         0       345    S    1
   |_     CPU 2/KVM 4054935   3.0         0         0       283         0         0        33        20        40         0       343    S  122
   |_     CPU 3/KVM 4054936   3.0         0         0       348         8         1        43        21        44         0       422    S  110
   |_   memory_lock 4054940   0.0         0         0         0         0         0         0         0         0         0         0    S  126
   |_    vnc_worker 4054944   0.0         0         0         0         0         0         0         0         0         0         0    S  118
   |_        worker    1794   0.0         0         0         0         0         0         0         0         0         0         0    S  126

%ST、%GUE、%HYP将不会出现在显示界面上。

文档捉虫

“有虫”文档片段

问题描述

提交类型 issue

有点复杂...

找人问问吧。

小问题，全程线上修改...

一键搞定！

问题类型

规范和低错类

● 错别字或拼写错误；标点符号使用错误；

● 链接错误、空单元格、格式错误；

● 英文中包含中文字符；

● 界面和描述不一致，但不影响操作；

● 表述不通顺，但不影响理解；

● 版本号不匹配：如软件包名称、界面版本号；

易用性

● 关键步骤错误或缺失，无法指导用户完成任务；

● 缺少必要的前提条件、注意事项等；

● 图形、表格、文字等晦涩难懂；

● 逻辑不清晰，该分类、分项、分步骤的没有给出；

正确性

● 技术原理、功能、规格等描述和软件不一致，存在错误；

● 原理图、架构图等存在错误；

● 命令、命令参数等错误；

● 代码片段错误；

● 命令无法完成对应功能；

● 界面错误，无法指导操作；

风险提示

● 对重要数据或系统存在风险的操作，缺少安全提示；

内容合规

● 违反法律法规，涉及政治、领土主权等敏感词；

● 内容侵权；

我们可能针对您提出的问题，向您发送邮件反馈进行方案。如有获奖信息，也会通过此方式通知您。

您对文档的总体满意度

非常不满意

非常满意

您理解并同意，您填写并提交的内容，即视为您已充分阅读并同意openEuler的《隐私政策》

提交

根据您的反馈，会自动生成issue模板。您只需点击按钮，创建issue即可。