Release Notes for v2.8 #4740

lamida · 2023-04-17T02:56:39Z

Release note for Mimir 2.8.

See #4739.

RC Release Notes

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

pstibrany · 2023-04-17T06:57:26Z

docs/sources/mimir/release-notes/v2.8.md

@@ -13,10 +13,42 @@ The highlights that follow include the top features, enhancements, and bugfixes

 ## Features and enhancements

-### Alertmanager improvements
+- **Changed default value of block storage retention period** The new default value for `-blocks-storage.tsdb.retention-period` is `13h`.


What was it before?

I will put the previous value.

pstibrany · 2023-04-17T07:00:14Z

docs/sources/mimir/release-notes/v2.8.md

+- Querier: Streaming remote read will now continue to return multiple chunks per frame after the first frame. [PR 4423](https://github.com/grafana/mimir/pull/4423)
+- Store-gateway: the values for stage="processed" for the metrics cortex_bucket_store_series_data_touched and cortex_bucket_store_series_data_size_touched_bytes when using fine-grained chunks caching is now reporting the correct values of chunks held in memory. [PR 4449](https://github.com/grafana/mimir/pull/4449)
+- Compactor: fixed reporting a compaction error when compactor is correctly shut down while populating blocks. [PR 4580](https://github.com/grafana/mimir/pull/4580)
+- OTLP: Do not drop exemplars of the OTLP Monotonic Sum metric. [4063](https://github.com/grafana/mimir/pull/4063)
+- Packaging: flag /etc/default/mimir and /etc/sysconfig/mimir as config to prevent overwrite. [PR 4587](https://github.com/grafana/mimir/pull/4587)
+- Query-frontend: don't retry queries which error inside PromQL. [PR 4643](https://github.com/grafana/mimir/pull/4643)
+- Store-gateway & query-frontend: report more consistent statistics for fetched index bytes. [PR 4671](https://github.com/grafana/mimir/pull/4671)
+- Native histograms: fix how IsFloatHistogram determines if mimirpb.Histogram is a float histogram. [PR 4706](https://github.com/grafana/mimir/pull/4706)
+- Query-frontend: fix query sharding for native histograms. [PR 4666](https://github.com/grafana/mimir/pull/4666)
+- Ring status page: fixed the owned tokens percentage value displayed. [PR 4730](https://github.com/grafana/mimir/pull/4730)
+- Querier: fixed chunkIterator may return values after Seek beyond end of chunk. [PR 4450](https://github.com/grafana/mimir/pull/4450)


Are we including all bug fixes here now? I think we should refer people to check the changelog, and only highlight most important bugfixes here.

I will remove small bugfixes just leave out the important bugfixes in this section.

docs/sources/mimir/release-notes/v2.8.md

Co-authored-by: Peter Štibraný <pstibrany@gmail.com>

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

lamida · 2023-04-17T10:40:08Z

The CHANGELOG has just been cut to prepare for the next Mimir release. Please rebase main and eventually move the CHANGELOG entry added / updated in this PR to the top of the CHANGELOG document. Thanks!

charleskorn · 2023-04-18T00:28:08Z

docs/sources/mimir/release-notes/v2.8.md

+
+## Features and enhancements
+
+- **Changed default value of block storage retention period** The default value for `-blocks-storage.tsdb.retention-period` was `24h` and now is `13h`.


It's not clear to me why this is a feature / enhancement - why would a user care about this? (eg. it reduces disk space requirements for ingesters)

On a second look, you're right. This is just a simple change that we don't need to put here. However, maybe it is better to put in important changes section, because maybe there are some users that rely onto this default value.

charleskorn · 2023-04-18T00:30:33Z

docs/sources/mimir/release-notes/v2.8.md

+## Features and enhancements
+
+- **Changed default value of block storage retention period** The default value for `-blocks-storage.tsdb.retention-period` was `24h` and now is `13h`.
+- **Query-frontend cached results now contain timestamp** This allows Mimir to check if cached results are still valid based on current TTL configured for tenant. Results cached by previous Mimir version are used until they expire from cache, which can take up to 7 days. If you need to use per-tenant TTL sooner, please flush results cache manually.


Is this one of the top four most important features in this release? Seems like an important change that improves correctness, but I wonder if there are more important changes.

I will look again into the changelog. Those three are things that caught my eye. Please suggest if you have some points to place there.

docs/sources/mimir/release-notes/v2.8.md

charleskorn · 2023-04-18T00:35:57Z

docs/sources/mimir/release-notes/v2.8.md

+- Querier: Streaming remote read will now continue to return multiple chunks per frame after the first frame. [PR 4423](https://github.com/grafana/mimir/pull/4423)
+- Query-frontend: don't retry queries which error inside PromQL. [PR 4643](https://github.com/grafana/mimir/pull/4643)
+- Store-gateway & query-frontend: report more consistent statistics for fetched index bytes. [PR 4671](https://github.com/grafana/mimir/pull/4671)
+- Native histograms: fix how IsFloatHistogram determines if mimirpb.Histogram is a float histogram. [PR 4706](https://github.com/grafana/mimir/pull/4706)


This seems very low level, was this user visible in some way?

not really, yeah, let's remove.

I will also remove this.

charleskorn · 2023-04-18T00:36:52Z

docs/sources/mimir/release-notes/v2.8.md

+
+The following experimental options and features are now stable:
+
+- Use protobuf internal query result payload format by default.


Also, while I'm biased, this might be worthy of being highlighted in the "features and enhancements" section 🙂

Actually it is a good addition :)

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

Co-authored-by: Charles Korn <charleskorn@users.noreply.github.com>

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

…tion Signed-off-by: Jon Kartago Lamida <me@lamida.net>

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

docs/sources/mimir/release-notes/v2.8.md

Co-authored-by: George Krajcsovits <krajorama@users.noreply.github.com>

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

pracucci · 2023-04-28T12:16:54Z

docs/sources/mimir/release-notes/v2.8.md

+
+## Features and enhancements
+
+- **Query-frontend and ruler now use protobuf internal query result payload format by default**.


@charleskorn Can you help to add more color to this? What's the benefit?

I'd add something like: "This reduces the CPU and memory utilisation of the querier, query-frontend and ruler, as well as reducing network bandwidth consumed between these components."

docs/sources/mimir/release-notes/v2.8.md

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

pianohacker · 2023-05-02T20:39:14Z

docs/sources/mimir/release-notes/v2.8.md

+- **Experimental support for using Redis as cache** Mimir now can use Redis for caching results, chunks, index and metadata.
+- **Experimental support for fetching secret from Vault for TLS configuration**.
+- **Experimental support for querying native histograms**. This support is not finalized as the related Prometheus API is also experimental, thus the exact behavior might change in future releases.


These should be moved to the top; they're experimental, but have the most customer relevance.

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

* Add release note md for 2.8 Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Fix the title Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Add some note in the release note Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Update docs/sources/mimir/release-notes/v2.8.md Co-authored-by: Peter Štibraný <pstibrany@gmail.com> * Apply PR feedback Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Small adjustment Signed-off-by: Jon Kartago Lamida <me@lamida.net> * More small adjustment Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Add config removal in release note Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Update docs/sources/mimir/release-notes/v2.8.md Co-authored-by: Charles Korn <charleskorn@users.noreply.github.com> * Update docs/sources/mimir/release-notes/v2.8.md Co-authored-by: Charles Korn <charleskorn@users.noreply.github.com> * Move out non feature/enhancement changes Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Remove native histogram from bugs and add protobuf to enhancement section Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Add msi-resource into release note deprecation note Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Update docs/sources/mimir/release-notes/v2.8.md Co-authored-by: George Krajcsovits <krajorama@users.noreply.github.com> * Update docs/sources/mimir/release-notes/v2.8.md Co-authored-by: George Krajcsovits <krajorama@users.noreply.github.com> * Update docs/sources/mimir/release-notes/v2.8.md Co-authored-by: George Krajcsovits <krajorama@users.noreply.github.com> * Run make doc Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Apply recent PR feedbacks Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Move experimental to the top of release note Signed-off-by: Jon Kartago Lamida <me@lamida.net> --------- Signed-off-by: Jon Kartago Lamida <me@lamida.net> Co-authored-by: Peter Štibraný <pstibrany@gmail.com> Co-authored-by: Charles Korn <charleskorn@users.noreply.github.com> Co-authored-by: George Krajcsovits <krajorama@users.noreply.github.com> (cherry picked from commit ae9978b)

* Add release note md for 2.8 Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Fix the title Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Add some note in the release note Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Update docs/sources/mimir/release-notes/v2.8.md Co-authored-by: Peter Štibraný <pstibrany@gmail.com> * Apply PR feedback Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Small adjustment Signed-off-by: Jon Kartago Lamida <me@lamida.net> * More small adjustment Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Add config removal in release note Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Update docs/sources/mimir/release-notes/v2.8.md Co-authored-by: Charles Korn <charleskorn@users.noreply.github.com> * Update docs/sources/mimir/release-notes/v2.8.md Co-authored-by: Charles Korn <charleskorn@users.noreply.github.com> * Move out non feature/enhancement changes Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Remove native histogram from bugs and add protobuf to enhancement section Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Add msi-resource into release note deprecation note Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Update docs/sources/mimir/release-notes/v2.8.md Co-authored-by: George Krajcsovits <krajorama@users.noreply.github.com> * Update docs/sources/mimir/release-notes/v2.8.md Co-authored-by: George Krajcsovits <krajorama@users.noreply.github.com> * Update docs/sources/mimir/release-notes/v2.8.md Co-authored-by: George Krajcsovits <krajorama@users.noreply.github.com> * Run make doc Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Apply recent PR feedbacks Signed-off-by: Jon Kartago Lamida <me@lamida.net> * Move experimental to the top of release note Signed-off-by: Jon Kartago Lamida <me@lamida.net> --------- Signed-off-by: Jon Kartago Lamida <me@lamida.net> Co-authored-by: Peter Štibraný <pstibrany@gmail.com> Co-authored-by: Charles Korn <charleskorn@users.noreply.github.com> Co-authored-by: George Krajcsovits <krajorama@users.noreply.github.com> (cherry picked from commit ae9978b) Co-authored-by: Jon Kartago Lamida <jon.lamida@grafana.com>

Add release note md for 2.8

3ddb641

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

lamida mentioned this pull request Apr 17, 2023

Release 2.8.0 #4739

Closed

30 tasks

lamida added 2 commits April 17, 2023 11:02

Fix the title

6f58718

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

Add some note in the release note

ad1b6cc

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

pstibrany reviewed Apr 17, 2023

View reviewed changes

lamida and others added 4 commits April 17, 2023 16:45

Update docs/sources/mimir/release-notes/v2.8.md

ecea48f

Co-authored-by: Peter Štibraný <pstibrany@gmail.com>

Apply PR feedback

f51d630

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

Small adjustment

d49bb46

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

More small adjustment

63516fc

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

lamida marked this pull request as ready for review April 17, 2023 09:51

lamida requested review from a team as code owners April 17, 2023 09:51

lamida added the release/notified-changelog-cut label Apr 17, 2023

charleskorn reviewed Apr 18, 2023

View reviewed changes

lamida and others added 6 commits April 21, 2023 18:05

Add config removal in release note

435f251

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

Update docs/sources/mimir/release-notes/v2.8.md

49d5989

Co-authored-by: Charles Korn <charleskorn@users.noreply.github.com>

Update docs/sources/mimir/release-notes/v2.8.md

e6e1f2c

Co-authored-by: Charles Korn <charleskorn@users.noreply.github.com>

Move out non feature/enhancement changes

964c19e

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

Remove native histogram from bugs and add protobuf to enhancement sec…

825168a

…tion Signed-off-by: Jon Kartago Lamida <me@lamida.net>

Add msi-resource into release note deprecation note

9d01a0f

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

krajorama reviewed Apr 21, 2023

View reviewed changes

docs/sources/mimir/release-notes/v2.8.md Outdated Show resolved Hide resolved

docs/sources/mimir/release-notes/v2.8.md Outdated Show resolved Hide resolved

docs/sources/mimir/release-notes/v2.8.md Show resolved Hide resolved

lamida and others added 4 commits April 22, 2023 01:47

Update docs/sources/mimir/release-notes/v2.8.md

ef26a1f

Co-authored-by: George Krajcsovits <krajorama@users.noreply.github.com>

Update docs/sources/mimir/release-notes/v2.8.md

705b676

Co-authored-by: George Krajcsovits <krajorama@users.noreply.github.com>

Update docs/sources/mimir/release-notes/v2.8.md

c101a90

Co-authored-by: George Krajcsovits <krajorama@users.noreply.github.com>

Run make doc

816e9dd

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

pracucci reviewed Apr 28, 2023

View reviewed changes

Apply recent PR feedbacks

912aeee

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

pianohacker reviewed May 2, 2023

View reviewed changes

Move experimental to the top of release note

1dcc10c

Signed-off-by: Jon Kartago Lamida <me@lamida.net>

pstibrany approved these changes May 3, 2023

View reviewed changes

pstibrany merged commit ae9978b into main May 3, 2023

pstibrany deleted the lamida/release-note-2.8 branch May 3, 2023 07:49

lamida added the backport release-2.8 label May 3, 2023

grafanabot mentioned this pull request May 3, 2023

[release-2.8] Release Notes for v2.8 #4901

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Release Notes for v2.8 #4740

Release Notes for v2.8 #4740

lamida commented Apr 17, 2023 •

edited

Loading

pstibrany Apr 17, 2023

lamida Apr 17, 2023

pstibrany Apr 17, 2023

lamida Apr 17, 2023 •

edited

Loading

lamida commented Apr 17, 2023

charleskorn Apr 18, 2023

lamida Apr 21, 2023 •

edited

Loading

charleskorn Apr 18, 2023

lamida Apr 21, 2023

charleskorn Apr 18, 2023

krajorama Apr 21, 2023

lamida Apr 21, 2023

charleskorn Apr 18, 2023

lamida Apr 21, 2023

pracucci Apr 28, 2023

charleskorn May 1, 2023

pianohacker May 2, 2023


		## Features and enhancements

		- Changed default value of block storage retention period The default value for `-blocks-storage.tsdb.retention-period` was `24h` and now is `13h`.


		The following experimental options and features are now stable:

		- Use protobuf internal query result payload format by default.


		## Features and enhancements

		- Query-frontend and ruler now use protobuf internal query result payload format by default.

Release Notes for v2.8 #4740

Release Notes for v2.8 #4740

Conversation

lamida commented Apr 17, 2023 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

lamida Apr 17, 2023 • edited Loading

Choose a reason for hiding this comment

lamida commented Apr 17, 2023

Choose a reason for hiding this comment

lamida Apr 21, 2023 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

lamida commented Apr 17, 2023 •

edited

Loading

lamida Apr 17, 2023 •

edited

Loading

lamida Apr 21, 2023 •

edited

Loading