Querying VM Information

[[toc]]

Overview

StratoVirt can be used to query VM status, vCPU topology information, and vCPU online status. It uses QMP to manage VMs. Therefore, ensure that StratoVirt is connected to the VM before querying the VM information.

Querying VM status

Run the query-status command to query the VM running status.

• Usage:

  { "execute": "query-status" }

• Example:

<- { "execute": "query-status" }
-> { "return": { "running": true,"singlestep": false,"status": "running" } 

Querying Topology Information

Run the query-cpus command to query the topology of all CPUs.

• Usage:

{ "execute": "query-cpus" }

• Example:

<- { "execute": "query-cpus" }
-> {"return":[{"CPU":0,"arch":"x86","current":true,"halted":false,"props":{"core-id":0,"socket-id":0,"thread-id":0},"qom_path":"/machine/unattached/device[0]","thread_id":8439},{"CPU":1,"arch":"x86","current":true,"halted":false,"props":{"core-id":0,"socket-id":1,"thread-id":0},"qom_path":"/machine/unattached/device[1]","thread_id":8440}]}

Querying vCPU Online Status

Run the query-hotpluggable-cpus command to query the online or offline status of all vCPUs.

• Usage:

{ "execute": "query-hotpluggable-cpus" }

• Example:

<- { "execute": "query-hotpluggable-cpus" }
-> {"return":[{"props":{"core-id":0,"socket-id":0,"thread-id":0},"qom-path":"/machine/unattached/device[0]","type":"host-x86-cpu","vcpus-count":1},{"props":{"core-id":0,"socket-id":1,"thread-id":0},"qom-path":"/machine/unattached/device[1]","type":"host-x86-cpu","vcpus-count":1}]}

Where, online vCPUs have the qom-path item, while offline vCPUs do not.