Module inspect

Source
Expand description

CLI introspection tools for persist

Structsยง

BatchPartOutput ๐Ÿ”’
BatchPartUpdate ๐Ÿ”’
BlobArgs
Arguments for commands that run only against the blob store.
BlobBatchPartArgs
Arguments for viewing contents of a batch part
BlobCounts ๐Ÿ”’
D ๐Ÿ”’
InspectArgs
Commands for read-only inspection of persist state
K ๐Ÿ”’
The following is a very terrible hack that no one should draw inspiration from. Currently State is generic over <K, V, T, D>, with KVD being represented as phantom data for type safety and to detect persisted codec mismatches. However, reading persisted States does not require actually decoding KVD, so we only need their codec names to match, not the full types. For the purposes of persistcli inspect, which only wants to read the persistent data, we create new types that return static Codec names, and rebind the names if/when we get a CodecMismatch, so we can convince the type system and our safety checks that we really can read the data.
O ๐Ÿ”’
PrettyBytes ๐Ÿ”’
StateRollupArgs
Arguments for viewing the state rollup of a shard
T ๐Ÿ”’
UnreferencedBlobs ๐Ÿ”’
V ๐Ÿ”’

Enumsยง

Command ๐Ÿ”’
Individual subcommands of inspect

Staticsยง

FAKE_OPAQUE_CODEC ๐Ÿ”’
KVTD_CODECS ๐Ÿ”’

Functionsยง

blob_batch_part
Fetches the updates in a blob batch part
blob_counts
Fetches the blob count for given path
blob_usage
Returns information about blob usage for a shard
consolidated_size ๐Ÿ”’
fetch_latest_state
Fetches the current state of a given shard
fetch_state_diffs
Fetches each state in a shard
fetch_state_rollup
Fetches a state rollup of a given shard. If the seqno is not provided, choose the latest; if the rollup id is not provided, discover it by inspecting state.
fetch_state_rollups
Fetches the state from all known rollups of a given shard
run
Runs the given read-only inspect command.
shard_stats
Rummages through S3 to find the latest rollup for each shard, then calculates summary stats.
unreferenced_blobs
Fetches the unreferenced blobs for given environment