docs/sources/release-notes/v3-1.md
Grafana Labs and the Loki team are excited to announce the release of Loki 3.1. Here's a summary of new enhancements and important fixes.
For a full list of all changes and fixes, refer to the CHANGELOG.
Key features in Loki 3.1.0 include the following:
Query acceleration with Bloom filters (experimental): Continued work on improving the new Bloom filters feature introduced in Loki 3.0. This is designed to speed up filter queries, with best results for queries that are looking for a specific text string like an error message or UUID. For more information, refer to Query acceleration with Blooms.
Helm: Update Helm chart to support distributed mode and 3.0 (#12067) (79b876b). Add pattern ingester support in SSD mode (#12685) (19bfef4). Enable log volume endpoint by default in Helm (#12690) (e39677f). Allow extraObject items as multiline strings (#12397) (af5be90).Support for PVC Annotations for Non-Distributed Modes (#12023) (efdae3d).
LogQL: Support negative numbers in LogQL (#13091) (6df81db). Improve performance of first_over_time and last_over_time queries by sharding them (#11605) (f66172e). Improve syntax parser for pattern (#12489) (48dae44).
Loki: Add ability to disable AWS S3 dual stack endpoints usage (#13795) (464ac73).
lokitool: Add lokitool to replace cortextool. (#12166) (7b7d3d4). Introduce index audit to lokitool (#13008) (47f0236).
Explore Logs: Explore Logs, which lets you explore your Loki data without writing LogQL queries, is now available in public preview. If you are a Grafana Cloud user, you can access Explore Logs in the Grafana Cloud main navigation menu. If you are not a Grafana Cloud user, you can install the Explore Logs plugin. For more information, refer to the Explore Logs documentation.
Docs: Added a video to the Getting Started demo and updated for Grafana Alloy. Added an interactive sandbox to the Loki Quickstart tutorial. Updated the documentation for the SSD and microservices deployment modes using the Helm charts. Documented the new meta-monitoring Helm chart.
Other improvements include the following:
Cache-Control: no-cache support for Loki instant queries. (#12896) (88e545f).inversePostingsForMatcher (#12679) (402d1d7).One of the focuses of Loki 3.0 was cleaning up unused code and old features that had been previously deprecated but not removed. Loki 3.0 removed a number of previous deprecations and introduces some new deprecations. Some of the main areas with changes include:
Deprecated storage options including the deprecation of the BoltDB store.
To learn more about breaking changes in this release, refer to the Upgrade guide.
{{< docs/shared source="alloy" lookup="agent-deprecation.md" version="next" >}}
The path from 2.9 to 3.0 included several breaking changes. For important upgrade guidance, refer to the Upgrade Guide and the separate Helm Upgrade Guide.
{{< admonition type="important" >}} Out of an abundance of caution, we advise that users with Loki or Grafana Enterprise Logs (GEL) deployments on AWS upgrade their Helm charts or change the names of their buckets, as outlined in the solutions and mitigations section of this blog post. {{< /admonition >}}
continue in fuse which may cause incorrect bloom test result (#12650) (0d1ebeb).partitionSeriesByDay function (#12900) (738c274).ChunkRef.Cmp method is used in reverse (#12999) (670cd89).codec not initialized in downstream roundtripper (#12873) (b6049f6).deploymentMode (#12641) (0d8ff9e).max_line_size of 256kb, but
With this fix, if the max_line_size config in Promtail has a value, the docker service discovery will now respect that configuration, otherwise it will use the Loki default of 256kb.From==Through and From==start (#13117) (d9cc513).