Skip to content

Navigation Menu

Sign in
Sign up

Curate the 1.22.0 changelog - #7787

Open
CharlieTLe wants to merge 2 commits into
cortexproject:master from
CharlieTLe:release-1.22-pr-e-changelog-curation
Open

Curate the 1.22.0 changelog #7787
CharlieTLe wants to merge 2 commits into
cortexproject:master from
CharlieTLe:release-1.22-pr-e-changelog-curation

Conversation

@CharlieTLe

@CharlieTLe CharlieTLe commented Aug 20, 2026

Copy link
Copy Markdown
Member

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.

@dosubot dosubot Bot added the type/chore Something that needs to be done; not a bug or a feature label Aug 20, 2026
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
CharlieTLe force-pushed the release-1.22-pr-e-changelog-curation branch from abdd6c9 to b8cbe5b Compare September 2, 2026 18:23
Comment thread CHANGELOG.md
* [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

@SungJin1212 SungJin1212 Sep 8, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Comment thread CHANGELOG.md
* [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

@SungJin1212 SungJin1212 Sep 8, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Comment thread CHANGELOG.md Outdated
Comment thread CHANGELOG.md Outdated 
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.
Rebased again onto master, which added eight more entries. Same treatment:
- Sorted into their categories: the evaluation-delay-duration removal (cortexproject#7792)
 and the fifocache/ingester-metadata-streaming removals (cortexproject#7791) under CHANGE,
 the parquet max-block-label-names limit (cortexproject#7625), the non-pointer
 HistogramBucket slice (cortexproject#7809) and the merge iterator BatchSize (cortexproject#7823) under
 ENHANCEMENT, and the CSV-list empty-string fix (cortexproject#7714) under BUGFIX.
- Folded the Thanos/promql-engine refresh (cortexproject#7788) into the existing upgrade
 entry, which already carries cortexproject#7691, cortexproject#7505 and cortexproject#7740.
Signed-off-by: Charlie Le <charlie_le@apple.com>
CharlieTLe force-pushed the release-1.22-pr-e-changelog-curation branch from e7b6b98 to e28a814 Compare September 11, 2026 17:41 
Co-authored-by: SungJin1212 <tjdwls1201@gmail.com>
Signed-off-by: Charlie Le <charlie_le@apple.com>
CharlieTLe force-pushed the release-1.22-pr-e-changelog-curation branch from e28a814 to 612e5e3 Compare September 11, 2026 17:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@SungJin1212 SungJin1212 SungJin1212 left review comments
@yeya24 yeya24 Awaiting requested review from yeya24 yeya24 is a code owner automatically assigned from cortexproject/maintainers

At least 1 approving review is required to merge this pull request.

Assignees

No one assigned

Labels

size/M type/chore Something that needs to be done; not a bug or a feature

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

AltStyle によって変換されたページ (->オリジナル) /