Skip to main content

The console data volume

The Anywhere console keeps its own state on a persistent volume of its own, separate from any cluster it manages and from the disks those clusters run on. Back up and restore covers the data in a PhoenixAI cluster. It does not cover this volume.

What is on it

HoldsWhy it matters
Usage ledgerAppend-only, tamper-evident record of metered usage. The basis of billing
Query historyCollected query records and their profiles, subject to the retention window
Saved commands and presetsCatalogue entries created in this deployment
Session snapshotWritten only during a graceful restart

The usage ledger is the one thing here that cannot be reconstructed. It can be exported as a file and kept independently of the volume — see the Usage page in the Anywhere Console.

Query history ages out on its own. Saved commands and exec presets persist until you delete them, and would need re-creating if the volume were lost.

It survives an uninstall

The volume is retained deliberately, so removing the release does not discard billing history. Its name derives from the release name, so reinstalling under that same name reclaims it. Setting persistence.existingClaim points Anywhere at a volume you name yourself instead.

Sizing

Query history is what grows. Volume of retained records depends on workload and on the slow-query threshold in force.

Two things trim it: the retention period, and a watermark that prunes the oldest records when the volume runs low on space. Neither touches the usage ledger, which is never removed automatically.

Capturing every query on a cluster serving 100 queries per second produces millions of rows and hundreds of gigabytes of query text per day. At the default threshold only slow and failed queries are kept, which is a small fraction of that. The threshold and the retention period are the two controls.