Skip to content

Commit ddc27d8

Browse files
authored
Add release notes for 3.0 (#13082)
This PR contains release notes for Mimir 3.0. #### What this PR does #### Which issue(s) this PR fixes or relates to Fixes grafana/mimir-squad#3094 #### Checklist - [ ] Tests updated. - [X] Documentation added. - [X] `CHANGELOG.md` updated - the order of entries should be `[CHANGE]`, `[FEATURE]`, `[ENHANCEMENT]`, `[BUGFIX]`. If changelog entry is not needed, please add the `changelog-not-needed` label to the PR. - [ ] [`about-versioning.md`](https://github.com/grafana/mimir/blob/main/docs/sources/mimir/configure/about-versioning.md) updated with experimental features.
1 parent 3c63e36 commit ddc27d8

File tree

1 file changed

+64
-0
lines changed
  • docs/sources/mimir/release-notes

1 file changed

+64
-0
lines changed
Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
---
2+
title: "Grafana Mimir version 3.0 release notes"
3+
menuTitle: "V3.0 release notes"
4+
description: "Release notes for Grafana Mimir version 3.0"
5+
weight: 1100
6+
---
7+
8+
# Grafana Mimir version 3.0 release notes
9+
10+
<!-- vale Grafana.GoogleWill = NO -->
11+
<!-- vale Grafana.Timeless = NO -->
12+
<!-- Release notes are often future focused -->
13+
14+
Grafana Labs is excited to announce version 3.0 of Grafana Mimir.
15+
16+
The highlights that follow include the top features, enhancements, and bug fixes in this release. For the complete list of changes, refer to the [CHANGELOG](https://github.com/grafana/mimir/blob/main/CHANGELOG.md).
17+
18+
## Features and enhancements
19+
20+
Grafana Mimir version 3.0 includes the following key features and enhancements.
21+
22+
### Ingest storage architecture
23+
24+
Mimir 3.0 introduces ingest storage architecture, a next-generation architecture that separates the read and write paths using a Kafka-based ingest storage layer. In previous versions, the ingester handled both ingestion and querying, which could cause contention under heavy query loads. By introducing Kafka as an asynchronous buffer between ingestion and query, reads and writes now scale independently. This design improves ingestion stability, query performance, and operational flexibility for large deployments.
25+
26+
Note that in Grafana Mimir version 3.0, classic architecture is still supported.
27+
28+
### Mimir Query Engine (MQE)
29+
30+
The Mimir Query Engine (MQE) is now the default query engine for all queriers and query-frontends. MQE is fully PromQL-compatible and processes data in a streaming fashion, reducing peak memory usage by up to 92% compared to the Prometheus engine. You can expect faster, more stable query performance and lower resource consumption under load.
31+
32+
### Additional improvements
33+
34+
Grafana Mimir 3.0 also includes:
35+
36+
- Optimizations to MQE for histogram queries and query rewrites
37+
- Improvements to query planning in frontends and queriers
38+
- General stability and performance updates across core components
39+
40+
## Important changes
41+
42+
Grafana Mimir 3.0 introduces several updates that change default behavior and configuration. Review these changes before upgrading:
43+
44+
- Ingest storage architecture: Grafana Mimir now uses a Kafka-based ingest storage layer that separates reads and writes. This change improves performance by altering data flow between components.
45+
- MQE as the default engine: MQE replaces the Prometheus engine as the default query engine. To continue using the Prometheus engine, set `-querier.query-engine=prometheus`.
46+
- Removal of experimental features: Some deprecated and experimental flags, including the read-write deployment mode, have been removed.
47+
- Configuration updates: Some deprecated CLI flags and configuration options have been removed or renamed.
48+
49+
## Experimental features
50+
51+
Grafana Mimir 3.0 includes some features that are experimental and disabled by default. Use these features with caution and report any issues that you encounter:
52+
53+
- Prometheus Remote-Write 2.0 protocol
54+
- PromQL duration expressions that allow simple arithmetic in range or offset values
55+
- Cluster validation for HTTP requests (`-server.cluster-validation.*` flags)
56+
- Native OTLP delta metric ingestion (`-distributor.otel-native-delta-ingestion`)
57+
58+
## Bug fixes
59+
60+
For a detailed list of bug fixes, refer to the [CHANGELOG](https://github.com/grafana/mimir/blob/main/CHANGELOG.md).
61+
62+
### Helm chart improvements
63+
64+
The Grafana Mimir Helm chart is released independently. Refer to the [Grafana Mimir Helm chart documentation](https://grafana.com/docs/helm-charts/mimir-distributed/latest/).

0 commit comments

Comments
 (0)