zester basket
Query basket data. Basket is Zester's mechanism for peels to publish structured data that other peels or the master can consume -- enabling peel-to-peel data sharing.
Synopsis
zester basket <subcommand> [flags]Subcommands
basket get
Query basket data from peels matching a target expression.
Synopsis
zester basket get <target> <function>Description
Resolves the target expression to a set of peel IDs (using the same
auto-detection as state.apply), then queries the basket KV bucket for each
peel's data under the specified function key.
Basket keys are stored in the format <peel-id>.<function> in the NATS KV
basket bucket.
Arguments
| Argument | Required | Description |
|---|---|---|
<target> | Yes | Target expression selecting peels |
<function> | Yes | Basket function name to query |
Flags
This command has no subcommand-specific flags. See global flags.
Output Columns
| Column | Description |
|---|---|
PEEL | Peel ID |
VALUE | Basket value (or (no data) if not available) |
Examples
Get IP addresses from web servers
zester basket get 'web*' network.ip_addrsPEEL VALUE
web-01 10.0.1.10
web-02 10.0.1.11
web-03 10.0.1.12Get data from specific peels
zester basket get 'L@db-01,db-02' postgres.versionPEEL VALUE
db-01 15.4
db-02 15.4Missing basket data
zester basket get 'web*' nonexistent.functionPEEL VALUE
web-01 (no data)
web-02 (no data)
web-03 (no data)No target matches
zester basket get 'nonexistent*' any.functionNo peels matched the target expression.basket list
List all basket function keys available for a specific peel.
Synopsis
zester basket list <peel>Description
Scans the basket KV bucket for all keys prefixed with <peel-id>. and
displays the function portion of each key (everything after the first dot).
Arguments
| Argument | Required | Description |
|---|---|---|
<peel> | Yes | Peel ID to list basket keys for |
Flags
This command has no subcommand-specific flags. See global flags.
Examples
List basket keys
zester basket list web-01FUNCTION
network.ip_addrs
network.interfaces
disk.usage
cpu.loadNo basket data
zester basket list unknown-peelNo basket data found for peel unknown-peel.