This is documentation for the next version of Enterprise logs. For the latest stable release, go to the latest version.

Set up a GEL clusterSet up the GEL plugin for Grafana

Set up the Grafana Enterprise Logs plugin for Grafana

Requirements

Grafana Enterprise 7.3.0 or higher.

If you are using Kubernetes, refer to Deploy Grafana Enterprise on Kubernetes. Otherwise, refer to Install Grafana.

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

  1. Log in to your Grafana Enterprise Logs.

  2. Go to the Config/Plugins page and select the Grafana Enterprise Logs (GEL) plugin from list.

  3. From the configuration page of the plugin, enable the plugin by clicking on the “Enable plugin” button.

  4. 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 http://ge-logs.<namespace>.svc.cluster.local:8100/, where <namespace> is the namespace that you used. For example, if you used the default namespace, then your URL would be http://ge-logs.default.svc.cluster.local:8100/.
    Configuration GEL plugin page
  1. Click “Save API settings”.

  2. Verify that the plugin loads and can communicate with the GEL admin API endpoints.

  3. 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.