Menu
This is documentation for the next version of Loki. For the latest stable release, go to the latest version.
Open source
Prepare Upgrade guide
The upgrade guide records changes that require user attention or interaction to upgrade to specific Loki version from previous versions.
Before you begin
The upgrade guide in Grafana Loki works as follows.
We have a setup/upgrade/_index.md
file that records upgrade information for all Loki releases.
Steps
Make sure the upgrade guide is up to date on the
release-VERSION_PREFIX
branch under theMain/Unreleased
section.On the
release-VERSION_PREFIX
branch promoteMain/Unreleased
toVERSION
. Example PR.On the
main
branch remove entries fromMain/Unreleased
that are already part ofVERSION (YYY-MM-DD)
.
Was this page helpful?
Related resources from Grafana Labs
Additional helpful documentation, links, and articles:

Getting started with logging and Grafana Loki
See a demo of the updated features in Loki, and how to create metrics from logs and alert on your logs with powerful Prometheus-style alerting rules.

Essential Grafana Loki configuration settings
This webinar focuses on Grafana Loki configuration including agents Promtail and Docker; the Loki server; and Loki storage for popular backends.

Scaling and securing your logs with Grafana Loki
This webinar covers the challenges of scaling and securing logs, and how Grafana Enterprise Logs powered by Grafana Loki can help, cost-effectively.