Try using Grot AI Grot AI for this query ->
Promo banner icon

Grafana 12.4 is here — faster and easier data visualization, Git Sync for observability as code updates, and more.

Learn more
DownloadsContact Us
Logo
  • Pricing
  • Docs
Sign inSign up
Menu
Technical documentation Plugin catalog
Choose a product
Viewing: v2.9.x Find another version
  • Grafana Loki documentation
  • Release notes
    • Release cadence
    • V2.8
    • V2.7
    • V2.6
    • V2.5
    • V2.4
    • V2.3
    • V2.9
  • Get started
    • Loki overview
    • Architecture
    • Deployment modes
    • Components
    • Labels
      • Label best practices
      • Structured metadata
    • Hash rings
  • Set up
    • Install
      • Install using Helm
        • Helm chart components
        • Install monolithic Loki
        • Install scalable Loki
        • Configure storage
        • Helm chart values
        • Monitoring
          • Configure monitoring and alerting
          • Monitor Loki with Grafana Cloud
      • Install using Tanka
      • Install using Docker
      • Install locally
      • Install on Istio
      • Install from source
    • Migrate
      • Migrate to TSDB
      • Migrate from `loki-distributed`
      • Migrate to three targets
    • Upgrade
      • Upgrade the Helm chart to 3.0
  • Configure
    • Best practices
    • Query frontend example
    • Examples
  • Storage
  • Send data
    • Promtail
      • Install Promtail
      • Configuration reference
      • Configure for cloud
        • Promtail on EC2
        • Promtail on ECS
        • Promtail on EKS
        • Promtail on GCP
      • Configure service discovery
      • Configure log rotation
      • Pipelines
      • Pipeline stages
        • cri
        • decolorize
        • docker
        • drop
        • eventlogmessage
        • geoip
        • json
        • labelallow
        • labeldrop
        • labels
        • limit
        • logfmt
        • match
        • metrics
        • multiline
        • output
        • pack
        • regex
        • replace
        • sampling
        • static_labels
        • structured_metadata
        • template
        • tenant
        • timestamp
      • Troubleshooting
    • Docker driver
      • Configure Docker driver
    • Fluent Bit
    • Fluentd
    • Lambda Promtail
    • Logstash plugin
    • k6 load testing
      • Log generation
      • Write path testing
      • Query testing
  • Query
    • Log queries
    • Metric queries
    • Template functions
    • Matching IP addresses
    • Query examples
    • LoqQL Analyzer
    • LogCLI
  • Visualize
  • Alert
  • Operations
    • Zone aware ingesters
    • Observability
    • Overrides exporter
    • Autoscaling queriers
    • Request Validation & Rate-Limit Errors
    • Scalability
    • Grafana Loki Storage
      • Log entry deletion
      • TSDB
      • Filesystem
      • Retention
      • Single Store (boltdb-shipper)
      • Storage schema
      • Table manager
      • Write Ahead Log
    • Multi-tenancy
    • Blocking Queries
    • Loki Canary
    • Troubleshooting
    • Caching
    • Shuffle sharding
    • Query fairness
    • Automatic stream sharding
    • Authentication
    • Recording Rules
    • Upgrade
  • Reference
    • HTTP API
  • Community
    • Contacting the Loki Team
    • Contributing to Loki
    • Governance
    • Maintaining
      • Releasing Grafana Loki
      • Releasing Loki Build Image
    • Loki Improvement Documents (LIDs)
      • 0001: Introducing LIDs
      • 0002: Remote Rule Evaluation
      • 0003: Query fairness across users within tenants
    • Design documents
      • Labels
      • Promtail Push API
      • Write-Ahead Logs
      • Ordering Constraint Removal
  • Copyright notice
Scroll for more

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Documentationbreadcrumb arrow Grafana Loki documentationbreadcrumb arrow Release notes
Open source RSS

Release notes

Release notes for Loki are in the CHANGELOG for the release and listed here by version number.

  • V2.9 release notes
  • V2.8 release notes
  • V2.7 release notes
  • V2.6 release notes
  • V2.5 release notes
  • V2.4 release notes
  • V2.3 release notes

The details about our release cadence are documented here.

Was this page helpful?

Create a GitHub issue
Email docs@grafana.com
Help and support
Community

Related resources from Grafana Labs

Additional helpful documentation, links, and articles:
video icon
Video
Getting started with logging and Grafana Loki
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.
video icon
Video
Essential Grafana Loki configuration settings
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.
video icon
Video
Scaling and securing your logs with Grafana Loki
Scaling and securing your logs with Grafana Loki
This webinar covers the challenges of scaling and securing logs, and how Grafana Cloud Logs powered by Grafana Loki can help, cost-effectively.

Is this page helpful?

Still have questions?

Ask your questions. Let AI do the heavy lifting.

Ask AI icon
Newsletter icon

Get every update

Subscribe to our newsletter

By submitting, you agree to our Privacy policy

Grafana Cloud

  • Overview
  • Pricing
  • What's in the free tier?
  • AI Assistant
  • Application Observability
  • Kubernetes Monitoring
  • Dashboards & Visualization
  • Database Observability
  • Frontend Observability
  • Synthetic Monitoring
  • Performance & Load Testing
  • Incident Response & Management
  • What’s New
  • Grafana Cloud Status

Solutions

  • AI Observability
  • Full-Stack Observability
  • Infrastructure & Cloud Observability
  • Digital Experience Monitoring
  • Scaled Prometheus
  • Cost Management & Optimization
  • Site Reliability
  • Log Management
  • Migrate to OpenTelemetry

Integrations

  • All Integrations
  • AWS
  • Google Cloud
  • Microsoft Azure
  • Kubernetes
  • Datadog
  • New Relic

Open Source

  • Our Projects
  • GitHub
  • Downloads
  • Dashboard Templates

Learn

  • Documentation
  • Blog
  • Community
  • Events
  • Observability Survey & Reports

Company

  • About Grafana Labs
  • Open Positions
  • Partnerships
  • Newsroom
  • Success Stories
  • Contact Us
  • Getting Help
  • Professional Services
  • Hey AI

Compare

  • Datadog vs. Grafana Labs
  • Dynatrace vs Grafana Cloud
  • Elasticsearch vs Grafana Cloud
  • New Relic vs Grafana Cloud
  • PagerDuty vs Grafana Cloud
  • Splunk vs Grafana Cloud
Grafana Labs x unique logomark

Donut take our word for it. Try Grafana Cloud today.

Grafana Cloud StatusLegal & SecurityTerms of ServicePrivacy PolicyTrademark Policy

Copyright 2026 © Grafana Labs

FacebookXLinkedinGithubYoutubeReddit
Grafana Labs uses cookies for the normal operation of this website. Learn more.