The bucket component of Thanos is a set of commands to inspect data in object storage buckets. It is normally run as a stand alone command to aid with troubleshooting.
Example:
$ thanos bucket verify --objstore.config-file=bucket.yml
The content of bucket.yml:
type: GCS
config:
bucket: example-bucket
Bucket can be extended to add more subcommands that will be helpful when working with object storage buckets by adding a new command within /cmd/thanos/bucket.go
usage: thanos bucket [<flags>] <command> [<args> ...]
inspect metric data in an object storage bucket
Flags:
-h, --help Show context-sensitive help (also try --help-long and
--help-man).
--version Show application version.
--log.level=info Log filtering level.
--log.format=logfmt Log format to use.
--gcloudtrace.project=GCLOUDTRACE.PROJECT
GCP project to send Google Cloud Trace tracings to.
If empty, tracing will be disabled.
--gcloudtrace.sample-factor=1
How often we send traces (1/<sample-factor>). If 0 no
trace will be sent periodically, unless forced by
baggage item. See `pkg/tracing/tracing.go` for
details.
--objstore.config-file=<bucket.config-yaml-path>
Path to YAML file that contains object store
configuration.
--objstore.config=<bucket.config-yaml>
Alternative to 'objstore.config-file' flag. Object
store configuration in YAML.
--objstore-backup.config-file=<bucket.config-yaml-path>
Path to YAML file that contains object store-backup
configuration.
--objstore-backup.config=<bucket.config-yaml>
Alternative to 'objstore-backup.config-file' flag.
Object store-backup configuration in YAML.
Subcommands:
bucket verify [<flags>]
verify all blocks in the bucket against specified issues
bucket ls [<flags>]
list all blocks in the bucket
bucket verify is used to verify and optionally repair blocks within the specified bucket.
Example:
$ thanos bucket verify --gcs.bucket example-bucket
usage: thanos bucket verify [<flags>]
verify all blocks in the bucket against specified issues
Flags:
-h, --help Show context-sensitive help (also try --help-long and
--help-man).
--version Show application version.
--log.level=info Log filtering level.
--log.format=logfmt Log format to use.
--gcloudtrace.project=GCLOUDTRACE.PROJECT
GCP project to send Google Cloud Trace tracings to.
If empty, tracing will be disabled.
--gcloudtrace.sample-factor=1
How often we send traces (1/<sample-factor>). If 0 no
trace will be sent periodically, unless forced by
baggage item. See `pkg/tracing/tracing.go` for
details.
--objstore.config-file=<bucket.config-yaml-path>
Path to YAML file that contains object store
configuration.
--objstore.config=<bucket.config-yaml>
Alternative to 'objstore.config-file' flag. Object
store configuration in YAML.
--objstore-backup.config-file=<bucket.config-yaml-path>
Path to YAML file that contains object store-backup
configuration.
--objstore-backup.config=<bucket.config-yaml>
Alternative to 'objstore-backup.config-file' flag.
Object store-backup configuration in YAML.
-r, --repair attempt to repair blocks for which issues were
detected
-i, --issues=index_issue... ...
Issues to verify (and optionally repair). Possible
values: [duplicated_compaction index_issue
overlapped_blocks]
--id-whitelist=ID-WHITELIST ...
Block IDs to verify (and optionally repair) only. If
none is specified, all blocks will be verified.
Repeated field
bucket ls is used to list all blocks in the specified bucket.
Example:
$ thanos bucket ls -o json --gcs.bucket example-bucket
usage: thanos bucket ls [<flags>]
list all blocks in the bucket
Flags:
-h, --help Show context-sensitive help (also try --help-long and
--help-man).
--version Show application version.
--log.level=info Log filtering level.
--log.format=logfmt Log format to use.
--gcloudtrace.project=GCLOUDTRACE.PROJECT
GCP project to send Google Cloud Trace tracings to.
If empty, tracing will be disabled.
--gcloudtrace.sample-factor=1
How often we send traces (1/<sample-factor>). If 0 no
trace will be sent periodically, unless forced by
baggage item. See `pkg/tracing/tracing.go` for
details.
--objstore.config-file=<bucket.config-yaml-path>
Path to YAML file that contains object store
configuration.
--objstore.config=<bucket.config-yaml>
Alternative to 'objstore.config-file' flag. Object
store configuration in YAML.
--objstore-backup.config-file=<bucket.config-yaml-path>
Path to YAML file that contains object store-backup
configuration.
--objstore-backup.config=<bucket.config-yaml>
Alternative to 'objstore-backup.config-file' flag.
Object store-backup configuration in YAML.
-o, --output="" Format in which to print each block's information.
May be 'json' or custom template.