orca hypervisor¶
Inspect Nova hypervisors (admin).
The reference below is generated from the live CLI by mkdocs-click. It
always reflects the version installed.
orca hypervisor¶
Manage hypervisors (Nova).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
Subcommands
- list: List hypervisors.
- show: Show hypervisor details.
- stats: Aggregate hypervisor statistics across the cluster.
- usage: Show fill rate per hypervisor, sorted by load.
orca hypervisor list¶
List hypervisors.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--noindent |
boolean | Disable JSON indentation. | False |
--max-width |
integer | Maximum table width (0 = unlimited). | None |
--fit-width |
boolean | Fit table to terminal width. | False |
--column, -c |
text | Column to include (repeatable). Shows all if omitted. | Sentinel.UNSET |
--format, -f |
choice (table | json | value) |
Output format. | table |
--help |
boolean | Show this message and exit. | False |
orca hypervisor show¶
Show hypervisor details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--noindent |
boolean | Disable JSON indentation. | False |
--max-width |
integer | Maximum table width (0 = unlimited). | None |
--fit-width |
boolean | Fit table to terminal width. | False |
--column, -c |
text | Column to include (repeatable). Shows all if omitted. | Sentinel.UNSET |
--format, -f |
choice (table | json | value) |
Output format. | table |
--help |
boolean | Show this message and exit. | False |
orca hypervisor stats¶
Aggregate hypervisor statistics across the cluster.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
Subcommands
- show: Show cluster-wide hypervisor stats (vCPUs, RAM, disk, running VMs).
orca hypervisor stats show¶
Show cluster-wide hypervisor stats (vCPUs, RAM, disk, running VMs).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--noindent |
boolean | Disable JSON indentation. | False |
--max-width |
integer | Maximum table width (0 = unlimited). | None |
--fit-width |
boolean | Fit table to terminal width. | False |
--column, -c |
text | Column to include (repeatable). Shows all if omitted. | Sentinel.UNSET |
--format, -f |
choice (table | json | value) |
Output format. | table |
--help |
boolean | Show this message and exit. | False |
orca hypervisor usage¶
Show fill rate per hypervisor, sorted by load.
Combines vCPU, RAM and disk usage into a per-host 'score' (the worst dimension) so the most-saturated hypervisors surface at the top.
Color thresholds: Green < 70% — comfortable headroom Yellow 70–90% — monitor closely Red ≥ 90% — critical
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--sort-by |
choice (cpu | ram | disk | max | vms) |
Metric to sort by. 'max' picks the worst of CPU/RAM/disk per host. | max |
--reverse |
boolean | Sort least-loaded first (default: most-loaded first). | False |
--threshold |
integer range (between 0 and 100) |
Only show hypervisors whose 'max' fill rate is ≥ this percentage. | 0 |
--top |
integer | Show only the top N hypervisors after sorting. | None |
--noindent |
boolean | Disable JSON indentation. | False |
--max-width |
integer | Maximum table width (0 = unlimited). | None |
--fit-width |
boolean | Fit table to terminal width. | False |
--column, -c |
text | Column to include (repeatable). Shows all if omitted. | Sentinel.UNSET |
--format, -f |
choice (table | json | value) |
Output format. | table |
--help |
boolean | Show this message and exit. | False |