LinuxCommandLibrary

qm-status

Show Proxmox virtual machine and container status

TLDR

Display the status of a specific virtual machine

$ qm status [vm_id]
copy

Display detailed status of a specific virtual machine
$ qm status --verbose [true] [vm_id]
copy

SYNOPSIS

qm status [OPTIONS]

PARAMETERS


    Required. The unique numeric identifier of the virtual machine or container.

--current
    Display the current status. Equivalent to the default behavior.

--verbose
    Display verbose status information.
Includes more details, such as network interface information.

--output-format
    Specifies the output format of the command (json, text, human).
Default is human. Human is designed for user terminal.

DESCRIPTION

The `qm status` command is a Proxmox Virtual Environment (PVE) utility that displays the status of a virtual machine (VM) or container. It provides real-time information about the VM or container's resource usage, including CPU utilization, memory consumption, disk I/O, and network activity. The command is a valuable tool for monitoring the performance of individual VMs or containers within a PVE cluster. It allows administrators to quickly identify resource bottlenecks and troubleshoot performance issues. The output includes crucial details such as the VM/container's state (running, stopped, etc.), PID, uptime, assigned resources (cores, memory), and network interfaces with their associated IP addresses. By examining the output, administrators can gain insights into the health and resource allocation of their virtualized workloads. Furthermore, `qm status` integrates with the PVE web interface and API, providing a unified monitoring experience. This command is fundamental for managing and maintaining a healthy Proxmox VE environment.

CAVEATS

The `qm status` command relies on the Proxmox VE API and infrastructure. If the PVE cluster is experiencing issues, the command may return inaccurate or incomplete information. The command only shows a snapshot of the VM/container status at the time it's executed. For historical performance data, consider using PVE's monitoring tools.

EXIT STATUS

The command returns 0 on success, and a non-zero value on error.

HISTORY

The `qm status` command is part of the Proxmox VE suite, which has been under active development since around 2008. It evolved alongside the core virtualization platform to provide essential management and monitoring capabilities for VMs and containers. Early versions offered basic status information, and subsequent releases introduced features like verbose output and different output formats (such as JSON) to support automation and integration with other tools. The command is crucial for maintaining a robust and manageable PVE environment.

SEE ALSO

qm(1), pvesh(1), pct(1)

Copied to clipboard