murmur pool status

Prints the current state of your tenant’s pool. Shows how many warm VMs are available and lists each one by name and task queue.

Synopsis

murmur pool status [flags]

Pool commands run from your laptop only. They are not available on agent VMs.

Arguments

Name	Type	Required	Description
`--workspace`	string	no	Workspace name. Overrides the value from `murmur.yaml`.

Output

The output starts with a warm: count line, followed by one indented line per warm VM.

Field	Description
`warm`	Total number of warm VMs in the pool.
Per-VM line	The VM’s instance name and task queue.

Examples

Pool with warm VMs

murmur pool status

warm: 3
  warm: murmur-a1b2c3d4 (murmur-a1b2c3d4)
  warm: murmur-e5f6g7h8 (murmur-e5f6g7h8)
  warm: murmur-i9j0k1l2 (murmur-i9j0k1l2)

Three VMs are pre-booted and ready. The next murmur spawn claims one instantly.

Empty pool

murmur pool status

warm: 0

No warm VMs are available. The next murmur spawn triggers a cold boot, which takes longer. Use murmur pool up to ensure the pool is running and backfilling.

Errors

Code	Meaning	What to do
`UNAUTHENTICATED`	Identity token is missing or expired.	Run `murmur auth` or check your `murmur.local.yaml` configuration.
`PERMISSION_DENIED`	Your role does not have `pool-config.read` permission.	Ask a tenant admin to grant you the required permission.
(exit error)	`pool commands are not supported on VMs`	Run this command from your laptop, not from an agent VM.

Pools — concept overview
pool-config — catalog resource that controls pool capacity limits
murmur pool up — ensure the pool is running
murmur pool flush — destroy warm VMs so the pool replenishes
murmur spawn — start an agent (claims a warm VM from the pool)
murmur ls — list running agents

Getting Started

Core Concepts

Guides

murmur pool status

Synopsis

Arguments

Output

Examples

Pool with warm VMs

Empty pool

Errors

​Synopsis

​Arguments

​Output

​Examples

​Pool with warm VMs

​Empty pool

​Errors

​Related

Synopsis

Arguments

Output

Examples

Pool with warm VMs

Empty pool

Errors

Related