From 15f632e3e50754c34a4399d20d0cce6c26487853 Mon Sep 17 00:00:00 2001 From: Friedrich Gonzalez <1517449+friedrichg@users.noreply.github.com> Date: Mon, 2 Mar 2026 16:57:28 -0800 Subject: [PATCH 1/2] Graduate stable features from experimental docs Remove the following long-stable features from the experimental features list in v1-guarantees.md: - Azure blob storage - Zone awareness based replication - Blocksconvert tools - Scalable query-frontend (when using query-scheduler) - Query-frontend: query stats tracking - Block deletion marks migration in compactor - HA Tracker: cleanup of old replicas from KV Store - Exemplar storage - Querier limits (max-fetched-chunks/bytes/series-per-query) - Compactor shuffle sharding Signed-off-by: Friedrich Gonzalez <1517449+friedrichg@users.noreply.github.com> --- docs/configuration/v1-guarantees.md | 14 -------------- 1 file changed, 14 deletions(-) diff --git a/docs/configuration/v1-guarantees.md b/docs/configuration/v1-guarantees.md index a7d9a8ded7c..82e1b671b19 100644 --- a/docs/configuration/v1-guarantees.md +++ b/docs/configuration/v1-guarantees.md @@ -39,8 +39,6 @@ Currently experimental features are: - Evaluate rules to query frontend instead of ingesters (enabled via `-ruler.frontend-address`). - When `-ruler.frontend-address` is specified, the response format can be specified (via `-ruler.query-response-format`). - S3 Server Side Encryption (SSE) using KMS (including per-tenant KMS config overrides). -- Azure blob storage. -- Zone awareness based replication. - Ruler API (to PUT rules). - Alertmanager: - API (enabled via `-experimental.alertmanager.enable-api`) @@ -51,31 +49,21 @@ Currently experimental features are: - gRPC Store. - TLS configuration in gRPC and HTTP clients. - TLS configuration in Etcd client. -- Blocksconvert tools - OpenStack Swift storage support. - Metric relabeling in the distributor. -- Scalable query-frontend (when using query-scheduler) - Ingester: do not unregister from ring on shutdown (`-ingester.unregister-on-shutdown=false`) - Distributor: - Do not extend writes on unhealthy ingesters (`-distributor.extend-writes=false`) - Accept multiple HA pairs in the same request (enabled via `-experimental.distributor.ha-tracker.mixed-ha-samples=true`) - Accept Prometheus remote write 2.0 request (`-distributor.remote-writev2-enabled=true`) - Tenant Deletion in Purger, for blocks storage. -- Query-frontend: query stats tracking (`-frontend.query-stats-enabled`) -- The block deletion marks migration support in the compactor (`-compactor.block-deletion-marks-migration-enabled`) is temporarily and will be removed in future versions - Blocks storage user index - Querier: tenant federation - `-tenant-federation.enabled` - `-tenant-federation.regex-matcher-enabled` - `-tenant-federation.user-sync-interval` - The thanosconvert tool for converting Thanos block metadata to Cortex -- HA Tracker: cleanup of old replicas from KV Store. - Instance limits in ingester and distributor -- Exemplar storage, currently in-memory only within the Ingester based on Prometheus exemplar storage (`-blocks-storage.tsdb.max-exemplars`) -- Querier limits: - - `-querier.max-fetched-chunks-per-query` - - `-querier.max-fetched-chunk-bytes-per-query` - - `-querier.max-fetched-series-per-query` - Alertmanager limits - notification rate (`-alertmanager.notification-rate-limit` and `-alertmanager.notification-rate-limit-per-integration`) - dispatcher groups (`-alertmanager.max-dispatcher-aggregation-groups`) @@ -96,8 +84,6 @@ Currently experimental features are: - `-alertmanager.sharding-ring.heartbeat-period=0` - `-compactor.ring.heartbeat-period=0` - `-store-gateway.sharding-ring.heartbeat-period=0` -- Compactor shuffle sharding - - Enabled via `-compactor.sharding-enabled=true`, `-compactor.sharding-strategy=shuffle-sharding`, and `-compactor.tenant-shard-size` set to a value larger than 0. - Vertical sharding at query frontend for range/instant queries - `-frontend.query-vertical-shard-size` (int) CLI flag - `query_vertical_shard_size` (int) field in runtime config file From cd5dfacb9619fdbce36fdb634813529916167c51 Mon Sep 17 00:00:00 2001 From: Friedrich Gonzalez <1517449+friedrichg@users.noreply.github.com> Date: Wed, 4 Mar 2026 00:28:45 -0800 Subject: [PATCH 2/2] Apply suggestion from @friedrichg Signed-off-by: Friedrich Gonzalez <1517449+friedrichg@users.noreply.github.com> --- docs/configuration/v1-guarantees.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/configuration/v1-guarantees.md b/docs/configuration/v1-guarantees.md index d58b66a540a..77e23d7d966 100644 --- a/docs/configuration/v1-guarantees.md +++ b/docs/configuration/v1-guarantees.md @@ -61,7 +61,6 @@ Currently experimental features are: - `-tenant-federation.regex-matcher-enabled` - `-tenant-federation.user-sync-interval` - The thanosconvert tool for converting Thanos block metadata to Cortex -- Instance limits in ingester and distributor - Alertmanager limits - notification rate (`-alertmanager.notification-rate-limit` and `-alertmanager.notification-rate-limit-per-integration`) - dispatcher groups (`-alertmanager.max-dispatcher-aggregation-groups`)