Project: Thanos (Observability and Analysis / Observability)
File: CHANGELOG.md

All notable changes to this project will be documented in this file. The format is based on and this project adheres to . NOTE: As semantic versioning states all 0.y.z releases can contain breaking changes in API (flags, grpc API, any backward compatibility) We use breaking :warning: to mark changes that are not backward compatible (relates only to v0.y.z releases.) Sidecar: wait for prometheus on startup Query: fixing exemplars proxy when querying stores with multiple tenants. Dependency: Update minio-go to v7.0.70 which includes support for EKS Pod Identity. Tracing: allow specifying resource attributes for the OTLP configuration. Store Gateway: log request ID in request logs. Compactor: do not vertically compact downsampled blocks. Such cases are now marked with `no-compact-mark.json`. Fixes panic `panic: unexpected seriesToChunkEncoder lack of iterations`. Store Gateway: Fix lazy expanded postings with 0 length failed to be cached. Receive: race condition in handler Close() when stopped early Documentation: fix broken helm installation instruction Store, Compact: Revert the recursive block listing mechanism introduced in https://github.com/thanos-io/thanos/pull/6474 and use the same strategy as in 0.31. Introduce a `--block-discovery-strategy` flag to control the listing strategy so that a recursive lister can still be used if the tradeoff of slower but cheaper discovery is preferred. Store Gateway: Fix lazy expanded postings estimate base cardinality using posting group with remove keys. Receive/MultiTSDB: Do not delete non-uploaded blocks Query: Fix merging of query analysis Query-frontend: Add Redis username to the client configuration. Store Gateway: Fix lazy expanded postings caching partial expanded postings and bug of estimating remove postings with non existent value. Added `PromQLSmith` based fuzz test to improve correctness. Compact: Don't halt due to overlapping sources when vertical compaction is enabled Query: Fix Internal Server Error unknown targetHealth: "unknown" when trying to open the targets page. Receive: Fix RemoteWriteAsync was sequentially executed causing high latency in the ingestion path. Query: fixing dedup iterator when working on mixed sample types. Query Frontend: show warnings from downstream queries. Store: Batch TSDB Infos for blocks. Store Gateway: fix index header reader `PostingsOffsets` returning wrong values. Receive: Add tenant globbing support to hashring config Tracing: added missing sampler types Downsample: retry objstore related errors Rule: add flag `--query.enable-x-functions` to allow usage of extended promql functions (xrate, xincrease, xdelta) in loaded rules Query UI: Tenant input box added to the Query UI, in order to be able to specify which tenant the query should use. Query UI: Only show tenant input box when query tenant enforcement is enabled Query: Add `--query.mode=distributed` which enables the new distributed mode of the Thanos query engine. Reloader: Add support for watching and decompressing Prometheus configuration directories Query: Add `--selector.relabel-config` and `--selector.relabel-config-file` flags which allows scoping the Querier to a subset of matched TSDBs. UI: Showing Block Size Stats Receive: Split remote-write HTTP requests via tenant labels of series Query UI: Show peak/total samples in query analysis *: Adding User-Agent to request logs Receive: add `--remote-write.client-tls-secure` and `--remote-write.client-tls-skip-verify` flags to stop relying on grpc server config to determine grpc client secure/skipVerify. *: mark as not queryable if status is not ready Considering the `X-Forwarded-For` header for the remote address in the logs. Store: Use loser trees for merging results Rule: Change default Alertmanager API version to v2. Rule: Do not turn off ruler even if resolving fails Automatic detection of memory limits and configure GOMEMLIMIT to match. Compact: breaking :warning: Replace group with resolution in compact downsample metrics to avoid cardinality explosion with large numbers of

Query|Receiver: Do not log full request on ProxyStore by default. *: Bump gRPC to 1.57.2 Query Frontend: queries with negative offset should check whether it is cacheable or not. Sidecar: fix labels returned by 'api/v1/series' in presence of conflicting external and inner labels. Rule: Fix spacing error in URL. Stores: fix label values edge case when requesting external label values with matchers Stores: fix file path bug for minio v7.0.61 Query: Add `query.enable-tenancy` & `query.tenant-label-name` options to allow enforcement of tenancy on the query path, by injecting labels into queries (uses prom-label-proxy internally). Receive: Added a new flag for maximum retention bytes. Objstore: Bump `objstore` which adds support for Azure Workload Identity. Sidecar: Added `--reloader.method` to support configuration reloads via SIHUP signal. Store Gateway: Support float native histogram. Index Cache: Support tracing for fetch APIs. Ruler: Added `keepfiringfor` field in alerting rule. Store Gateway: Apply series limit when streaming series for series actually matched if lazy postings is enabled. Store Gateway: Added `--store.index-header-lazy-download-strategy` to specify how to lazily download index headers when lazy mmap is enabled. Query Frontend: breaking :warning: Add tenant label to relevant exported metrics. Note that this change may cause some pre-existing custom dashboard queries to be incorrect due to the added label. Query|Query Frontend: Add new `--query-frontend.enable-x-functions` flag to enable experimental extended functions. Tools: Add upload-block command to upload blocks to object storage. Cache: Added `setasynccircuitbreaker*` to utilize the circuit breaker pattern for dynamically thresholding asynchronous set operations. Store: breaking :warning: Changed `--sync-block-duration` default 3m to 15m. : breaking :warning:* Removed experimental query pushdown feature to simplify query path. This feature has had high complexity for too little benefits. The responsibility for query pushdown will be moved to the distributed mode of the new 'thanos' promql engine. Store Gateway: fix `matchersToPostingGroups` label values variable got shadowed bug. Objstore: Bump `objstore` which adds support for Azure Workload Identity. Query Frontend: Support vertical sharding binary expression with metric name when no matching labels specified. Ruler: Support configuration flag that allows customizing template for alert message. Query Frontend: Added TLS support in `--query-frontend.downstream-tripper-config` and `--query-frontend.downstream-tripper-config-file` Query Frontend: Support documented auto discovery for memcached Store Gateway: Added `thanosstoreindexcachefetchdurationseconds` histogram for tracking latency of fetching data from index cache. Store: breaking :warning: Add tenant label to relevant exported metrics. Note that this change may cause some pre-existing dashboard queries to be incorrect due to the added label. / Query: Add command line arguments for configuring tenants and forward tenant information to Store Gateway. Index Cache: Add `enabled_items` to index cache config to selectively cache configured items. Available item types are `Postings`, `Series` and `ExpandedPostings`. Index Cache: Add `ttl` to control the ttl to store items in remote index caches like memcached and redis. Query: breaking :warning: Add tenant label to relevant exported metrics. Note that this change may cause some pre-existing custom dashboard queries to be incorrect due to the added label. Store: Add `thanosbucketstoreindexheaderdownloaddurationseconds` and `thanosbucketstoreindexheaderloaddurationseconds` metrics for tracking latency of downloading and initializing the index-header. Receive: Change write log level from warn to info. mixin(Rule): breaking :warning: Fixed the mixin rules with duplicate names and updated the promtool version from v0.37.0 to v0.47.0 *: Bump prometheus to v0.47.2-0.20231006112807-a5a4eab679cc Receive: the exported HTTP metrics now uses the specified default tenant for requests where no tenants are found. Remove deprecated `--log.request.decision` flag. We now use `--request.logging-config` to set logging decisions. : Build with Go 1.21 and bump golang.org/x/net to v0.17 for addressing Receive: head series limiter should not run if no head series limit is

Store: fix prometheus store label values matches for external labels Objstore: Upgrade with fixes and . Store: Fix matching bug when using empty alternative in regex matcher, for example (a||b). Store: Fix block deduplication Store: Series responses should always be sorted Query: Propagate instant query warnings in distributed execution mode. *: Update Prometheus to 2.46.1. *: Optimize iterations on GCS buckets by requesting only object names. Objstore: Update objstore to latest version which adds a new metric regarding uploaded TSDB bytes Store: Fix race when iterating blocks Store: Record stats even on ExpandPostings error Store: Fix forgotten field in store stats merge Store: Fix postings reader short reads to address nil postings bug Store: Fix error handling in decodePostings Store: Fix ignored error in postings Store: Fix bufio pool handling Store: Fix mutable stringset memory usage *: Update Prometheus to 2.46.1. Receive: make tenant stats limit configurable Receive: add az-aware replication support for Ketama algorithm Tracing: tracing in OTLP support configuring service_name. Store: add flag `bucket-web-label` to select the label to use as timeline title in web UI Receive: add flag `tsdb.too-far-in-future.time-window` to prevent clock skewed samples to pollute TSDB head and block all valid incoming samples. Mixin: Allow specifying an instance name filter in dashboards Receiver: Add hidden flag `--receive-forward-max-backoff` to configure the max backoff for forwarding requests. Receive: Allow specifying tenant-specific external labels in Router Ingestor. Store: Expose store gateway query stats in series response hints. Index Cache: Cache expanded postings. Compact: Compactor will set `index_stats` in `meta.json` file with max series and chunk size information. Mixin (Receive): add limits alerting for configuration reload and meta-monitoring. Mixin (Receive): add alert for tenant reaching head series limit. Index Cache: Add histogram metric `thanosstoreindexcachestoreddatasize_bytes` for item size. Thanos ruler: add flag to optionally disable adding Thanos params when querying metrics Tools: Add min and max compactions range flags to `bucket replicate` command. Store: Add `thanosbucketstorechunkrefetches_total` metric to track number of chunk refetches. Query: Add Thanos logo in navbar Query: Add ability to switch between `thanos` and `prometheus` engines dynamically via UI and API. Query: Add ability to generate SQL-like query explanations when `thanos` engine is used. Compact and Bucket: Add `--disable-admin-operations` flag in Compactor UI and Bucket UI *: Change the engine behind `ContentPathReloader` to be completely independent of any filesystem concept. This effectively fixes this configuration reload when used with Kubernetes ConfigMaps, Secrets, or other volume mounts. Store: fix crash when computing set matches from regex pattern Receive: increased log level for failed uploads to `error` query-frontend: return JSON formatted errors for invalid PromQL expression in the split by interval middleware. Store: fix error handling on limits. Receiver: fix off by one in multitsdb flush that will result in empty blocks if the head only contains one sample Exemplar OTel: Fix exemplar for otel to use traceId instead of spanId and sample only if trace is sampled Receive: Remove the shipper once a tenant has been pruned. Receiver: removed hard-coded value of EnableExemplarStorage flag and set it according to max-exemplar value. mixin(Receive): Fix tenant series received dashboard widget. mixin(Store): handle ResourceExhausted as a non-server error. As a consequence, this error won't contribute to Store's grpc errors alerts. Receive: Fix segfault in `LabelValues` during head compaction. Tracing: tracing in OTLP utilize the OTELTRACESSAMPLER env variable Store: Fix inconsistent error for series limits. Cache/Redis: Upgrade `rueidis` to v1.0.2 to to improve error handling while shrinking a redis cluster. Store: return gRPC resource exhausted error for byte

*: Fix double-counting bug in httprequestduration metric Report gRPC connnection errors in the logs. Reloader: Use timeout for initial apply. Store Gateway: Remove `memWriter` from `fileWriter` to reduce memory usage when sync index headers. Thanos compact: respect block-files-concurrency setting when downsampling Query Frontend: fix bugs in vertical sharding `without` and `union` function to allow more queries to be shardable. *: Fix internal label deduplication bug, by resorting store response set. Rule: Fix panic when calling API `/api/v1/rules?type=alert`. compact: fix data corruption with "invalid size" error during downsample Compact: breaking :warning: Replace group with resolution in compact metrics to avoid cardinality explosion on compact metrics for large numbers of groups. Receiver: Make ketama hashring fail early when configured with number of nodes lower than the replication factor. Query-Frontend: Disable absent and absentovertime for vertical sharding. Query-Frontend: Disable scalar for vertical sharding. breaking :warning: Change default user id in container image from 0(root) to 1001 Conditionally generate debug messages in ProxyStore to avoid memory bloat. mixins: Add code/grpc-code dimension to error widgets. mixin(Rule): Add rule evaluation failures to the Rule dashboard. Store: added and start using streamed snappy encoding for postings list instead of block based one. This leads to constant memory usage during decompression. This approximately halves memory usage when decompressing a postings list in index cache. Query Frontend: breaking :warning: Add experimental native histogram support for which we updated and aligned with the model, which is used for caching so a cache reset required. Receiver: changed default max backoff from 30s to 5s for forwarding requests. Can be configured with `--receive-forward-max-backoff`. : breaking :warning:* Use histograms instead of summaries for instrumented handlers. Logging: Avoid expensive log.Valuer evaluation for disallowed levels. Query: Add +Inf bucket to query duration metrics Store: Check context error when expanding postings. Index Cache: Change postings cache key to include the encoding format used so that older Thanos versions would not try to decode it during the deployment of a new version. Store: breaking :warning: Rename `thanosbucketstorecachedseriesfetchdurationseconds` to `thanosbucketstoreseriesfetchdurationseconds` and `thanosbucketstorecachedpostingsfetchdurationseconds` to `thanosbucketstorepostingsfetchdurationseconds`. Store/Compact: Reduce a large amount of `Exists` API calls against object storage when synchronizing meta files in favour of a recursive `Iter` call. Objstore: Bump minio-go to v7.0.61. *: Unify gRPC flags for all servers. Query: Support unicode external label truncation. Query: Only keep name in UI `store_matches` param. *: Bump `go4.org/intern` to fix Go 1.21 builds. *: Remove unnecessary configuration reload from `ContentPathReloader` and improve its tests. Receive: Remove duplicated `gopkg.in/fsnotify.v1` dependency. *: Remove unmaintained `gzip` dependency. Cache/Redis: add support for Redis Sentinel via new option `master_name`. *: Add counter metric `gatequeriestotal` to gate. Receiver: Add experimental string interning in writer. Can be enabled with a hidden flag `--writer.intern`. Store: Support disabling cache index header file by setting `--no-cache-index-header`. When toggled, Stores can run without needing persistent disks. Receive: Allow setting hashing algorithm per tenant in hashrings config. *: Add histogram metrics `thanosstoreserverseriesrequested` and `thanosstoreserverchunksrequested` to all Stores. *: Allow configuring series and sample limits per `Series` request for all Stores. Objstore: Support S3 session token. Query: Add experimental support for load balancing across multiple Store endpoints. Query-frontend: Add `traceID` to slow query detected log line. Query-frontend: Add `remoteuser` (from http basic auth) and `remoteaddr` to slow query detected log line. Receive: Allow tenants to be configured with unlimited active series by setting headserieslimit to 0. Sidecar: Loads TLS certificate during startup. Receive: Mark out-of-window errors as conflict when out-of-window samples ingestion is used. Store: Re-try bucket store initial sync upon failure. Receive: Fix panic when querying uninitialized

Query: Don't error when no stores are matched. Cache/Redis: Upgrade `rueidis` to v0.0.93 to fix potential panic when the client-side caching is disabled. Mixins(Rule): Fix expression for long rule evaluations. Receive: Deduplicate meta-monitoring queries for . Downsample: Repair of non-empty XOR chunks during 1h downsampling. Query Frontend: Fix vertical shardable instant queries do not produce sorted results for `sort`, `sort_desc`, `topk` and `bottomk` functions. Receive: Fix panic in head compaction under high query load. *: Upgrade Prometheus to v0.42.0. *: Upgrade Alertmanager dependency to v0.25.0. : Switch query-frontend to use client. Deleted `idletimeout`, `maxconnage`, `poolsize`, `minidleconns` fields as they are not used anymore. Tracing: Make sure rate limiting sampler is the default, as was the case in version pre-0.29.0. Rule: switch to miekgdns DNS resolver as the default one. Build with Go 1.20 Tools (replicate): Support all types of matchers to match blocks for replication. Change matcher parameter from string slice to a single string. Store: breaking :warning: Use Histograms instead of Summaries for bucket metrics. Tracing: fixed panic because of nil sampler Store Gateway: Fix store-gateway deadlock due to not close BlockSeriesClient Query Frontend/Store: fix duplicate metrics registration in Redis client NOTE: Querier's `query.promql-engine` flag enabling new PromQL engine is now unhidden. We encourage users to use new experimental PromQL engine for efficiency reasons. DNS: Fix miekgdns resolver LookupSRV to work with CNAME records. Query Frontend: Fixes @ modifier time range when splitting queries by interval. Query Frontend: `lookback_delta` param is now handled in query frontend. Query: Fixed bug of not showing query warnings in Thanos UI. Store: Fixed handling of debug logging flag. Rule: Stateless ruler support restoring `for` state from query API servers. The query API servers should be able to access the remote write storage. Query Frontend: Fixes some edge cases of query sharding analysis. Cache: Fixed redis client not respecting `SetMultiBatchSize` config value. Query: Fixed mint and maxt when selecting series for the `api/v1/series` HTTP endpoint. Store: `chunksfetchedduration` wrong calculation. Receive: Fixed ketama quorum bug that was could cause success response for failed replication. This also optimize heavily receiver CPU use. Store: Added metric `thanosbucketstorepostingssize_bytes` that shows the distribution of how many postings (in bytes) were needed for each Series() call in Thanos Store. Useful for determining limits. StoreAPI: Added `hash` field to series' chunks. Store gateway and receive implements that field and proxy leverage that for quicker deduplication. Store: Added a new flag `--store.grpc.downloaded-bytes-limit` that limits the number of bytes downloaded in each Series/LabelNames/LabelValues call. Use `thanosbucketstorepostingssize_bytes` for determining the limits. Receive: Added hidden flag `tsdb.memory-snapshot-on-shutdown` to enable experimental TSDB feature to snapshot on shutdown. This is intended to speed up receiver restart. Receive: Added parameter `--tsdb.out-of-order.time-window` to set time window for experimental out-of-order samples ingestion. Disabled by default (set to 0s). Please note if you enable this option and you use compactor, make sure you set the `--enable-vertical-compaction` flag, otherwise you might risk compactor halt. Query Frontend: Added support for vertical sharding `labelreplace` and `labeljoin` functions. Compact: Retry on sync metas error. Store: Added a few objectives for Store's data summaries (touched/fetched amount and sizes). They are: 50, 95, and 99 quantiles. Store: Added streaming retrival of series from object storage. Objstore: Support for authenticating to Swift using application credentials. Tools: Added new `no-downsample` marker to skip blocks when downsampling via `thanos tools bucket mark --marker=no-downsample-mark.json`. This will skip downsampling for blocks with the new

Tools: Added remove flag on bucket mark command to remove deletion, no-downsample or no-compact markers on the block Query: `thanosstorenodesgrpcconnections` now trimms `external_labels` label name longer than 1000 character. It also allows customizations in what labels to preserve using `query.conn-metric.label` flag. Mixin: Added query concurrency panel to Querier dashboard. Query Frontend: vertical query sharding supports subqueries. Cache: switch Redis client to . Rueidis is and provides . It is highly recommended to use it so that repeated requests for the same key would not be needed. : Upgrade Prometheus to v0.40.7 without implementing native histogram support. Querying native histograms will fail with `Error executing query: invalid chunk encoding "<unknown>"` and native histograms in write requests are ignored.* Receive: Compact tenant head after no appends have happened for 1.5 `tsdb.max-block-size`. Mixin: Added data touched type to Store dashboard. Compact: Retry on clean, partial marked errors when possible. Mixin: Remove noisy `ThanosReceiveTrafficBelowThreshold` alert. Receive: Log labels correctly in writer debug messages. Receive: Fix recreating already pruned tenants. Store: Upgrade minio-go/v7 to fix panic caused by leaked goroutines. Compact: Fix crash in GatherNoCompactionMarkFilter.NoCompactMarkedBlocks. Compact: Enable metadata cache. Compact: Fix missing duration log key. Query Frontend: Fixed sharding behaviour for vector matches. Now queries with sharding should work properly where the query looks like: `foo and without (lbl) bar`. Receive: Allow remote write request limits to be defined per file and tenant (experimental). Query: add `--grpc-compression` flag that controls the compression used in gRPC client. With the flag it is now possible to compress the traffic between Query and StoreAPI nodes - you get lower network usage in exchange for a bit higher CPU/RAM usage. Query Frontend: Add sharded queries metrics. `thanosfrontendshardingmiddlewarequeries_total` shows how many queries were sharded or not sharded. Query Frontend: Introduce new optional parameters (`query-range.min-split-interval`, `query-range.max-split-interval`, `query-range.horizontal-shards`) to implement more dynamic horizontal query splitting. Store: Add metric `thanosbucketstoreemptypostings_total` for number of empty postings when fetching series. Compactor: Support disable block viewer UI. Query Frontend/Store: Add support connecting to redis using TLS. Store: Support disable block viewer UI. Tracing: Add OpenTelemetry Protocol exporter. Objstore: Support specifying S3 storage class. Query: add metrics on how much data is being selected by downstream Store APIs. Receive: Reload tenant limit configuration on file change. Query Frontend: Added small LRU cache to cache query analysis results. Objstore: Update objstore to latest version which adds a new metric regarding uploaded TSDB bytes Global: replace `crypto/sha256` with `minio/sha256-simd` to make hash calculation faster in metadata and reloader packages. Query Frontend: cache vertical shards in query-frontend. Build with Go 1.19. Query: Use k-way merging for the proxying logic. The proxying sub-system now uses much less resources (~25-80% less CPU usage, ~30-50% less RAM usage according to our benchmarks). Reduces query duration by a few percent on queries with lots of series. Compact: update `--debug.accept-malformed-index` flag to apply to downsampling. Previously the flag only applied to compaction, and fatal errors would still occur when downsampling was attempted. Objstore: Update objstore to latest version which includes a refactored Azure Storage Account implementation with a new SDK. Store: Remove hardcoded labels in shard matcher. Query: Inject unshardable le label in query analyzer. Receive: Make active/head series limiting configuration per tenant by adding it to new limiting config. Tracing: Change Jaeger exporter from OpenTracing to OpenTelemetry. Options `RPC Metrics`, `Gen128Bit` and `Disabled` are now deprecated and won't have any effect when set :warning:. *: Upgrade Prometheus to v2.39.0. *: Upgrade Prometheus to v2.39.1. Store: Upgrade minio-go/v7 to fix panic caused by leaked goroutines. Receive: Handle exemplar storage errors as conflict error. Query: Set struct return by query API alerts same as prometheus

Query/Receiver: Fix querying exemplars from multi-tenant receivers. Query: Fix data race between Respond() and query/queryRange functions. Fixes . Sidecar: Added `--prometheus.getconfiginterval` and `--prometheus.getconfigtimeout` allowing to configure parameters for getting Prometheus config. HTTP metrics: export number of in-flight HTTP requests. Receive: Export metrics regarding size of remote write requests. Receive: Automatically remove stale tenants. Receive: Add new tenant metrics to example dashboard. Compact/Store: Added `--block-files-concurrency` allowing to configure number of go routines for downloading and uploading block files during compaction. Receive: Expose TSDB stats as metrics for all tenants. Compact: Added `--compact.blocks-fetch-concurrency` allowing to configure number of goroutines for downloading blocks during compactions. Query: Expose endpoint info timeout as a hidden flag `--endpoint.info-timeout`. Receive: Add per request limits for remote write. Added four new hidden flags `--receive.write-request-limits.max-size-bytes`, `--receive.write-request-limits.max-series`, `--receive.write-request-limits.max-samples` and `--receive.write-request-limits.max-concurrency` for limiting requests max body size, max amount of series, max amount of samples and max amount of concurrent requests. Receive: Meta-monitoring based active series limiting (experimental). This mode is only available if Receiver is in Router or RouterIngestor mode, and config is provided. Added four new hidden flags `receive.tenant-limits.max-head-series` for the max active series for the tenant, `receive.tenant-limits.meta-monitoring-url` for the Meta-monitoring URL, `receive.tenant-limits.meta-monitoring-query` for specifying the PromQL query to execute and `receive.tenant-limits.meta-monitoring-client` for specifying HTTP client configs. Query: Added `--query.active-query-path` flag, allowing the user to configure the directory to create an active query tracking file, `queries.active`, for different resolution. Receive: Added experimental support to enable chunk write queue via `--tsdb.write-queue-size` flag. Receive: Add support for gRPC compression with snappy. Receive: Validate labels in write requests. Mixin: Add Alert ThanosQueryOverload to Mixin. Query/Query Frontend: Implement vertical sharding at query frontend for range queries. Query Frontend: Support instant query vertical sharding. Compact: Skip erroneous empty non `*AggrChunk` chunks during 1h downsampling of 5m resolution blocks. Query: Support custom lookback delta from request in query api. Promclient: Ignore 405 status codes for Prometheus buildVersion requests. Azure: Reduce memory usage by not buffering file downloads entirely in memory. Update Prometheus deps to v2.36.2. Update Prometheus deps to v2.37.0. Store: Improve index header reading performance by sorting values first. Store: Filter external labels from matchers on LabelValues/LabelNames to improve performance. Receive: Fix deadlock on interrupt in routerOnly mode. Store: fix groupcache handling of slashes. Receive: Fix Ketama hashring replication consistency. Thanos Object Store: Add the `prefix` option to buckets. S3: Add option to force DNS style lookup. Cache: Add cache metrics to groupcache. Receive: Add relabeling support. Receive: Add support for consistent hashrings. Receive: Implement api/v1/status/tsdb. Query: Close() after using query. This should reduce bumps in memory allocations. Ruler: Breaking if you have not set this value (`--eval-interval`) yourself and rely on that value. :warning:. Change the default evaluation interval from 30s to 1 minute in order to be compliant with Prometheus alerting compliance specification: https://github.com/prometheus/compliance/blob/main/alert_generator/specification.md#executing-an-alerting-rule. Compactor: Remove an unused flag `--block-sync-concurrency`. Blocks: Use correct separators for filesystem paths and object storage paths respectively. Query: Ignore cache on queries with deduplication off. Reloader: Force trigger reload when config rollbacked. Query Frontend: Add `--query-frontend.forward-header` flag, forward headers to downstream querier. Querier: Expose Query and QueryRange APIs through GRPC. Add support for . Tracing: Chanced client for Stackdriver which deprecated "type: STACKDRIVER" in tracing YAML configuration. Use `type: GOOGLE_CLOUD` instead (`STACKDRIVER` type remains for backward compatibility). All: Upgraded the TLS version from TLS1.2 to TLS1.3. Rule: Add ruler labels as external labels in stateless ruler mode. Cache: Add timeout for groupcache's fetch operation. Tools: Thanos tools bucket downsample is now running continously. Tools: Bucket verify tool ignores blocks with deletion

Query: Promote negative offset and `@` modifier to stable features as per Prometheus . InfoAPI: Set store API unavailable when stores are not ready. Update Prometheus deps v2.33.5. DNS: Fix miekgdns resolver to work with CNAME records too. UI: Remove old Prometheus UI. Exemplars: Return empty data instead of `nil` if no data available. Store: Fix data race in advertised label set in bucket store. Ruler: Make ruler use the correct WAL directory. The binaries published with this release are built with Go1.17.8 to avoid . Rebuild Thanos for v0.25.1 with Go 1.17.8 Receive: option to extract tenant from client certificate Block: Do not upload DebugMeta files to obj store. Compactor, Store, Tools: Loading block metadata now only filters out duplicates within a source (or compaction group if replica labels are configured), and does so in parallel over sources. S3: Create an empty map in the case SSE-KMS is used and no KMSEncryptionContext is passed. Tools `tools bucket ls`: Added a new flag `exclude-delete` to exclude blocks marked for deletion. Compactor: Added tracing support for compaction. Compactor: Add flag --max-time / --min-time to filter blocks that are ready to be compacted. Tracing: add `traceid_128bit` support for jaeger. Query: add initial query pushdown for a subset of aggregations. Can be enabled with `--enable-feature=query-pushdown` on Thanos Query. Cache: Support redis cache backend. Store: Support tls_config configuration for the s3 minio client. Store: Support tls_config configuration for connecting with Azure storage. COS: Support `endpoint` configuration for vpc internal endpoint. Compactor: Adding minimum retention flag validation for downsampling retention. S3: Add a pure AWS-SDK auth for S3 storage. Query: Add matcher support to Rules endpoint. Bucket replicate: Added flag `--ignore-marked-for-deletion` to avoid replication of blocks with the deletion mark. Receive: Add tenant tag for tracing spans. Rule: Added ability to specify multiple remote write targets. Store: Add Groupcache as a cache backend. UI: Improve graph color. UI: Optimize Target, Alert and Service Discovery page and on each of them add a search bar. Store: Make `queryStats` log with human-readable format. UI: Filter block rows in bucket UI according to searched block ID. Prober: Decrease 'changing probe status' log spamming. Tracing: Fixing force tracing with Jaeger. Bucket verify: Fixed bug causing wrong number of blocks to be checked. UI: Show 'minus' icon and add tooltip when store min / max time is not available. Mixin: adhere to RFC 1123 compatible component naming. Tools `thanos bucket inspect`: Fix time formatting. COS: Support multi-part upload, fix upload issue when index size is larger than 5GB. Query: Set default times for `query_exemplars` API. Store: Fix race condition in filesystem client's `Delete()`. Build: Upgrade to `bingo v0.5.2` and implements `gotesplit` to allow for parallelism in our GitHub e2e tests. Tools `thanos bucket inspect`: Add flag `--output` to provide output method (table,csv,tsv). Query: breaking :warning: Add `--endpoint` flag to the querier. The `--store` flag will eventually be replaced. Azure: Support authentication using user-assigned managed identity Query: Add `exemplar.partial-response` flag to control partial response. Query: Add `enable-feature` flag to enable negative offsets and `@` modifier, similar to Prometheus. Query: Add cache name to tracing spans. Store: Add metric to capture timestamp of the last loaded block. S3: Add capability to use custom AWS STS Endpoint. Compactor: add `block-viewer.global.sync-block-timeout` flag to set the timeout of synchronization block metas. Compactor: added Prometheus metrics for tracking the progress of compaction and downsampling. UI: add mark deletion and no compaction to the Block UI. UI: add filter compaction level to the Block

Rule: add stateless mode to ruler according to https://thanos.io/tip/proposals-done/202005-scalable-rule-storage.md/. Continue https://github.com/thanos-io/thanos/pull/4250. Sidecar: add `--prometheus.http-client` and `--prometheus.http-client-file` flag for sidecar to connect Prometheus with basic auth or TLS. Query: add `--alert.query-url` which is used in the user interface for rules/alerts pages. By default the HTTP listen address is used for this URL. Mixin: Add Query Frontend Grafana dashboard. Compactor: added Prometheus metric for tracking the progress of retention. Query: Add `--endpoint-strict` flag to statically configure Thanos API server endpoints. It is similar to `--store-strict` but supports passing any Thanos gRPC APIs: StoreAPI, MetadataAPI, RulesAPI, TargetsAPI and ExemplarsAPI. Rule: Support ruleGroup limit introduced by Prometheus v2.31.0. Query: Add validation for querier address flags. Sidecar, Mixin: Rename `ThanosSidecarUnhealthy` to `ThanosSidecarNoConnectionToStartedPrometheus`; Remove `ThanosSidecarPrometheusDown` alert; Remove unused `thanossidecarlastheartbeatsuccesstimeseconds` metrics. Fetcher: Fix discovered data races. Query: Fix possible panic on stores endpoint. Store: validate block sync concurrency parameter. Examples: Fix the interactive test for MacOS users. Store: Fix data race in BucketedBytes pool. Query Frontend: Add "X-Request-ID" field and other fields to start call log. Store: Fix panic when the application is stopped. Query: Fix data race in exemplars server. Query: Fix data race in metadata, rules, and targets servers. Query: Fix deadlock in endpointset. Azure: Only create an http client once, to conserve memory. Compact/downsample: fix deadlock if error occurs with some backlog of blocks; fixes . Affected versions are 0.22.0 - 0.23.1. UI: Remove the old PromQL editor. Receive: Remove gRPC message size limit, which fixes errors commonly seen when receivers forward messages within a hashring. Query: Fix deadlock in endpointset. Compact/downsample: fix deadlock if error occurs with some backlog of blocks; fixes . Affected versions are 0.22.0 - 0.23.1. Sidecar: set Sidecar to NOT READY when it cannot establish a connection with Prometheus UI: Remove the old PromQL editor EndpointSet: Do not use unimplemented yet new InfoAPI to obtain metadata (avoids unnecessary HTTP roundtrip, instrumentation/alerts spam and logs). Query: Fix deadlock in endpointset. Compact/downsample: fix deadlock if error occurs with some backlog of blocks; fixes . Affected versions are 0.22.0 - 0.23.1. Endpointset: Do not use info client to obtain metadata. Tools `thanos bucket web`: Add flag `--selector.relabel-config-file` / `--selector.relabel-config` / `--max-time` / `--min-time` to filter served blocks. Store: Add `http_config` option for COS object store client. Query/Store: Add memcached auto discovery support for all caching clients. UI: Add search to the Block UI. Logging: Add `duration_ms` in int64 to the logs for easier log filtering. UI: Highlighting blocks overlap in the Block UI. Compact: Add flag `compact.skip-block-with-out-of-order-chunks` to skip blocks with out-of-order chunks during compaction instead of halting. Store: Add `Baidu BOS` object storage, see for further information. Compact: Add `thanoscompactdownsampledurationseconds` histogram metric. Reloader: Expose metrics in config reloader to give info on the last operation. Tracing: Added consistent tags to Series call from Querier about number important series statistics: `processed.series`, `processed.samples`, `processed.samples` and `processed.bytes`. This will give admin idea of how much data each component processes per query. Query-frontend: Make HTTP downstream tripper (client) configurable via parameters `--query-range.downstream-tripper-config` and `--query-range.downstream-tripper-config-file`. If your downstream URL is localhost or 127.0.0.1 then it is strongly recommended to bump `maxidleconnsperhost` to at least 100 so that `query-frontend` could properly use HTTP keep-alive connections and thus reduce the latency of `query-frontend` by about 20%. Rule: Fix temporary rule filename composition issue. UI: Fix incorrect html escape sequence used for '>' symbol. Mixin: Fix "all jobs" selector in thanos mixin dashboards. Azure: Fix Azure MSI Rate Limit. Query: Switch to miekgdns DNS resolver as the default

Update Prometheus/Cortex dependencies and implement LabelNames() pushdown as a result; provides massive speed-up for the labels API in Thanos Query. breaking :warning:: `--store` (in the future, to be renamed to `--endpoints`) now supports passing any APIs from Thanos gRPC APIs: StoreAPI, MetadataAPI, RulesAPI, TargetsAPI and ExemplarsAPI (in oppose in the past you have to put it in hidden `--targets`, `--rules` etc flags). `--store` will now automatically detect what APIs server exposes. Moved Prometheus dependency to v2.30. Add error logs to receiver when write request rejected with invalid replica UI: Add sorting and filtering to flags page Tracing: Add tracing to exemplar APIs. Add environment variable substitution to all YAML configuration flags. Add penalty based deduplication mode for compactor. Receive: Enable exemplars ingestion and querying. Tools: Added `--delete-blocks` to bucket rewrite tool to mark the original blocks for deletion after rewriting is done. Azure: Adds more configuration options for Azure blob storage. This allows for pipeline and reader specific configuration. Implements HTTP transport configuration options. These options allows for more fine-grained control on timeouts and retries. Implements MSI authentication as second method of authentication via a service principal token. Tools: Add retention command for applying retention policy on the bucket. Compact: Add flag `downsample.concurrency` to specify the concurrency of downsampling blocks. Fix the experimental PromQL editor when used on multiple line. ThanosSidecarUnhealthy doesn't fire if the sidecar is never healthy Receive: fix bug in forwarding remote-write requests within the hashring via gRPC when TLS is enabled on the HTTP server but not on the gRPC server. Ruler: fix SIGHUP reload signal not working. Receive: use the S2 library for decoding Snappy data; saves about 5-7% of CPU time in the Receive component when handling incoming remote write requests Build: do not upgrade apline version Sidecar: reloader: fix output config file permission Mixin: new alert ThanosReceiveTrafficBelowThreshold to flag if the ingestion average of the last hour dips below 50% of the ingestion average for the last 12 hours. Store: `LabelNames` and `LabelValues` now support label matchers. Sidecar: Added matchers support to `LabelValues` Docker: Busybox image updated to latest (1.33.1) Added Tag Configuration Support Lightstep Tracing Query API: Adds optional `Stats param` to return stats for query APIs Rule: Add `--alert.relabel-config` / `--alert.relabel-config-file` allowing to specify alert relabel configurations like Add TLS and basic authentication to Thanos APIs UI: add dark theme Tools: Added `--rewrite.to-relabel-config` to bucket rewrite tool to support series relabel from given blocks. Tools: Add glob support for filepath in tools command Query: federated exemplars API only add replica labels to series labels, not to exemplar labels. UI: Fix infinite redirection loop on root (/). Query: match external labels for exemplars API. Mixin: Remove dependency on the rule dashboard when generating the compact dashboard Query: Adds query range histogram. Query: Added federated exemplars API support. Query/Sidecar: Added targets API support. You can now configure you Querier to fetch Prometheus targets from leaf Prometheus-es! Expose exemplars for `httprequestduration_seconds` histogram if tracing is enabled. Store: Returning custom grpc code when reaching series/chunk limits. Allow to disable automatically setting CORS headers using `--web.disable-cors` flag in each component that exposes an API. Tools: Added a flag to support rewrite Prometheus TSDB blocks. Query Frontend: Support `maxitemsize` in Query frontend Memcached cache. receive: Improved efficiency of multitsdb appends, upgraded Prometheus deps. Mixin: Use sidecar's metric timestamp for healthcheck. \*: Fix panic in http logging middleware. Ruler: Fix deduplication of equal alerts with different labels. Store: Fix race condition in chunk pool. Query Frontend: fix downsampling iterator returning duplicate

Logging: fix the HTTP logger. Store: Adds the name of the instantiated memcached client to log info. Upgrade Go version to 1.16 Receiver: Adjust `httprequestduration_seconds` buckets for low latency requests. Mixin: breaking :warning: Introduce flexible multi-cluster/namespace mode for alerts and dashboards. Removes jobPrefix config option. Removes `namespace` by default. Store: Reduce memory usage for range queries. UI: Enable Targets page in Querier UI. Flags: Sort flags alphabetically. UI: Make the ReactUI the default one. Receive: Improved Performance for err path. \*: Upgrade Prometheus & Alertmanager. Compact/Web: Make old bucket viewer UI work with vanilla Prometheus blocks. \*: It's now possible to configure HTTP transport options for S3 client. Compact/Store: Added `--block-meta-fetch-concurrency` allowing to configure number of go routines for block metadata synchronization. Query Frontend: Added `--query-range.request-downsampled` flag enabling additional queries for downsampled data in case of empty or incomplete response to range request. Cache: Added inmemory cache for caching bucket. Receiver: Added `--tsdb.allow-overlapping-blocks` flag to allow overlapping tsdb blocks and enable vertical compaction. Query: Added `--query.default-step` flag to set default step. Useful when your tenant scrape interval is stable and far from default UI's 1s. Query/Sidecar: Added metric metadata API support. You can now configure you Querier to fetch Prometheus metrics metadata from leaf Prometheus-es! Compact/Sidecar/Receive/Rule: Added `--hash-func`. If some function has been specified, writers calculate hashes using that function of each file in a block before uploading them. If those hashes exist in the `meta.json` file then Compact does not download the files if they already exist on disk and with the same hash. This also means that the data directory passed to Thanos Compact is only cleared once at boot or if everything succeeds. So, if you, for example, use persistent volumes on k8s and your Thanos Compact crashes or fails to make an iteration properly then the last downloaded files are not wiped from the disk. The directories that were created the last time are only wiped again after a successful iteration or if the previously picked up blocks have disappeared. Store: Fix race condition leading to failing queries or possibly incorrect query results. Compact: Deletion-mark.json is deleted as the last one, which could in theory lead to potential store gateway load or query error for such in-deletion block. Store: Fix panic caused by a race condition happening on concurrent index-header reader usage and unload, when `--store.enable-index-header-lazy-reader` is enabled. Store: Fix panic caused by a race condition happening on concurrent index-header lazy load and unload, when `--store.enable-index-header-lazy-reader` is enabled. Compact: Fixed compaction planner size check, making sure we don't create too large blocks. Store: Decreased memory utilisation while fetching block's chunks. Receive: Improve handling of empty time series from clients s3: A truncated "get object" response is reported as error. Receive: Correct the inference of client gRPC configuration. Receive: Fixed memory regression introduced in v0.17.0. Query: Fixed deduplication of equal alerts with different labels. Ruler, Receive, Querier: Updated Prometheus dependency. TSDB characteristics might have changed. Mixin: Add block deletion panels for compactor dashboards. Store: Optimized inject label stage of index lookup. StoreAPI: Support label matchers in labels API. Store: Optimized common cases for time selecting smaller amount of series by avoiding looking up symbols. StoreAPI: Added `hints` field to `LabelNamesRequest` and `LabelValuesRequest`. Hints are an opaque data structure that can be used to carry additional information from the store and its content is implementation-specific. Tools: Added `thanos tools bucket rewrite` command allowing to delete series from given

Store: Added a CLI flag to limit the number of series that are touched. Query Frontend: Make POST request to downstream URL for labels and series API endpoints. Tools: Bucket replicator now can specify block IDs to copy. Tools: Bucket prints extra statistics for block index with debug log-level. Receive: Added `--receive.hashrings` alternative to `receive.hashrings-file` flag (lower priority). The flag expects the literal hashring configuration in JSON format. Mixin: Reintroduce `thanosobjstorebucketoperationfailures_total` alert. Query Frontend: Fix query_range behavior when start/end times are the same Query Frontend: Allow separate label cache Rule: Prevent crashing due to `no such host error` when using `dnssrv+` or `dnssrvnoa+`. Compact, Shipper, Store: Fixed panic when no external labels are set in block metadata. S3: Respect SignatureV2 flag for all credential providers. Swift: Switched to a new library providing large objects support. By default, segments will be uploaded to the same container directory `segments/` if the file is bigger than `1GB`. To change the defaults see . Shipper: Failed upload of `meta.json` file doesn't cause block cleanup anymore. This has a potential to generate corrupted blocks under specific conditions. Partial block is left in bucket for later cleanup. compact: do not cleanup blocks on boot. Reverts the behavior change introduced in as in some very bad cases the boot of Thanos Compact took a very long time since there were a lot of blocks-to-be-cleaned. Fix index out of bound bug when comparing ZLabelSets. Query Frontend: Fixed regression. pkg/rules/proxy: fix hotlooping when receiving client errors Enabled debug.SetPanicOnFault(true) which allow us to recover on queries causing SEG FAULTs (e.g unmmaped memory access). Thanos BlockViewer: Added a button in the blockviewer that allows users to download the metadata of a block. Thanos Store: Use segment files specified in meta.json file, if present. If not present, Store does the LIST operation as before. Query Frontend: Support query splitting and retry for label names, label values and series requests. Query Frontend: Support results caching for label names, label values and series requests. Ruler UI: Fix a bug preventing the /rules endpoint from loading. compact: now deletes partially uploaded and blocks with deletion marks concurrently. It does that at the beginning and then every `--compact.cleanup-interval` time period. By default it is 5 minutes. s3: add listobjectsversion config option for compatibility. Query Frontend: Add a flag to disable step alignment middleware for query range. Ruler: added the ability to send queries via the HTTP method POST. Helps when alerting/recording rules are extra long because it encodes the actual parameters inside of the body instead of the URI. Thanos Ruler now uses POST by default unless `--query.http-method` is set `GET`. Querier UI: Add ability to enable or disable metric autocomplete functionality. Replicator: Add the ability to replicate blocks within a time frame by passing --min-time and --max-time Query Frontend: Add default config for query frontend memcached config. Thanos Query: Introduce dynamic lookback interval. This allows queries with large step to make use of downsampled data. Compactor: Added support for no-compact-mark.json which excludes the block from compaction. Query Frontend: Add `query-frontend.org-id-header` flag to specify HTTP header(s) to populate slow query log (e.g. X-Grafana-User). Store: Added experimental support to lazy load index-headers at query time. When enabled via `--store.enable-index-header-lazy-reader` flag, the store-gateway will load into memory an index-header only once it's required at query time. Index-header will be automatically released after `--store.index-header-lazy-reader-idle-timeout` of inactivity. This, generally, reduces baseline memory usage of store when inactive, as well as a total number of mapped files (which is limited to 64k in some systems. StoreAPI: Added `hints` field to `LabelNamesResponse` and

Hints in an opaque data structure that can be used to carry additional information from the store and its content is implementation specific. This, generally, reduces baseline memory usage of store when inactive, as well as a total number of mapped files (which is limited to 64k in some systems. Tools: Added `thanos tools bucket mark` command that allows to mark given block for deletion or for no-compact Ruler: Prevent Ruler from crashing when using default DNS to lookup hosts that results in "No such hosts" errors. Disable Azure blob exception logging Disable Azure blob syslog exception logging Set CORS for Query Frontend Add external labels to Labels APIs. Store: Index cache posting compression is now enabled by default. Removed `experimental.enable-index-cache-postings-compression` flag. Compactor: Changed metric `thanoscompactorblocksmarkedfordeletiontotal` to `thanoscompactorblocksmarkedtotal` with `marker` label. Compactor will now automatically disable compaction for blocks with large index that would output blocks after compaction larger than specified value (by default: 64GB). This automatically handles the Promethus . Tools: Refactor Bucket replicate execution. Removed all `thanosreplicateorigin_.*` metrics. `thanosreplicateoriginmetaloadstotal` can be replaced by `blocksmeta_synced{state="loaded"}`. `thanosreplicateoriginpartialmetareadstotal` can be replaced by `blocksmetasynced{state="failed"}`. Compact: breaking :warning: Rename metrics to match naming convention. This includes metrics starting with `thanoscompactor` to `thanoscompact`, `thanosquerier` to `thanosquery` and `thanosruler` to `thanosrule`. Highlights: New Thanos component, has more options and supports shared cache (currently: Memcached). Added debug mode in Thanos UI that allows to filter Stores to query from by their IPs from Store page (!). This helps enormously in e.g debugging the slowest store etc. All raw Thanos API allows passing `storeMatch[]` arguments with `address` matchers. Improved debuggability on all Thanos components by exposing . Significantly improved sidecar latency and CPU usage for metrics fetches. UI: Fix assets not loading when `--web.prefix-header` is used. Compactor: Fixed support for `web.external-prefix` for Compactor UI. Query Frontend: Added support for Memcached cache. breaking Renamed flag `logquerieslonger_than` to `log-queries-longer-than`. UIs: Added UI for passing a `storeMatch[]` parameter to queries. Logging: Added debug level logging for responses between 300-399 Query: Allowed passing a `storeMatch[]` to Labels APIs; Time range metadata based store filtering is supported on Labels APIs. Sidecar: Significantly improved sidecar latency (reduced ~2x). Added `thanossidecarprometheusstorereceived_frames` histogram metric. Querier: Added `query.metadata.default-time-range` flag to specify the default metadata time range duration for retrieving labels through Labels and Series API when the range parameters are not specified. The zero value means range covers the time since the beginning. Query Frontend: Added `cache-compression-type` flag to use compression in the query frontend cache. \*: All Thanos components have now `/debug/fgprof` endpoint on HTTP port allowing to get . Query Frontend: Added support for `Cache-Control` HTTP response header which controls caching behaviour. So far `no-store` value is supported and it makes the response skip cache. Tools: Added `tools bucket cleanup` CLI tool that deletes all blocks marked to be deleted. Sidecar: breaking Added metric `thanossidecarreloaderconfigapplyoperationstotal` and rename metric `thanossidecarreloaderconfigapplyerrorstotal` to `thanossidecarreloaderconfigapplyoperationsfailed_total`. Querier: breaking Added metric `thanosquerygatequeriesmax`. Remove metric `thanosqueryconcurrentselectsgatequeriesin_flight`. Store: breaking Renamed metric `thanosbucketstorequeriesconcurrentmax` to `thanosbucketstoreseriesgatequeries_max`. Store: context.Canceled will not increase `thanosobjstorebucketoperationfailures_total`. Sidecar: Improved detection of directory changes for Prometheus config. breaking Added metric `thanossidecarreloaderconfigapplyoperationstotal` and rename metric `thanossidecarreloaderconfigapplyerrorstotal` to `thanossidecarreloaderconfigapplyoperationsfailed_total`. \*: Thanos images are now build with Go 1.15. \*: Updated TSDB to ~2.21 Highlights: Added new Thanos component: responsible for response caching, query scheduling and parallelization (based on Cortex Query Frontend). Added various new, improved UIs to Thanos based on React: Querier BuildInfo & Flags, Ruler UI,

Optimized Sidecar, Store, Receive, Ruler data retrieval with new TSDB ChunkIterator (capping chunks to 120 samples), which fixed various leaks. Fixed sample limit on Store Gateway. Added S3 Server Side Encryption options. Tons of other important fixes! Swift: Fix issue with missing Content-Type HTTP headers. Query: Fix handling of `--web.external-prefix` and `--web.route-prefix`. Query: Fix rendered JSON state value for rules and alerts should be in lowercase. Receive, Querier: Fixed leaks on receive and querier Store API Series, which were leaking on errors. Receive: Fixing auto-configuration of `--receive.local-endpoint`. Compact: Fix increment of `thanoscompactdownsample_total` metric for downsample of 5m resolution blocks. Store: Fix `--store.grpc.series-sample-limit` implementation. The limit is now applied to the sum of all samples fetched across all queried blocks via a single Series call, instead of applying it individually to each block. Compact: Fix ReplicaLabelRemover panic when replicaLabels are not specified. Store: Fix fetching of chunks bigger than 16000 bytes. Store: Upgrade minio-go/v7 to fix slowness when running on EKS. Rule: breaking :warning: Now sets all of the relevant fields properly; avoids a panic when `/api/v1/rules` is called and the time zone is not UTC; `rules` field is an empty array now if no rules have been defined in a rule group. Thanos Rule's `/api/v1/rules` endpoint no longer returns the old, deprecated `partialresponsestrategy`. The old, deprecated value has been fixed to `WARN` for quite some time. Please use `partialResponseStrategy`. Query: Better rounding for incoming query timestamps. Mixin: Fix expression for 'unhealthy sidecar' alert and increase the timeout for 10 minutes. Query: Consider group name and file for deduplication. Ruler,Receiver: Fix TSDB to delete blocks in atomic way. Ruler,Receiver: Fixed framing of StoreAPI response, it was one chunk by one. Ruler: Update the manager when all rule files are removed. Querier: Fix overwriting `maxSourceResolution` when auto downsampling is enabled. Querier: Added `--query.lookback-delta` flag to override the default lookback delta in PromQL. The flag should be lookback delta should be set to at least 2 times of the slowest scrape interval. If unset it will use the PromQL default of 5m. Receive,Sidecar,Ruler: Propagate correct (stricter) MinTime for TSDBs that have no block. Query, Ruler: Added request logging for HTTP server side. ui React: Add runtime and build info page API: Add new blocks HTTP API to serve blocks metadata. The status endpoints (`/api/v1/status/flags`, `/api/v1/status/runtimeinfo` and `/api/v1/status/buildinfo`) are now available on all components with a HTTP API. Receive: Receiver fails when the initial upload fails. ui: Migrate Thanos Ruler UI to React Query: Add time range parameters to label APIs. Add `start` and `end` fields to Store API `LabelNamesRequest` and `LabelValuesRequest`. Sidecar: Add `reloaderconfigapplyerrorstotal` metric. Add new flags `--reloader.watch-interval`, and `--reloader.retry-interval`. Add Thanos Query Frontend component. Bucket Viewer: Migrate block viewer to React. Add bucket index operation durations: `thanosbucketstorecachedseriesfetchdurationseconds` and `thanosbucketstorecachedpostingsfetchdurationseconds`. Query: Allow passing a `storeMatch Store: Rename metric `thanosbucketstorecachedpostingscompressiontimeseconds` to `thanosbucketstorecachedpostingscompressiontimeseconds_total`. Receive,Ruler: Enable TSDB directory locking by default. Add a new flag (`--tsdb.no-lockfile`) to override behavior. Querier UI:Separate dedupe and partial response checkboxes per panel in new UI. Store: breaking :warning: `operation` label value `getrange` changed to `getrange` for `thanosstorebucketcacheoperationrequeststotal` and `thanosstorebucketcacheoperationhits_total` to be consistent with bucket operation metrics. Receive,Ruler: Updated TSDB and switched to ChunkIterators instead of sample one, which avoids unnecessary decoding / encoding. s3: breaking :warning: Add SSE/SSE-KMS/SSE-C configuration. The S3 `encryptsse: true` option is now deprecated in favour of `sseconfig`. If you used `encrypt_sse`, the migration strategy is to set up the following block: ```yaml sse_config: type: SSE-S3 ``` Compact: Detect retryable errors that are inside of a wrapped `tsdb.MultiError`. Store: Allow index cache and caching bucket to be configured at the same

Query: Fixed panics when using larger number of replica labels with short series label sets. Update Prometheus mod to pull in prometheus/prometheus#7414. Store: Decreased memory allocations while querying block's index. Query: `/api/v1/stores` now guarantees to return a string in the `lastError` field. Upgrade to Prometheus which is after v2.18.1. TSDB now does memory-mapping of Head chunks and reduces memory usage. Store: Removed support to the legacy `index.cache.json`. The hidden flag `--store.disable-index-header` was removed. Store: Renamed the caching bucket config option `chunkobjectsizettl` to `chunkobjectattrsttl`. Compact: The deprecated flag `--index.generate-missing-cache-file` and the metric `thanoscompactgeneratedindextotal` were removed. breaking Tools: Bucket replicate flag `--resolution` is now in Go duration format. Tools: Bucket replicate now replicates by default all blocks. Changed `bucket tool bucket verify` `--id-whitelist` flag to `--id`. Upgrade Prometheus to which is after v2.19.0. PromQL now allow us to executed concurrent selects. Tools: Bucket replicate now allows passing repeated `--compaction` and `--resolution` flags. Querier: Add the ability to perform concurrent select request per query. UI: Add stores page in the React UI. Compact: Add flag `--block-viewer.global.sync-block-interval` to configure metadata sync interval for the bucket UI. Query: Fixed rare cases of double counter reset accounting when querying `rate` with deduplication enabled. S3: Fixed AWS STS endpoint url to https for Web Identity providers on AWS EKS. Query: Gracefully handle additional fields in `SeriesResponse` protobuf message that may be added in the future. Query: Don't close the connection of strict, static nodes if establishing a connection had succeeded but Info() call failed. Rule: Fix bugs where rules were out of sync. Tracing: Disabled Elastic APM Go Agent default tracer on initialization to disable the default metric gatherer. Query: Fixed logging for dns resolution error in the `Query` component. Query/Ruler: Fixed issue #2483, when web.route-prefix is set, it is added twice in HTTP router prefix. Bucket: Fixed issue #2416 bug in `inspect --sort-by` doesn't work correctly in all cases. Query: `irate` and `resets` use now counter downsampling aggregations. minio-go: Added support for `af-south-1` and `eu-south-1` regions. Sidecar, Receive, Rule: Fixed possibility of out of order uploads in error cases. This could potentially cause Compactor to create overlapping blocks. Receive: Added multi-tenancy support (based on header) StoreAPI: Added `hints` field to `SeriesResponse`. Hints in an opaque data structure that can be used to carry additional information from the store and its content is implementation specific. Sidecar: Added `thanossidecarreloaderreloadsfailedtotal`, `thanossidecarreloaderreloadstotal`, `thanossidecarreloaderwatcherrorstotal`, `thanossidecarreloaderwatcheventstotal` and `thanossidecarreloaderwatches` metrics. UI: Added React UI from Prometheus upstream. Currently only accessible from Query component as only `/graph` endpoint is migrated. Store: Added hidden option `--store.caching-bucket.config=<yaml content>` (or `--store.caching-bucket.config-file=<file.yaml>`) for experimental caching bucket, that can cache chunks into shared memcached. This can speed up querying and reduce number of requests to object storage. Store: Experimental caching bucket can now cache metadata as well. Config has changed from #2532. Compact: In case there are no labels left after deduplication via `--deduplication.replica-label`, assign first `replica-label` with value `deduped`. Receive: Added flag to configure forward request timeout. Receive write will complete request as soon as quorum of writes succeeds. Updated to golang v1.14.2. Store: Removed obsolete `thanosstorenode_info` metric. Tools: Moved `thanos bucket` commands to `thanos tools bucket`, also moved `thanos check rules` to `thanos tools rules-check`. `thanos tools rules-check` also takes rules by `--rules` repeated flag not argument anymore. Store, Querier: remove duplicated chunks on StoreAPI. Updated Prometheus dependency to which falls in between v2.17.0 and v2.18.0. Receive,Rule: TSDB now supports isolation of append and queries. Receive,Rule: TSDB now holds less WAL files after Head

Store: Added Regex-set optimization for `label=~"a|b|c"` matchers. Compact: In case there are no labels left after deduplication via `--deduplication.replica-label`, assign first `replica-label` with value `deduped`. Store/Querier: Significantly optimize cases where StoreAPIs or blocks returns exact overlapping chunks (e.g Store GW and sidecar or brute force Store Gateway HA). Compact: Fixed issue with old blocks being marked and deleted in a (slow) loop. Rule: do not wrap reload endpoint with `/`. Makes `/-/reload` accessible again when no prefix has been specified. Query: fix a bug where queries might not time out sometimes due to issues with one or more StoreAPIs. Store: remove incorrect optimizations for queries with `=~"."` and `!=~"."` matchers. Compact: fix a bug where partial blocks were never deleted, causing spam of warnings. Store: fix a panic caused by concurrent memory access during block filtering. Ruler: fixes issue #2281, a bug causing incorrect parsing of query address with path prefix. Ruler: fixed issue #2204, where a bug in alert queue signaling filled up the queue and alerts were dropped. Bucket Web: sort chunks by thanos.downsample.resolution for better grouping. Bucket: fix issue where metrics were registered multiple times in bucket replicate. Bucket Web: fixed issue #2260, where the bucket passes null when storage is empty. Query: fix a bug where `--store.unhealthy-timeout` was never respected. Query and Rule: fix handling of `web.route-prefix` to correctly handle `/` and prefixes that do not begin with a `/`. Receive: ensure receive component serves TLS when TLS configuration is provided. Query: fixed inconsistent naming of metrics. Store: fixed bug that was causing all posting offsets to be used instead of only 1/32 as intended; added hidden flag to control this behavior. Store: fixed bug causing certain not-existing label values queried to fail with "invalid-size" error from binary header. Store: fixed bug causing partial writes of index-header. Store: handle expected errors correctly, e.g. do not increment failure counters. Query: add new `--store-strict` flag. More information available . Compact: add `--wait-interval` to specify compaction wait interval between consecutive compact runs when `--wait` is enabled. Compact: enable vertical compaction for offline deduplication (experimental). Uses `--deduplication.replica-label` flag to specify the replica label on which to deduplicate (hidden). Please note that this uses a NAIVE algorithm for merging (no smart replica deduplication, just chaining samples together). This works well for deduplication of blocks with precisely the same samples like those produced by Receiver replication. We plan to add a smarter algorithm in the following weeks. Compact: the compact component now exposes the bucket web UI when it is run as a long-lived process. Store: added `maxitemsize` configuration option to memcached-based index cache. This should be set to the max item size configured in memcached (`-I` flag) in order to not waste network round-trips to cache items larger than the limit configured in memcached. Store: add `--experimental.enable-index-cache-postings-compression` flag to enable re-encoding and compressing postings before storing them into the cache. Compressed postings take about 10% of the original size. Compact and Store: the compact and store components now serve the bucket UI on `:<http-port>/loaded`, which shows exactly the blocks that are currently seen by compactor and the store gateway. The compactor also serves a different bucket UI on `:<http-port>/global`, which shows the status of object storage without any filters. Store: add support for sharding the store component based on the label hash. Bucket: added `thanos bucket replicate` command to replicate blocks from one bucket to another. Docs: create a new document to explain sharding in Thanos. Store: optimize conversion of

breaking Store, Compact, Bucket: schedule block deletion by adding deletion-mark.json. This adds a consistent way for multiple readers and writers to access object storage. Since there are no consistency guarantees provided by some Object Storage providers, this PR adds a consistent lock-free way of dealing with Object Storage irrespective of the choice of object storage. In order to achieve this co-ordination, blocks are not deleted directly. Instead, blocks are marked for deletion by uploading the `deletion-mark.json` file for the block that was chosen to be deleted. This file contains Unix time of when the block was marked for deletion. If you want to keep existing behavior, you should add `--delete-delay=0s` as a flag. breaking Downsample command: the `downsample` command has moved and is now a sub-command of the `thanos bucket` sub-command; it cannot be called via `thanos downsample` any more. Store: optimizations for fetching postings. Queries using `=~".*"` matchers or negation matchers (`!=...` or `!~...`) benefit the most. Ruler: exit with an error when initialization fails. Query: report timespan 0 to 0 when discovering no stores. Store: index-header is no longer experimental. It is enabled by default for store Gateway. You can disable it with new hidden flag: `--store.disable-index-header`. The `--experimental.enable-index-header` flag was removed. Ruler: allow returning error messages when a reload is triggered via HTTP. All: Thanos components will now print stack traces when they error out. Minio-go: Fixed Issue #1494 support Web Identity providers for IAM credentials for AWS EKS. Store Gateway: Fixed case where series entry is larger than 64KB in index. Ruler: Fixed issue where ruler does not expose shipper metrics. Ruler: Fixed bug where thanosalertsendererrorstotal was not registered. Store Gateway: Improve timeouts. Properly handle SIGHUP for reloading. UI: Fix URL of alerts in Ruler Ruler: Fix tracing in Thanos Ruler Query: Support downsampling for /series. Store Gateway: Implemented . This significantly reduces resource consumption (memory, CPU, net bandwidth) for startup and data loading processes as well as baseline memory. This means that adding more blocks into object storage, without querying them will use almost no resources. This, however, still means that querying large amounts of data will result in high spikes of memory and CPU use as before, due to simply fetching large amounts of metrics data. Since we fixed baseline, we are now focusing on query performance optimizations in separate initiatives. To enable experimental `index-header` mode run store with hidden `experimental.enable-index-header` flag. Store Gateway: Minimum age of all blocks before they are being read. Set it to a safe value (e.g 30m) if your object storage is eventually consistent. GCS and S3 are (roughly) strongly consistent. Mixin: Add Thanos Ruler alerts. Query: Add cache-control header to not cache on error. UI: Persist settings in query. Sidecar: allow setting http connection pool size via flags. Receive: Allow local TSDB compaction. Ruler: Add TLS and authentication support for query endpoints with the `--query.config` and `--query.config-file` CLI flags. See for further information. Ruler: Add support for Alertmanager v2 API endpoints. Query: Add `thanosproxystoreemptystreamresponsestotal` metric for number of empty responses from stores. Tracing: Support sampling on Elastic APM with new sample_rate setting. Querier, Receiver, Sidecar, Store: Add gRPC endpoints. Tracing: track query sent to prometheus via remote read api. breaking Receive: Use gRPC for forwarding requests between peers. Note that existing values for the `--receive.local-endpoint` flag and the endpoints in the hashring configuration file must now specify the receive gRPC port and must be updated to be a simple `host:port` combination, e.g. `127.0.0.1:10901`, rather than a full HTTP URL, e.g.

Add a flag `--tsdb.wal-compression` to configure whether to enable tsdb wal compression in ruler and receiver. Rename metric `thanosqueryduplicatedstoreaddress` to `thanosqueryduplicatedstoreaddressestotal` and `thanosruleduplicatedqueryaddress` to `thanosruleduplicatedqueryaddressestotal`. Bucket Web: improve the tooltip for the bucket UI; it was reconstructed and now exposes much more information about blocks. Sidecar: Querier /api/v1/series bug fixed when time range was ignored inside sidecar. The bug was noticeable for example when using Grafana template variables. Bucket Web: Set state of status prober properly. Compactor: Fixed potential data loss when uploading older blocks, or upload taking long time while compactor is running. Compactor: Improved synchronization of meta JSON files. Compactor now properly handles partial block uploads for all operation like retention apply, downsampling and compaction. Additionally: Removed `thanoscompactsyncmeta` metrics. Use `thanos_blocks_meta_` metrics instead. Added `thanosconsistencydelayseconds` and `thanoscompactorabortedpartialuploadsdeletionattemptstotal` metrics. Store: Improved synchronization of meta JSON files. Store now properly handles corrupted disk cache. Added meta.json sync metrics. Receive: close DBReadOnly after flushing to fix a memory leak. Receive: upload to object storage as 'receive' rather than 'sidecar'. Store: Fixed the duration unit for the metric `thanosbucketstoreseriesgatedurationseconds`. Compact: Fixed the compactor successfully exiting when actually an error occurred while compacting a blocks group. Ruler: `/api/v1/rules` now shows a properly formatted value `master` container images are now built with Go 1.13 Ruler: now properly ignores duplicated query addresses Store Gateway: fixed panic caused by memcached servers selector when there's 1 memcached node Add support for `AWSCONTAINERCREDENTIALSFULLURI` by upgrading to minio-go v6.0.44 Update Rule UI to support alerts count displaying and filtering. Ruler: Add TLS and authentication support for Alertmanager with the `--alertmanagers.config` and `--alertmanagers.config-file` CLI flags. See for further information. Ruler: Add a new `--alertmanagers.sd-dns-interval` CLI option to specify the interval between DNS resolutions of Alertmanager hosts. Store Gateway: memcached support for index cache. See for further information. Add a skip-chunks option in Store Series API to improve the response time of `/api/v1/series` endpoint. Query: `/api/v1/labels` now understands `POST` - useful for sending bigger requests Upgraded Prometheus dependencies to v2.15.2. This includes: Compactor: Significant reduction of memory footprint for compaction and downsampling process. Querier: Accepting spaces between time range and square bracket. e.g `[ 5m]` Querier: Improved PromQL parser performance. `--shipper.upload-compacted` flag has been promoted to non hidden, non experimental state. More info available . Ruler: now sets a `Thanos/$version` `User-Agent` in requests Service discovery now deduplicates targets between different target groups Add Lightstep as a tracing provider. Add a new `--grpc-grace-period` CLI option to components which serve gRPC to set how long to wait until gRPC Server shuts down. Sidecar: Add a new `--prometheus.ready_timeout` CLI option to the sidecar to set how long to wait until Prometheus starts up. `AliYun OSS` object storage, see for further information. Add a new `--http-grace-period` CLI option to components which serve HTTP to set how long to wait until HTTP Server shuts down. Bucket: Rename flag on bucket web component from `--listen` to `--http-address` to match other components. Compactor: New metric `thanoscompactoriterations_total` on Thanos Compactor which shows the number of successful iterations. Bucket: `thanos bucket web` now supports `--web.external-prefix` for proxying on a subpath. Bucket: Add `--web.prefix-header` flags to allow for bucket UI to be accessible behind a reverse proxy. Receiver: Added TLS options for both server and client remote write. Store Gateway: Store now starts metric and status probe HTTP server earlier in its start-up sequence. `/-/healthy` endpoint now starts to respond with success earlier. `/metrics` endpoint starts serving metrics earlier as

Make sure to point your readiness probes to the `/-/ready` endpoint rather than `/metrics`. Store Gateway: Fixed store sharding. Now it does not load excluded meta.jsons and load/fetch index-cache.json files. Sidecar: Fixed un-ordered blocks upload. Sidecar now uploads the oldest blocks first. Store Gateway: Store now retains the first raw value of a chunk during downsampling to avoid losing some counter resets that occur on an aggregation boundary. Querier: Fixed labels for StoreUI Ruler: Fixed the /api/v1/rules endpoint that returned 500 status code with `failed to assert type of rule ...` message. Querier: Fixed `--web.external-prefix` 404s for static resources. Ruler: The /api/v1/rules endpoints now returns the original rule filenames. Ruler: Ruler now supports identical rule filenames in different directories. Querier: Downsampling option now carries through URL. Querier: Reduced resource usage while using certain queries like `offset`. & Store Gateway: Per request memory improvements. Compact: `thanoscompactgroupcompactionstotal` now counts block compactions, so operations that resulted in a compacted block. The old behaviour is now exposed by new metric: `thanoscompactgroupcompactionrunsstartedtotal` and `thanoscompactgroupcompactionrunscompletedtotal` which counts compaction runs overall. Updated all dependencies. `proberready` and `proberhealthy` metrics are removed, for sake of `status`. Now `status` exposes same metric with a label, `check`. `check` can have "healty" or "ready" depending on status of the probe. Ruler: Fixes subqueries support for ruler. & Adjusted most of the metrics histogram buckets. Removes the duplicated external labels detection on Thanos Querier; warning only; Made Store Gateway compatible with older Querier versions. NOTE: `thanosstorenodesgrpcconnections` metric is now per `externallabels` and `storetype`. It is a recommended metric for Querier storeAPIs. `thanosstorenode_info` is marked as obsolete and will be removed in next release. NOTE2: Store Gateway is now advertising artificial: `"@thanoscompatibilitystore_type=store"` label. This is to have the current Store Gateway compatible with Querier pre v0.8.0. This label can be disabled by hidden `debug.advertise-compatibility-label=false` flag on Store Gateway. Lot's of improvements this release! Noteworthy items: First Katacoda tutorial! Fixed Deletion order causing Compactor to produce not needed blocks with missing random files. Store GW memory improvements (more to come!). Querier allows multiple deduplication labels. Both Compactor and Store Gateway can be sharded within the same bucket using relabelling! Sidecar exposed data from Prometheus can be now limited to given `min-time` (e.g 3h only). Numerous Thanos Receive improvements. Make sure you check out Prometheus 2.13.0 as well. New release drastically improves usage and resource consumption of both Prometheus and sidecar with Thanos: https://prometheus.io/blog/2019/10/10/remote-read-meets-streaming/ Thanos sidecar allows to limit min time range for data it exposes from Prometheus. Thanos sharding: Add relabel config (`--selector.relabel-config-file` and `selector.relabel-config`) into Thanos Store and Compact components. Selecting blocks to serve depends on the result of block labels relabeling. For store gateway, advertise labels from "approved" blocks. Thanos Downsample added `/-/ready` and `/-/healthy` endpoints. Thanos Rule added `/-/ready` and `/-/healthy` endpoints. Thanos Receive added `/-/ready` and `/-/healthy` endpoints. Thanos Store Added `/-/ready` and `/-/healthy` endpoints. Thanos Query Added `/-/ready` and `/-/healthy` endpoints. Thanos inspect now supports the timeout flag. Thanos Receive now supports setting block duration. Optional `replicaLabels` param for `/query` and `/query_range` querier endpoints. When provided overwrite the `query.replica-label` cli flags. Thanos now supports Elastic APM as tracing provider. Thanos Rule added `resendDelay` flag. Thanos Receive flushes storage on hashring change. Thanos Receive now traces forwarded requests. `query.replica-label` configuration can be provided more than once for multiple deduplication labels like: `--query.replica-label=prometheus_replica --query.replica-label=service`. Thanos Store now can use smaller buffer sizes for Bytes pool; reducing memory for some requests. & Upgraded to Go 1.13.1 Thanos Receive change flag `labels` to `label` to be consistent with other

Thanos now deletes block's file in correct order allowing to detect partial blocks without problems. Thanos Store now removes invalid local cache blocks. Thanos Sidecar cleanups all cache dirs after each compaction run. Thanos Rule correctly parses Alertmanager URL if there is more `+` in it. Iterating over object store is resilient to the edge case for some providers. Fixed Azure potential failures (EOF) when requesting more data then blob has. Thanos Store fixed memory leak for chunk pool. Thanos Rule now now correctly links to query URL from rules and alerts. Accepted into CNCF: Thanos moved to new repository https://github.com/thanos-io/thanos Docker images moved to https://quay.io/thanos/thanos and mirrored at https://hub.docker.com/r/thanosio/thanos Slack moved to https://slack.cncf.io `#thanos`/`#thanos-dev`/`#thanos-prs` Thanos components now exposes gRPC server metrics as soon as server starts, to provide more reliable data for instrumentation. Thanos Receive now exposes `thanosreceiveconfighash`, `thanosreceiveconfiglastreloadsuccessful` and `thanosreceiveconfiglastreloadsuccesstimestamp_seconds` metrics to track latest configuration change Thanos Sidecar added support for newest Prometheus streaming remote read added . This massively improves memory required by single request for both Prometheus and sidecar. Single requests now should take constant amount of memory on sidecar, so resource consumption prediction is now straightforward. This will be used if you have Prometheus `2.13` or `2.12-master`. Added `part_size` configuration option for HTTP multipart requests minimum part size for S3 storage type Thanos Receive now exposes `thanosreceivehashringnodes` and `thanosreceivehashringtenants` metrics to monitor status of hash-rings Thanos Sidecar added `/-/ready` and `/-/healthy` endpoints to Thanos sidecar. Thanos Compact added `/-/ready` and `/-/healthy` endpoints to Thanos compact. Thanos Query added hidden flag to allow the use of downsampled resolution data for instant queries. Thanos Store Gateway can now allow the specifying of supported time ranges it will serve (time sharding). Flags: `min-time` & `max-time` Upgraded important dependencies: Prometheus to 2.12-rc.0. TSDB is now part of Prometheus. Upgraded important dependencies: Prometheus to 2.11.1 and TSDB to 0.9.1. Some changes affecting Querier: [ENHANCEMENT] Query performance improvement: Efficient iteration and search in HashForLabels and HashWithoutLabels. #5707 [ENHANCEMENT] Optimize queries using regexp for set lookups. tsdb#602 [BUGFIX] prometheustsdbcompactionsfailedtotal is now incremented on any compaction failure. tsdb#613 [BUGFIX] PromQL: Correctly display {name="a"}. Thanos Query still warns on store API duplicate, but allows a single one from duplicated set. This is gracefully warn about the problematic logic and not disrupt immediately. Thanos Compact exposes flag to disable downsampling `downsampling.disable`. Thanos Query `/series` API end-point now properly returns an empty array just like Prometheus if there are no results Thanos now efficiently reuses HTTP keep-alive connections Thanos Receive fixed race condition in hashring Thanos fixed value of GOMAXPROCS inside container. Fix for CVE-2019-10215 Thanos Query and Receive now use common instrumentation middleware. As as result, for sake of `httprequeststotal` and `httprequestdurationsecondsbucket`; Thanos Query no longer exposes `thanosqueryapiinstantquerydurationseconds`, `thanosqueryapirangequerydurationsecond` metrics and Thanos Receive no longer exposes `thanoshttprequestdurationseconds`, `thanoshttprequeststotal`, `thanoshttpresponsesize_bytes`. Thanos Bench deprecated. Added `thanos check rules` linter for Thanos rule rules files. Add support for specifying a maximum amount of retries when using Azure Blob storage (default: no retries). Thanos Compact now exposes new metrics `thanoscompactdownsampletotal` and `thanoscompactdownsamplefailures_total` which are useful to catch when errors happen Thanos Query/Rule now exposes metrics `thanosquerierstoreapisdnsproviderresults` and `thanosrulerqueryapisdnsproviderresults` which tell how many addresses were configured and how many were actually discovered respectively Add a web UI to show the state of remote storage. Thanos Receive gained basic hashring support Thanos Receive got a new metric `thanoshttprequests_total` which shows how many requests were handled by it Thanos Receive got an ability to forward time series data between nodes. Now you can pass the hashring configuration via

the refresh interval `--receive.hashrings-file-refresh-interval`; the name of the local node's name `--receive.local-endpoint`; and finally the header's name which is used to determine the tenant `--receive.tenant-header`. Support for the Jaeger tracer has been added! breaking New common flags were added for configuring tracing: `--tracing.config-file` and `--tracing.config`. You can either pass a file to Thanos with the tracing configuration or pass it in the command line itself. Old `--gcloudtrace.*` flags were removed :warning: To migrate over the old `--gcloudtrace.*` configuration, your tracing configuration should look like this: ```yaml type: STACKDRIVER config: service_name: "foo" project_id: "123" sample_factor: 123 ``` The other `type` you can use is `JAEGER` now. The `config` keys and values are Jaeger specific and you can find all of the information . Add support for multiple label-sets in Info gRPC service. This deprecates the single `Labels` slice of the `InfoResponse`, in a future release backward compatible handling for the single set of Labels will be removed. Upgrading to v0.6.0 or higher is advised. breaking If you run have duplicate queries in your Querier configuration with hierarchical federation of multiple Queries this PR makes Thanos Querier to detect this case and block all duplicates. Refer to 0.6.1 which at least allows for single replica to work. Removes `httprequestdurationmicroseconds` (Summary) and adds `httprequestdurationseconds` (Histogram) from http server instrumentation used in Thanos APIs and UIs. Sidecar now waits on Prometheus' external labels before starting the uploading process Thanos Receive now exposes metrics `thanoshttprequestdurationseconds` and `thanoshttpresponsesizebytes` properly of each handler Iteration limit has been lifted from the LRU cache so there should be no more spam of error messages as they were harmless Thanos Query now fails early on a query which only uses external labels - this improves clarity in certain situations Some context handling issues were fixed in Thanos Compact; some unnecessary memory allocations were removed in the hot path of Thanos Store. Compactor now correctly propagates retriable/haltable errors which means that it will not unnecessarily restart if such an error occurs Receive now correctly handles SIGINT and closes without deadlocking Fixed inflated values problem with `sum()` on Thanos Query Fixed a problem with concurrent writes to a `map` in Thanos Query while rendering the UI Fixed occasional panics in Compact and Store when using Azure Blob cloud storage caused by lack of error checking in client library. Removed duplicated closing of the gRPC listener - this gets rid of harmless messages like `store gRPC listener: close tcp 0.0.0.0:10901: use of closed network connection` when those programs are being closed the old "Command-line flags" has been removed from Thanos Query UI since it was not populated and because we are striving for consistency TL;DR: Store LRU cache is no longer leaking, Upgraded Thanos UI to Prometheus 2.9, Fixed auto-downsampling, Moved to Go 1.12.5 and more. This version moved tarballs to Golang 1.12.5 from 1.11 as well, so same warning applies if you use `containermemoryusagebytes` from cadvisor. Use `containermemoryworkingset_bytes` instead. breaking As announced couple of times this release also removes gossip with all configuration flags (`--cluster.*`). fixed major leak on store LRU cache for index items (postings and series). sidecar is no longer blocking for custom Prometheus versions/builds. It only checks if flags return non 404, then it performs optional checks. store/bucket: make getFor() work with interleaved resolutions. querier correctly handles duplicated stores when some store changes external labels in place. Allow configuring the response header timeout for the S3 client. breaking swift: Added support for cross-domain authentication by introducing `userDomainID`, `userDomainName`, `projectDomainID`,

The outdated terms `tenantID`, `tenantName` are deprecated and have been replaced by `projectID`, `projectName`. Upgrade Thanos ui to Prometheus v2.9.1. Changes from the upstream: query: - - - rule: - Moved CI and docker multistage to Golang 1.12.5 for latest mem alloc improvements. Updated go-cos deps. (COS bucket client). Updated google Golang API deps (GCS bucket client). Updated minio deps (S3 bucket client). This fixes minio retries. Use prometheus v2.9.2, common v0.4.0 & tsdb v0.8.0. Changes from the upstreams: store gateway: [ENHANCEMENT] Fast path for EmptyPostings cases in Merge, Intersect and Without. store gateway & compactor: [BUGFIX] Fix fd and vm_area leak on error path in chunks.NewDirReader. [BUGFIX] Fix fd and vm_area leak on error path in index.NewFileReader. query: [BUGFIX] Make sure subquery range is taken into account for selection #5467 [ENHANCEMENT] Check for cancellation on every step of a range evaluation. #5131 [BUGFIX] Exponentation operator to drop metric name in result of operation. #5329 [BUGFIX] Fix output sample values for scalar-to-vector comparison operations. #5454 rule: [BUGFIX] Reload rules: copy state on both name and labels. #5368 breaking Removed Gossip implementation. All `--cluster.*` flags removed and Thanos will error out if any is provided. :warning: IMPORTANT :warning: This is the last release that supports gossip. From Thanos v0.5.0, gossip will be completely removed. This release also disables gossip mode by default for all components. See for more details. :warning: This release moves Thanos docker images (NOT artifacts by accident) to Golang 1.12. This release includes change in GC's memory release which gives following effect: On Linux, the runtime now uses MADVFREE to release unused memory. This is more efficient but may result in higher reported RSS. The kernel will reclaim the unused data when it is needed. To revert to the Go 1.11 behavior (MADVDONTNEED), set the environment variable GODEBUG=madvdontneed=1. If you want to see exact memory allocation of Thanos process: Use `gomemstatsheapallocbytes` metric exposed by Golang or `containermemoryworkingsetbytes` exposed by cadvisor. Add `GODEBUG=madvdontneed=1` before running Thanos binary to revert to memory releasing to pre 1.12 logic. Using cadvisor `containermemoryusage_bytes` metric could be misleading e.g: https://github.com/google/cadvisor/issues/2242 website & automation :tada: compactor: Compactor & store gateway now handles incomplete uploads gracefully. Added hard limit on how long block upload can take (30m). Remote write receiver component :heart: :heart: thanks to RedHat (@brancz) contribution. Query's stores UI page is now sorted by type and old DNS or File SD stores are removed after 5 minutes (configurable via the new `--store.unhealthy-timeout=5m` flag). Thanos support for Query API: /api/v1/labels. Notice that the API was added in Prometheus v2.6. Ability to limit the maximum number of concurrent request to Series() calls in Thanos Store and the maximum amount of samples we handle. Allow specifying region attribute in S3 storage configuration :warning: WARNING :warning: #798 adds a new default limit to Thanos Store: `--store.grpc.series-max-concurrency`. Most likely you will want to make it the same as `--query.max-concurrent` on Thanos Query. New options: New Store flags: ``` `--store.grpc.series-sample-limit` limits the amount of samples that might be retrieved on a single Series() call. By default it is 0. Consider enabling it by setting it to more than 0 if you are running on limited resources. `--store.grpc.series-max-concurrency` limits the number of concurrent Series() calls in Thanos Store. By default it is 20. Considering making it lower or bigger depending on the scale of your

``` New Store metrics: ``` `thanosbucketstorequeriesdropped_total` shows how many queries were dropped due to the samples limit; `thanosbucketstorequeriesconcurrent_max` is a constant metric which shows how many Series() calls can concurrently be executed by Thanos Store; `thanosbucketstorequeriesin_flight` shows how many queries are currently "in flight" i.e. they are being executed; `thanosbucketstoregateduration_seconds` shows how many seconds it took for queries to pass through the gate in both cases - when that fails and when it does not. ``` New Store tracing span: \* `storequerygate_ismyturn` shows how long it took for a query to pass (or not) through the gate. Added option for another DNS resolver (miekg/dns client). Note that this is required to have SRV resolution working on New Querier and Ruler flag: `-- store.sd-dns-resolver` which allows to specify resolver to use. Either `golang` or `miekgdns` Allow to save some startup & sync time in store gateway as it is no longer needed to compute index-cache from block index on its own for larger blocks. The store Gateway still can do it, but it first checks bucket if there is index-cached uploaded already. In the same time, compactor precomputes the index cache file on every compaction. New Compactor flag: `--index.generate-missing-cache-file` was added to allow quicker addition of index cache files. If enabled it precomputes missing files on compactor startup. Note that it will take time and it's only one-off step per bucket. Compact: Added new `--block-sync-concurrency` flag, which allows you to configure number of goroutines to use when syncing block metadata from object storage. Query: Added `--store.response-timeout` flag. If a Store doesn't send any data in this specified duration then a Store will be ignored and partial data will be returned if it's enabled. 0 disables timeout. S3 storage backend has graduated to `stable` maturity level. Azure storage backend has graduated to `stable` maturity level. S3: added trace functionality. You can add `trace.enable: true` to enable the minio client's verbose logging. Compact: now has a hidden flag `--debug.accept-malformed-index`. Compaction index verification will ignore out of order label names. GCS: added possibility to inline ServiceAccount into GCS config. Compact: added new flag `--compact.concurrency`. Number of goroutines to use when compacting groups. Query: added `--query.default-evaluation-interval`, which sets default evaluation interval for sub queries. Ability to override Azure storage endpoint for other regions (China) Query API `series` now supports POST method. Query API `query_range` now supports POST method. Deprecated `partialresponsedisabled` proto field. Added `partialresponsestrategy` instead. Both in gRPC and Query API. No `PartialResponseStrategy` field for `RuleGroups` by default means `abort` strategy (old PartialResponse disabled) as this is recommended option for Rules and alerts. Metrics: Added `thanosruleevaluationwithwarnings_total` to Ruler. DNS `thanosrulerqueryapis*` are now `thanosrulerqueryapis_*` for consistency. DNS `thanosquerierstoreapis*` are now `thanosquerierstoreapis*` for consistency. Query Gate `thanosbucketstoreseries*` are now `thanosbucketstoreseries_*` for consistency. Most of thanos ruler metris related to rule manager has `strategy` label. Ruler tracing spans: `/ruleinstantquery HTTP[client]` is now `/ruleinstantquerypartresp_abort HTTP[client]"` if request is for abort strategy. : Upgraded Prometheus (~v2.7.0-rc.0 to v2.8.1) and TSDB (`v0.4.0` to `v0.6.1`) deps. Changes that affects Thanos: query: [ENHANCEMENT] In histogram_quantile merge buckets with equivalent le values. #5158. [ENHANCEMENT] Show list of offending labels in the error message in many-to-many scenarios. #5189 [BUGFIX] Fix panic when aggregator param is not a literal. #5290 ruler: [ENHANCEMENT] Reduce time that Alertmanagers are in flux when reloaded. #5126 [BUGFIX] prometheusrulegrouplastevaluationtimestampseconds is now a unix timestamp. #5186 - [BUGFIX] Fix sorting of rule groups. #5260 store: [ENHANCEMENT] Fast path for EmptyPostings cases in Merge, Intersect and Without. tooling: [FEATURE] New dump command to tsdb tool to dump all samples. compactor: [ENHANCEMENT] When closing the db any running compaction will be cancelled so it doesn't

For ruler essentially whole TSDB CHANGELOG applies between v0.4.0-v0.6.1: https://github.com/prometheus/tsdb/blob/master/CHANGELOG.md Note that this was added on TSDB and Prometheus: [FEATURE] Time-ovelapping blocks are now allowed. #370 Whoever due to nature of Thanos compaction (distributed systems), for safety reason this is disabled for Thanos compactor for now. Go has been updated to 1.12. Gossip flags are now disabled by default and deprecated. repair: Repair process now sorts the series and labels within block. Store: index cache for requests. It now calculates the size properly (includes slice header), has anti-deadlock safeguard and reports more metrics. `thanosobjstorebucketlastsuccessfuluploadtime` now does not appear when no blocks have been uploaded so far. Bucket: verify no longer warns about overlapping blocks, that overlap `0s` Compact: now correctly works with time series with duplicate labels. Thanos Rule: UI now correctly shows evaluation time. Query: now properly parses DNS SRV Service Discovery. Store: added safeguard against merging posting groups segfault Sidecar: added better handling of intermediate restarts. Query: Fixed 30 seconds lag of adding new store to query. Sidecar: Make config reloader file writes atomic. Query: now advertises Min & Max Time accordingly to the nodes. Ruler is now able to return long time range queries. Compact: Skip compaction for blocks with no samples. Downsampling works back again. Deferred closer errors are now properly captured. New read API endpoint for api/v1/rules and api/v1/alerts. Store: fix set index cache LRU :warning: WARNING :warning: #873 fix fixes actual handling of `index-cache-size`. Handling of limit for this cache was broken so it was unbounded all the time. From this release actual value matters and is extremely low by default. To "revert" the old behaviour (no boundary), use a large enough value. Store Gateway matcher regression for intersecting with empty posting. Fixed race condition in sidecare between reloader and shipper. Store Gateway crashing due to `slice bounds out of range`. Store Gateway matcher regression for `<>` `!=`. Support for gzip compressed configuration files before envvar substitution for reloader package. `bucket inspect` command for better insights on blocks in object storage. Support for object storage. Partial Response disable option for StoreAPI and QueryAPI. Partial Response disable button on Thanos UI We have initial docs for goDoc documentation! Flags for Querier and Ruler UIs: `--web.route-prefix`, `--web.external-prefix`, `--web.prefix-header`. Details - Fixed store label values api to add also external label values. - Fixed sidecar logic for proxying series that has more than 2^16 samples from Prometheus. - Fixed S3 authentication sequence. You can see new sequence enumerated - Fixed race conditions and edge cases for Thanos Querier fanout logic. - Fixed index cache when asked buffer size is bigger than cache max size. Massive improvement for compactor. Downsampling memory consumption was reduce to only store labels and single chunks per each series. Qurerier UI: Store page now shows the store APIs per component type. Prometheus and TSDB deps are now up to date with ~2.7.0 Prometheus version. Lot's of things has changed. See details Known changes that affects us: prometheus/prometheus/discovery/file [ENHANCEMENT] Discovery: Improve performance of previously slow updates of changes of targets. #4526 [BUGFIX] Wait for service discovery to stop before exiting #4508 ?? prometheus/prometheus/promql: [ENHANCEMENT] Subqueries support. #4831 [BUGFIX] PromQL: Fix a goroutine leak in the lexer/parser. #4858 [BUGFIX] Change max/min over_time to handle NaNs properly. #438 [BUGFIX] Check label name for `count_values` PromQL function. #4585 [BUGFIX] Ensure that vectors and matrices do not contain identical label-sets. #4589 [ENHANCEMENT] Optimize PromQL aggregations #4248 [BUGFIX] Only add LookbackDelta to vector selectors #4399 [BUGFIX] Reduce floating point errors in stddev and related

#4533 prometheus/prometheus/rules: New metrics exposed! (prometheus evaluation!) [ENHANCEMENT] Rules: Error out at load time for invalid templates, rather than at evaluation time. #4537 prometheus/tsdb/index: Index reader optimizations. Thanos store gateway flag for sync concurrency (`block-sync-concurrency` with `20` default, so no change by default) S3 provider: Added `putusermetadata` option to config. Added `insecureskipverify` option to config. Tests against Prometheus below v2.2.1. This does not mean lack of support for those. Only that we don't tests the compatibility anymore. See for details. Relabel drop for Thanos Ruler to enable replica label drop and alert deduplication on AM side. Query: Stores UI page available at `/stores`. Thanos Rule Alertmanager DNS SD bug. DNS SD bug when having SRV results with different ports. Move handling of HA alertmanagers to be the same as Prometheus. Azure iteration implementation flaw. Next Thanos release adding support to new discovery method, gRPC mTLS and two new object store providers (Swift and Azure). Note lots of necessary breaking changes in flags that relates to bucket configuration. breaking: Removed all bucket specific flags as we moved to config files: --gcs-bucket=\<bucket\> --s3.bucket=\<bucket\> --s3.endpoint=\<api-url\> --s3.access-key=\<key\> --s3.insecure --s3.signature-version2 --s3.encrypt-sse --gcs-backup-bucket=\<bucket\> --s3-backup-bucket=\<bucket\> breaking: Removed support of those environment variables for bucket: S3_BUCKET S3_ENDPOINT S3ACCESSKEY S3_INSECURE S3SIGNATUREVERSION2 breaking: Removed provider specific bucket metrics e.g `thanosobjstoregcsbucketoperations_total` in favor of of generic bucket operation metrics. breaking: Added `thanos_` prefix to memberlist (gossip) metrics. Make sure to update your dashboards and rules. S3 provider: Set `"X-Amz-Acl": "bucket-owner-full-control"` metadata for s3 upload operation. Support for heterogeneous secure gRPC on StoreAPI. Handling of scalar result in rule node evaluating rules. Flag `--objstore.config-file` to reference to the bucket configuration file in yaml format. Detailed information can be found in document . File service discovery for StoreAPIs: In `thanos rule`, static configuration of query nodes via `--query` In `thanos rule`, file based discovery of query nodes using `--query.file-sd-config.files` In `thanos query`, file based discovery of store nodes using `--store.file-sd-config.files` `/-/healthy` endpoint to Querier. DNS service discovery to static and file based configurations using the `dns+` and `dnssrv+` prefixes for the respective lookup. Details `--cluster.disable` flag to disable gossip functionality completely. Hidden flag to configure max compaction level. Azure Storage. OpenStack Swift support. Thanos Ruler `thanosruleloaded_rules` metric. Option for JSON logger format. Issue whereby the Proxy Store could end up in a deadlock if there were more than 9 stores being queried and all returned an error. Ruler tracing causing panics. GatherIndexStats panics on duplicated chunks check. Clean up of old compact blocks on compact restart. Sidecar too frequent Prometheus reload. `thanoscompactorretries_total` metric not being registered. Initial version to have a stable reference before . Gossip layer for all components. StoreAPI gRPC proto. TSDB block upload logic for Sidecar. StoreAPI logic for Sidecar. Config and rule reloader logic for Sidecar. On-the fly result merge and deduplication logic for Querier. Custom Thanos UI (based mainly on Prometheus UI) for Querier. Optimized object storage fetch logic for Store. Index cache and chunk pool for Store for better memory usage. Stable support for Google Cloud Storage object storage. StoreAPI logic for Querier to support Thanos federation (experimental). Support for S3 minio-based AWS object storage (experimental). Compaction logic of blocks from multiple sources for Compactor. Optional Compaction fixed retention. Optional downsampling logic for Compactor (experimental). Rule (including alerts) evaluation logic for Ruler. Rule UI with hot rules reload. StoreAPI logic for Ruler. Basic metric orchestration for all components. Verify commands with potential fixes (experimental). Compact / Downsample offline commands. Bucket commands. Downsampling support for UI. Grafana dashboards for Thanos components.