| title | pg hardstorage fleet search | ||
|---|---|---|---|
| description | CLI reference for the pg hardstorage fleet search command. | ||
| tags |
|
Search every deployment's manifests in one repo
Walk every deployment's committed manifests in the given repository and return those matching the AND-of-key:value query.
Supported keys: deployment: tenant: type:<full|incremental> pg_version: timeline: since:<7d|24h|RFC3339> before:<7d|24h|RFC3339>
Examples: fleet search --query 'deployment:db1 type:full since:7d' --repo s3://... fleet search --query 'pg_version:17 timeline:3' --repo file:///srv/...
Tombstoned (soft-deleted) manifests are excluded.
pg_hardstorage fleet search --query '<expr>' --repo <url> [flags]
-h, --help help for search
--limit int cap on returned hits (default: no limit)
--query string key:value AND query (required)
--repo string repository URL — must already exist (required)
--airgapped airgapped: strict refuse outbound endpoints (LLM providers, sinks, OTLP collectors) outside loopback / RFC1918 / explicit airgap.allowlist. Also enabled by PG_HARDSTORAGE_AIRGAPPED=1 or airgapped: strict in the config file.
-c, --config string path to config file (default: XDG/FHS lookup)
--cpu-profile go tool pprof <path> write a pprof CPU profile to this path for the duration of the command (go tool pprof <path> to analyse). Off when empty.
--mem-profile string write a pprof heap profile to this path at command exit. Off when empty.
--no-color disable ANSI color in text output
--on-error-llm on a structured-error failure, drop into the matching LLM helper skill (auto_on_error trigger). Also enabled by PG_HARDSTORAGE_ON_ERROR_LLM=1.
--otel-endpoint string OpenTelemetry OTLP/HTTP endpoint (e.g. http://otel-collector:4318); empty disables tracing
--otel-stdout also export OpenTelemetry traces to stderr (useful for dev)
-o, --output string output format: text|json|ndjson|yaml|template|csv|markdown|html|tap|junit|pdf (default: text on TTY, json off-TTY)
--profile-port go tool pprof http://127.0.0.1:6060/debug/pprof/profile?seconds=30 if non-zero, expose net/http/pprof on 127.0.0.1:<port> for live profiling of long-running commands (e.g. go tool pprof http://127.0.0.1:6060/debug/pprof/profile?seconds=30). Off when zero.
-q, --quiet suppress non-essential output
--template string Go text/template applied when --output template (or implied if --template is set without --output)
- pg_hardstorage fleet - Fleet-wide queries across deployments and backups