Menu
Documentationbreadcrumb arrow Grafana Enterprise Logsbreadcrumb arrow Release notesbreadcrumb arrow V3.0
Enterprise

Version 3.0 release notes

Note

Note that the version of GEL now reflects the version of Loki that the GEL release is based on. Patch versions are not expected to always match, but the intent is that major/minor versions should align, making it easier to tell which Loki version is included in each GEL release.

Grafana Enterprise Logs v3.0 is built off of Loki v3.0, so it inherits all the features, enhancements, and bug fixes of the upstream project. For more information about features and fixes in this release, refer to the Loki Release Notes and the Loki CHANGELOG.

Note

Note that Loki 3.0 defaults to using the v13 schema. All of the latest features are built against TSDB and the v13 Schema. This version of the schema is compatible with both Loki 2.9.x and Loki 3.0. The main change is to add support for Structured Metadata which is used by the new OTLP native endpoint and is enabled by default.

Features and enhancements

For the full list of features, enhancements and bug fixes in GEL 3.0.0, refer to the GEL Changelog.

3.0.0 Features and enhancements

  • Updated Loki dependency to v3.0.0.
  • Helm charts: A major upgrade to the Loki Helm chart includes memcached by default and includes several updates to configurations to improve Loki operations.
  • cost management: Support usage tracking based on label name matchers.
  • profiling: Add tracing integration to profiling.
  • Docs improvements: You will notice a major change in the GEL documentation in this release. The table of contents now matches the standardized information architecture that is being adopted across all the Grafana database products. In addition, the separate “Loki” section of the documentation has been removed. Loki content now appears throughout the GEL documentation, and is pulled directly from the Loki repo so that as Loki topics are updated, those changes are reflected in the GEL documentation.

Upgrade considerations

The path from Loki 2.9.x to 3.0.0 includes several breaking changes. For important upgrade guidance, refer to the Upgrade Guide and the separate Helm Upgrade Guide.

Caution

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.

There are no additional GEL-specific upgrade considerations.

Bug fixes

3.0.1 bug fixes

  • Fixed default AWS S3 endpoint which is propagated if endpoint is not specified in the config. It allows using IAM roles for service accounts authentication method.

3.0.0 bug fixes

  • Adaptive logs query sanitization space removal.
  • Adaptive logs - remove query normalization.
  • Bump fake-gcs-server.
  • Clear trackers before changing slice length.
  • Compile LBAC regexes earlier.
  • Divide by zero bug in adaptive logs’ Tee.
  • Empty usage tracker slice.
  • Export multiple trackers as metrics.
  • Purge stale usage metrics.
  • Series endpoint LBAC enforcement.
  • Set global otlp config in per tenant configs for parsing.