This is documentation for the next version of Enterprise logs. For the latest stable release, go to the latest version.
Set up the Grafana Enterprise Logs plugin for Grafana
Grafana Enterprise 7.3.0 or higher.
Install the plugin in your GEL instance
There are multiple ways to install the plugin in your local Grafana Enterprise instance. For more information, refer to Grafana Enterprise Logs app installation.
Enable and configure the plugin
Log in to your Grafana Enterprise Logs.
Go to the Config/Plugins page and select the Grafana Enterprise Logs (GEL) plugin from list.
From the configuration page of the plugin, enable the plugin by clicking on the “Enable plugin” button.
Provide the necessary API settings so that the plugin can connect to your cluster:
- Access Token: Enter the admin-scoped access token that you generated when setting up your GEL cluster.
- Backend url: Enter the URL of your GEL cluster. For single-process clusters, this is any node in the cluster. For microservice deployments, the URL is the GEL gateway. If you followed the Deploy on Kubernetes guide, your URL is
<namespace>is the namespace that you used. For example, if you used the default namespace, then your URL would be
Click “Save API settings”.
Verify that the plugin loads and can communicate with the GEL admin API endpoints.
Navigate to the GEL plugin through the main menu to see the default access policy under the Access Policies tab.
Now that you have correctly configured the GEL app plugin, follow directions in Set up a GEL tenant and visualize your data.
Related Enterprise Logs resources
Grafana Enterprise Logs: Logging with security and scale
Join us for this webinar, which will cover: Challenges with logging as organizations scale and the volume of logs explodes, how Grafana Enterprise Logs enables organizations to make logs available to any team members who need them, features available in GEL and how to get access, a live product demo so you can see GEL for the first time
VIDEO: Watch this first-look demo of the new Grafana Enterprise Logs
Based on Loki, Grafana Enterprise Logs is part of the Grafana Enterprise Stack for composing and scaling observability on your own infrastructure.
Introducing Grafana Enterprise Logs, a core part of the Grafana Enterprise Stack integrated observability solution
Powered by the Loki open source project, the Enterprise Logs offering joins metrics and dashboards in our enterprise-ready stack for self-managed observability.