zester kv fact
Read peel facts from the NATS KV cache. Facts are key-value data reported by each peel, including system information like OS, architecture, CPU count, memory, and any custom facts configured on the peel.
KV cache vs direct query
zester kv fact get reads from the NATS KV facts bucket (no round-trip to
the peel). To query a peel directly, use zester '<peel>' facts.get <key>
or zester '<peel>' facts.items.
Synopsis
zester kv fact get <peel> [key]Description
Fetches the full facts map for the specified peel from the NATS KV facts bucket. If a key argument is provided, only the value at that key path is returned.
The key argument supports dot notation to traverse nested fact structures.
For example, os.family looks up facts["os"]["family"].
Arguments
| Argument | Required | Description |
|---|---|---|
<peel> | Yes | Peel ID to query |
[key] | No | Dot-notation fact key to filter |
Flags
This command has no subcommand-specific flags. See global flags.
Output
Output is formatted as indented JSON.
Examples
Get all facts
zester kv fact get web-01{
"os": "ubuntu",
"os_family": "debian",
"arch": "amd64",
"cpu_count": 8,
"memory_gb": 32,
"hostname": "web-01.example.com",
"roles": [
"web",
"api"
]
}Get a specific fact
zester kv fact get web-01 os"ubuntu"Get a nested fact using dot notation
zester kv fact get web-01 network.interfaces.eth0.ip"10.0.1.42"Fact key not found
zester kv fact get web-01 nonexistent.keyError: fact key "nonexistent.key" not found for peel web-01Peel not found
zester kv fact get unknown-peelError: get facts for unknown-peel: key not found