info¶
See also: list, Instance states, Availability zone
The multipass info command shows properties of instances and snapshots.
For example, multipass info calm-squirrel:
Name: calm-squirrel
State: Running
Zone: zone1
Snapshots: 0
IPv4: 10.97.0.76
Release: Ubuntu 26.04 LTS
Image hash: dced94c031cc (Ubuntu 26.04 LTS)
CPU(s): 1
Load: 0.16 0.09 0.08
Disk usage: 2.2GiB out of 4.8GiB
Memory usage: 169.8MiB out of 950.4MiB
Mounts: --
or, in case of a snapshot, multipass info relative-lion.snapshot3:
Snapshot: snapshot3
Instance: relative-lion
CPU(s): 1
Disk space: 5.0GiB
Memory size: 1.0GiB
Mounts: --
Created: 2023-10-30T13:31:37.239Z
Parent: snapshot1
Children: --
Comment: Before restoring snapshot2
To obtain information on all the snapshots of an instance, you can specify the name of the instance and add the --snapshots option to the command.
With no positional arguments, multipass info displays information on all the instances. If you add the --snapshots flag and no positional arguments, the command displays information on all the snapshots of all instances.
The --format option allows to choose how the output is formatted. The available options are a human-readable table, or machine-readable formats: json, yaml or csv.
Note
The json, csv and yaml formats cover regular output only. Errors and log messages are printed to the standard error stream as plain text, with failures signaled by a non-zero exit status.
For example, the command multipass info --format yaml calm-squirrel produces the following output:
errors:
- ~
calm-squirrel:
- state: Running
zone:
name: zone1
available: true
snapshot_count: 0
image_hash: dced94c031cc1f23dee14419a3723a5b110df9938de0ac31913a2bfd07c755b4
image_release: 26.04 LTS
release: Ubuntu 26.04 LTS
cpu_count: 1
load:
- 0.04
- 0.06
- 0.06
disks:
- sda1:
used: 2402924032
total: 5120138752
memory:
usage: 178364416
total: 996544512
ipv4:
- 10.97.0.76
mounts: ~
Details available for instances and snapshots¶
Here you can find a comprehensive list of the details that multipass info provides for instances and snapshots, respectively.
Instance details¶
Entry |
Description |
|---|---|
|
Name of the instance that the information pertains to |
|
Current state of the instance (see also: Instance states) |
|
The availability zone the instance was launched into, as chosen automatically or via the |
|
Number of snapshots of the instance |
|
A list of IPs through which a machine on the same network as the instance can reach the instance. Adding IP addresses besides the one automatically generated by Multipass is described in Create an instance with a bridged or custom network. |
|
Title of the release of the image installed on this instance |
|
The SHA-256 hash of the aforementioned image. This can be used to verify the validity of the image. |
|
Number of cores that the instance can use, as defined by the |
|
A triplet of values describing the average number of processes running on the CPU or in queue waiting for CPU time, sampled over the last 1 minute, 5 minutes and 15 minutes respectively. The values are normalised to the number of CPU cores, so for a machine with N cores, a load average of N indicates that the CPU is utilised at maximum capacity over the respective time interval, while a value below or above N indicates that the CPU is either under-utilised or over-utilised. |
|
Amount of disk space used by the instance, as defined by the |
|
Amount of memory used by the instance, as defined by the |
|
List of directories on the host machine that are accessible through their respective directories from inside the instance. Each directory mapping has a list of UID and GID mappings, representing how the ownership of their respective host directories is translated the ownership of their respective instance directories. See also: Mount. |
Snapshot details¶
Entry |
Description |
|---|---|
|
Name of the snapshot that the following details pertain to, as defined by the |
|
Name of the instance that snapshot belongs too |
|
Number of cores that were assigned to the instance when the snapshot was taken, as defined by the |
|
Size of the instances disk when the snapshot was taken, as defined by the |
|
Amount of memory that was assigned to the instance when the snapshot was taken, as defined by the |
|
List of directories on the host machine that were mounted inside the instance at the time that the snapshot was taken. See also: Mount. |
|
Timestamp containing the date and time when the snapshot was created |
|
The snapshot that was last in effect when this snapshot was taken, relatively to which the current snapshot records changes |
|
A list of snapshots that have this snapshot as a parent |
|
The comment that is associated with the snapshot, as defined by the |
The full multipass help info output explains the available options:
Usage: multipass info [options] <instance>[.snapshot] [<instance>[.snapshot] ...]
Display information about instances or snapshots
Options:
-h, --help Displays help on commandline options
-v, --verbose Increase logging verbosity. Repeat the 'v' in the short
option for more detail. Maximum verbosity is obtained with
4 (or more) v's, i.e. -vvvv.
--snapshots Display detailed information about the snapshots of
specified instances. This option has no effect on snapshot
arguments. Omit instance/snapshot arguments to obtain
detailed information on all the snapshots of all instances.
--format <format> Output info in the requested format.
Valid formats are: table (default), json, csv and yaml. The
json, csv and yaml formats cover regular output only.
Errors and log messages are printed to the standard error
stream as plain text, with failures signaled by a non-zero
exit status.
Arguments:
instance/snapshot Names of instances or snapshots to display information
about