NAME

IO::K8s::PrometheusOperator::V1::ThanosSpec - thanos defines the configuration of the optional Thanos sidecar.

VERSION

version 1.108

additionalArgs

additionalArgs allows setting additional arguments for the Thanos container. The arguments are passed as-is to the Thanos container which may cause issues if they are invalid or not supported the given Thanos version. In case of an argument conflict (e.g. an argument which is already set by the operator itself) or when providing an invalid argument, the reconciliation will fail and an error will be logged.

baseImage

baseImage is deprecated: use 'image' instead.

blockSize

blockSize controls the size of TSDB blocks produced by Prometheus. The default value is 2h to match the upstream Prometheus defaults.

WARNING: Changing the block duration can impact the performance and efficiency of the entire Prometheus/Thanos stack due to how it interacts with memory and Thanos compactors. It is recommended to keep this value set to a multiple of 120 times your longest scrape or rule interval. For example, 30s * 120 = 1h.

getConfigInterval

getConfigInterval defines how often to retrieve the Prometheus configuration.

getConfigTimeout

getConfigTimeout defines the maximum time to wait when retrieving the Prometheus configuration.

grpcListenLocal

grpcListenLocal defines when true, the Thanos sidecar listens on the loopback interface instead of the Pod IP's address for the gRPC endpoints.

It has no effect if `listenLocal` is true.

grpcServerTlsConfig

grpcServerTlsConfig defines the TLS parameters for the gRPC server providing the StoreAPI.

Note: Currently only the `minVersion`, `caFile`, `certFile`, `keyFile`, `cipherSuites` and `curves` fields are supported.

httpListenLocal

httpListenLocal when true, the Thanos sidecar listens on the loopback interface instead of the Pod IP's address for the HTTP endpoints.

It has no effect if `listenLocal` is true.

image

image defines the container image name for Thanos. If specified, it takes precedence over the `spec.thanos.baseImage`, `spec.thanos.tag` and `spec.thanos.sha` fields.

Specifying `spec.thanos.version` is still necessary to ensure the Prometheus Operator knows which version of Thanos is being configured.

If neither `spec.thanos.image` nor `spec.thanos.baseImage` are defined, the operator will use the latest upstream version of Thanos available at the time when the operator was released.

listenLocal

listenLocal is deprecated: use `grpcListenLocal` and `httpListenLocal` instead.

logFormat

logFormat for the Thanos sidecar.

logLevel

logLevel for the Thanos sidecar.

minTime

minTime defines the start of time range limit served by the Thanos sidecar's StoreAPI. The field's value should be a constant time in RFC3339 format or a time duration relative to current time, such as -1d or 2h45m. Valid duration units are ms, s, m, h, d, w, y.

objectStorageConfig

objectStorageConfig defines the Thanos sidecar's configuration to upload TSDB blocks to object storage.

More info: https://thanos.io/tip/thanos/storage.md/

objectStorageConfigFile takes precedence over this field.

objectStorageConfigFile

objectStorageConfigFile defines the Thanos sidecar's configuration file to upload TSDB blocks to object storage.

More info: https://thanos.io/tip/thanos/storage.md/

This field takes precedence over objectStorageConfig.

readyTimeout

readyTimeout defines the maximum time that the Thanos sidecar will wait for Prometheus to start.

resources

resources defines the resources requests and limits of the Thanos sidecar.

sha

sha is deprecated: use 'image' instead. The image digest can be specified as part of the image name.

tag

tag is deprecated: use 'image' instead. The image's tag can be specified as as part of the image name.

tracingConfig

tracingConfig defines the tracing configuration for the Thanos sidecar.

`tracingConfigFile` takes precedence over this field.

More info: https://thanos.io/tip/thanos/tracing.md/

This is an *experimental feature*, it may change in any upcoming release in a breaking way.

tracingConfigFile

tracingConfigFile defines the tracing configuration file for the Thanos sidecar.

This field takes precedence over `tracingConfig`.

More info: https://thanos.io/tip/thanos/tracing.md/

This is an *experimental feature*, it may change in any upcoming release in a breaking way.

version

version of Thanos being deployed. The operator uses this information to generate the Prometheus StatefulSet + configuration files.

If not specified, the operator assumes the latest upstream release of Thanos available at the time when the version of the operator was released.

volumeMounts

volumeMounts allows configuration of additional VolumeMounts for Thanos. VolumeMounts specified will be appended to other VolumeMounts in the 'thanos-sidecar' container.

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/pplu/io-k8s-p5/issues.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHORS

  • Torsten Raudssus <getty@cpan.org>

  • Jose Luis Martinez Torres <jlmartin@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2018-2026 by Jose Luis Martinez Torres <jlmartin@cpan.org>.

This is free software, licensed under:

The Apache License, Version 2.0, January 2004