Releasing soon Vigo is in alpha and closing in on its first stable release. Expect breaking changes between releases until then — we're looking for testing partners with meaningful fleets across diverse architectures. Learn more →

vigocli traits livequery

Query trait values from targeted envoys in real time, with cached fallback for offline nodes.

Usage

vigocli traits livequery <trait-path> --target <spec> [flags]

Flags

Flag Short Default Description
--target Target spec: hostname, glob (*.web.*), UUID, or trait filter (os.distro=ubuntu) (required)
--timeout 10 Query timeout in seconds

Examples

Query OS distribution across web servers

vigocli traits livequery os.distro --target "*.web.*"

Query:     os.distro
Responded: 3  Timed out: 0  Offline: 1

HOSTNAME              VALUE     STATUS
web-01.example.com    ubuntu    responded
web-02.example.com    ubuntu    responded
web-03.example.com    debian    responded

HOSTNAME              VALUE     STATUS
web-04.example.com    ubuntu    offline cached 2026-03-12 18:00

Query memory across Debian hosts

vigocli traits livequery hardware.memory_mb --target "os.family=debian"

Query:     hardware.memory_mb
Responded: 5  Timed out: 0  Offline: 0

HOSTNAME              VALUE   STATUS
web-01.example.com    8192    responded
web-02.example.com    8192    responded
db-01.internal.net    32768   responded
db-02.internal.net    32768   responded
app-01.example.com    16384   responded

Query with timeout handling

vigocli traits livequery os.version --target "*.web.*" --timeout 5

Query:     os.version
Responded: 2  Timed out: 1  Offline: 0

HOSTNAME              VALUE   STATUS
web-01.example.com    24.04   responded
web-02.example.com    24.04   responded

HOSTNAME              STATUS
web-03.example.com    timed_out

Related

  • envoys -- view traits for a specific envoy
  • inventory -- query envoys by traits
  • task -- dispatch ad-hoc commands