Plugins 〉Grafana Enterprise Logs


Grafana Enterprise Logs

  • Overview
  • Installation
  • Change log
  • Related content

Grafana Enterprise Logs

Grafana Enterprise Logs (GEL) is a commercial offering based on the open-source project Loki. The commercial offering allows you to deploy a highly-scalable, simple, and reliable GEL cluster in your own data center. The plugin gives you an easy way to manage your logs cluster.


  • Tenant management: Easily scale up to hundreds of GEL tenants on a single cluster.
  • Access policies and tokens: Fully control and visualise who has access to what.


After the plugin has been installed into your Grafana instance, enable and initialize it:

  1. Navigate to Configuration > Plugins within your Grafana instance.
  2. Select the Grafana Enterprise Logs app from the list.
  3. Click the Enable plugin button on the plugin page to enable the plugin.
  4. Fill out the API settings section with the GEL bootstrap token and a URL where the cluster can be accessed.
  5. Start using the GEL plugin.

For more information, visit the docs on plugin installation.


All notable changes to this project will be documented in this file. This project adheres to Semantic Versioning.

v2.3.0 -- November 12 2021

  • [FEATURE] - Added ability to edit access policies
  • [FIX] - Ensure __system__ access policy does not appear
  • [FIX] - Change of terminology to "Tenants" (previously was "Instances")
  • [FIX] - Fixed issue related to saving and updating instance limits (If-Match, ETag stability)

v2.2.0 -- August 19 2021

  • [ENHANCEMENT] - Show more detailed error messages for not correctly formatted access-tokens on the plugin config page
  • [ENHANCEMENT] - Update self-monitoring dashboards, introduce a new "Overview Dashboard"

v2.1.0 -- August 13 2021

  • [FEATURE] - Add a simple way to automatically generate datasources when creating a new logs:read token
  • [FEATURE] - Make it possible to create wildcard access-policies that are applied to all instances in a cluster
  • [FIX] - Hide the __system__ instance when self-monitoring is not available

v2.0.1 -- June 15 2021

  • [FIX] - Make the modals scrollable when creating a new instance, access-policy or token (introduced in v2.0.0)

v2.0.0 -- June 14 2021

  • [FEATURE] - Make the plugin compatible with Grafana 8 (Breaking change! - this version doesn't work with earlier versions of Grafana anymore)

v1.1.0 -- June 14 2021

  • [FIX] - Make "admin", "alerts:read" and "alerts:write" scopes available for new access policies
  • [FEATURE] - Update the look of the access policies list items
  • [FEATURE] - Enable LBAC (Label Based Access Control) in the plugin

v1.0.1 -- March 17 2021

  • [FIX] - Show hints (and disable the submit) for incorrectly formatted tokens on the app config page
  • [FIX] - Make backspaces work in the token input field


Initial release with supporting the basic features of Grafana Enterprise Logs (GEL).