Curate the 1.22.0 changelog by CharlieTLe · Pull Request #7787 · cortexproject/cortex

CharlieTLe · 2026-08-20T01:15:20Z

Groundwork for the v1.22.0 release (rc.0 scheduled 2026-09-12 per RELEASE.md). Gets the
unreleased section into the shape RELEASE.md asks for before the release-1.22 cut,
so operators reading the release notes actually see the changes that affect them.

CHANGELOG.md only.

Mechanical

Delete the stale duplicate of #7375, which already shipped in 1.21.0 as #7370
(byte-identical text, only the PR number differs).
Re-sort into CHANGE → FEATURE → ENHANCEMENT → BUGFIX per RELEASE.md. The
section previously opened with a FEATURE sitting above three CHANGEs.
Correct the gRPC entry: the bump landed at v1.82.1 (go.mod confirms), not v1.79.3.
Fold follow-up PRs into the entry they belong to: #5449 #7687, #7302 #7458,
#7691 #7505 #7740, #7437 #7434 #7716 #7726, #7460 #7719.

Missing user-facing entries

From ./tools/release/check-changelog.sh v1.21.1...master. Everything else it lists is
correctly omitted (CI, tests, docs, dependabot).

#7513 — Alertmanager: removal of the legacy state-file migration.
#7514 — cortex_ingester_head_metric_names.
#7559 — DoBatch cleanup callback deadlock on panic.

Reclassified as CHANGE

These are breaking changes that were filed as BUGFIX/ENHANCEMENT, so they would not
have appeared in the upgrade notes:

#7587 sign-key validation — its own text already says "fail at process startup; audit
your configs before upgrading".
#7767 + #7768 Alertmanager per-tenant *_file rejection — merged into one entry;
tenant configs that previously loaded are now rejected.
#7649 time_taken → time_taken_ms — renames and re-units a slow-query-log field.

Kept in place, with operator impact noted

#7637 alpine → distroless. Not config or API, so not a CHANGE by house convention,
but the image has no shell — noted that shell-based probes, init scripts and
kubectl exec workflows need adjusting.
#7717 / #7738 500 → 499. A genuine bugfix, but it deflates
cortex_request_duration_seconds{status_code="500"} and changes SLO math.

Result

7 CHANGE / 14 FEATURE / 37 ENHANCEMENT / 34 BUGFIX = 92 entries (from 91).

Merging this first keeps the other release-prep PRs from all conflicting at the top of the
file.

Get the unreleased section into the shape RELEASE.md asks for before the release-1.22 cut, so operators reading the notes see the changes that affect them: - Delete the stale duplicate of cortexproject#7375, which already shipped in 1.21.0 as cortexproject#7370. - Re-sort into CHANGE -> FEATURE -> ENHANCEMENT -> BUGFIX. - Correct the gRPC entry: the bump landed at v1.82.1, not v1.79.3. - Fold follow-up PRs into the entry they belong to. - Add three missing user-facing entries: cortexproject#7513, cortexproject#7514 and cortexproject#7559. - Reclassify as CHANGE the entries that break existing configs or log consumers: the sign-key validation (cortexproject#7587), the Alertmanager per-tenant *_file rejections (cortexproject#7767, cortexproject#7768, now one entry) and the time_taken -> time_taken_ms rename (cortexproject#7649). - Note the operator impact of the distroless base image (cortexproject#7637) and of the 500 -> 499 reclassification (cortexproject#7717). Rebased onto master, which added eight entries after this was first written. They are curated the same way: - Sorted into their categories: the deprecated flag removal (cortexproject#7790) and the max-exemplars deprecation (cortexproject#7793) under CHANGE, the X-Grafana-User query log (cortexproject#7799) under ENHANCEMENT, the YAML zero-value validation (cortexproject#7700) and the ReadPartitionedGroupInfo error handling (cortexproject#7766) under BUGFIX. - Folded the Go toolchain bump (cortexproject#7807, cortexproject#7814) into the existing build image entry, which now reads 1.27.0 rather than carrying a second entry for it. - Folded cortexproject#7745 into cortexproject#7698: both are the same wipe-on-transient-DNS-failure bug, cortexproject#7698 on the A record path and cortexproject#7745 on the SRV path. - Folded cortexproject#7743 into cortexproject#7640: both are panics in the active request tracker's truncation of match[]/query values. Signed-off-by: Charlie Le <charlie_le@apple.com>

SungJin1212 · 2026-09-08T23:36:01Z

 * [ENHANCEMENT] Parquet: Add `-blocks-storage.bucket-store.parquet-query-concurrency` flag to configure the maximum number of concurrent goroutines applied at each level of parquet query processing in store-gateway: shard querying, row group processing, and column materialization. #7613
 * [ENHANCEMENT] Parquet: Add a row ranges cache for parquet query filtering in querier and store-gateway. #7478
 * [ENHANCEMENT] Ingester: Add `cortex_ingester_ingestion_delay_seconds` native histogram metric to track the delay between sample ingestion time and sample timestamp. #7443
 * [ENHANCEMENT] Ingester: Add WAL record metrics to help evaluate the effectiveness of WAL compression type (e.g. snappy, zstd): `cortex_ingester_tsdb_wal_record_part_writes_total`, `cortex_ingester_tsdb_wal_record_parts_bytes_written_total`, and `cortex_ingester_tsdb_wal_record_bytes_saved_total`. #7420


It would be good if we added the following bug-fix PR.

Suggested change

* [ENHANCEMENT] Cache: Add per-tenant TTL configuration for query results cache to control cache expiration on a per-tenant basis with separate TTLs for regular and out-of-order data. #7357 #7775

SungJin1212 · 2026-09-08T23:40:04Z

 * [ENHANCEMENT] Compactor: Prevent partition compaction to compact any blocks marked for deletion. #7391
 * [ENHANCEMENT] Distributor: Optimize memory allocations by reusing the existing capacity of these pooled slices in the Prometheus Remote Write 2.0 path. #7392
-* [ENHANCEMENT] Upgrade gRPC from v1.71.2 to v1.79.3 to address CVE-2026-33186. #7460
+* [ENHANCEMENT] Upgrade gRPC from v1.71.2 to v1.82.1 to address CVE-2026-33186. #7460 #7719


The 7460 is an issue number; the PR number is 7463.

Suggested change

* [ENHANCEMENT] Upgrade gRPC from v1.71.2 to v1.82.1 to address CVE-2026-33186. #7460 #7719

* [ENHANCEMENT] Upgrade gRPC from v1.71.2 to v1.82.1 to address CVE-2026-33186. #7463 #7719

SungJin1212 · 2026-09-08T23:43:05Z

 ## master / unreleased
-* [ENHANCEMENT] Query Frontend: Log `X-Grafana-User` header in query stats, slow query, and query request logs when Grafana's `send_user_header` is enabled. #7799
-* [FEATURE] Engine: Add `-querier.selector-batch-size` and `-ruler.selector-batch-size` flags to configure series batching in the Thanos promQL engine. 0 disables batching. #7763
+* [CHANGE] Querier: Make query time range configurations per-tenant: `query_ingesters_within`, `query_store_after`, and `shuffle_sharding_ingesters_lookback_period`. Uses `model.Duration` instead of `time.Duration` to support serialization but has minimum unit of 1ms (nanoseconds/microseconds not supported). #7160


The 7160 is an issue number; the PR number is 7323.

Suggested change

* [CHANGE] Querier: Make query time range configurations per-tenant: `query_ingesters_within`, `query_store_after`, and `shuffle_sharding_ingesters_lookback_period`. Uses `model.Duration` instead of `time.Duration` to support serialization but has minimum unit of 1ms (nanoseconds/microseconds not supported). #7160

* [CHANGE] Querier: Make query time range configurations per-tenant: `query_ingesters_within`, `query_store_after`, and `shuffle_sharding_ingesters_lookback_period`. Uses `model.Duration` instead of `time.Duration` to support serialization but has minimum unit of 1ms (nanoseconds/microseconds not supported). #7323

SungJin1212 · 2026-09-08T23:44:58Z

 * [ENHANCEMENT] Ingester: Add WAL record metrics to help evaluate the effectiveness of WAL compression type (e.g. snappy, zstd): `cortex_ingester_tsdb_wal_record_part_writes_total`, `cortex_ingester_tsdb_wal_record_parts_bytes_written_total`, and `cortex_ingester_tsdb_wal_record_bytes_saved_total`. #7420
 * [ENHANCEMENT] Distributor: Introduce dynamic `Symbols` slice capacity pooling. #7398 #7401
 * [ENHANCEMENT] Metrics Helper: Add native histogram support for aggregating and merging, including dual-format histogram handling that exposes both native and classic bucket formats. #7359
 * [ENHANCEMENT] Cache: Add per-tenant TTL configuration for query results cache to control cache expiration on a per-tenant basis with separate TTLs for regular and out-of-order data. #7357


It would be good to add the following bug-fix PR.

Suggested change

* [ENHANCEMENT] Cache: Add per-tenant TTL configuration for query results cache to control cache expiration on a per-tenant basis with separate TTLs for regular and out-of-order data. #7357

* [ENHANCEMENT] Cache: Add per-tenant TTL configuration for query results cache to control cache expiration on a per-tenant basis with separate TTLs for regular and out-of-order data. #7357 #7775

pull-request-size Bot added the size/S label Aug 20, 2026

dosubot Bot added the type/chore Something that needs to be done; not a bug or a feature label Aug 20, 2026

CharlieTLe mentioned this pull request Aug 20, 2026

Refresh the Thanos and promql-engine pins and document why they are pinned to main #7788

Merged

CharlieTLe requested review from a team and yeya24 and removed request for a team August 20, 2026 19:09

CharlieTLe force-pushed the release-1.22-pr-e-changelog-curation branch from b95bbba to abdd6c9 Compare September 1, 2026 22:12

CharlieTLe requested a review from a team as a code owner September 1, 2026 22:12

pull-request-size Bot added size/M and removed size/S labels Sep 1, 2026

CharlieTLe force-pushed the release-1.22-pr-e-changelog-curation branch from abdd6c9 to b8cbe5b Compare September 2, 2026 18:23

CharlieTLe requested a review from SungJin1212 September 8, 2026 18:14

SungJin1212 reviewed Sep 8, 2026

View reviewed changes

Navigation Menu

Uh oh!

Curate the 1.22.0 changelog - #7787

Curate the 1.22.0 changelog#7787
CharlieTLe wants to merge 1 commit into
cortexproject:masterfrom
CharlieTLe:release-1.22-pr-e-changelog-curation

CharlieTLe commented Aug 20, 2026

Uh oh!

SungJin1212 Sep 8, 2026

Uh oh!

SungJin1212 Sep 8, 2026

Uh oh!

SungJin1212 Sep 8, 2026

Uh oh!

SungJin1212 Sep 8, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants


	* [ENHANCEMENT] Cache: Add per-tenant TTL configuration for query results cache to control cache expiration on a per-tenant basis with separate TTLs for regular and out-of-order data. #7357 #7775

	* [ENHANCEMENT] Upgrade gRPC from v1.71.2 to v1.82.1 to address CVE-2026-33186. #7460 #7719
	* [ENHANCEMENT] Upgrade gRPC from v1.71.2 to v1.82.1 to address CVE-2026-33186. #7463 #7719

	* [CHANGE] Querier: Make query time range configurations per-tenant: `query_ingesters_within`, `query_store_after`, and `shuffle_sharding_ingesters_lookback_period`. Uses `model.Duration` instead of `time.Duration` to support serialization but has minimum unit of 1ms (nanoseconds/microseconds not supported). #7160
	* [CHANGE] Querier: Make query time range configurations per-tenant: `query_ingesters_within`, `query_store_after`, and `shuffle_sharding_ingesters_lookback_period`. Uses `model.Duration` instead of `time.Duration` to support serialization but has minimum unit of 1ms (nanoseconds/microseconds not supported). #7323

Uh oh!

Conversation

CharlieTLe commented Aug 20, 2026

Mechanical

Missing user-facing entries

Reclassified as CHANGE

Kept in place, with operator impact noted

Result

Uh oh!

SungJin1212 Sep 8, 2026

Choose a reason for hiding this comment

Uh oh!

SungJin1212 Sep 8, 2026

Choose a reason for hiding this comment

Uh oh!

SungJin1212 Sep 8, 2026

Choose a reason for hiding this comment

Uh oh!

SungJin1212 Sep 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

SungJin1212 Sep 8, 2026 •

edited

Loading