长期支持版本

    社区创新版本

      工具使用指南

      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

      有点复杂...

      找人问问吧。

      PR

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

      一键搞定!

      问题类型
      规范和低错类

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

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

      ● 英文中包含中文字符;

      ● 界面和描述不一致,但不影响操作;

      ● 表述不通顺,但不影响理解;

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

      易用性

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

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

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

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

      正确性

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

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

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

      ● 代码片段错误;

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

      ● 界面错误,无法指导操作;

      风险提示

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

      内容合规

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

      ● 内容侵权;

      您对文档的总体满意度

      非常不满意
      非常满意
      提交
      根据您的反馈,会自动生成issue模板。您只需点击按钮,创建issue即可。
      文档捉虫
      编组 3备份