This is archived documentation for 1.1.0. Go to the latest version.

Set up a GEL tenant

Set up a Grafana Enterprise Logs tenant

Create a Grafana Enterprise Logs (GEL) tenant:

  1. Navigate to Grafana Enterprise Logs > Tenants.

  2. Click on Create new tenant.

  3. Choose a name for your tenant. For demonstration purposes, use the name demo.

  4. Select the cluster.

  5. Click Create tenant.

Create a data source access policy and token

Create an access policy and a token, that are used by Grafana itself to access the logs in the tenant named demo:

  1. Navigate to Grafana Enterprise Logs > Access policies.

  2. Click Create new access policy.

  3. Choose a name for the policy. For demonstration purposes, use demo-grafana.

  4. Select the tenant demo.

  5. Enable the scope read.

  6. Click on Create.

  7. From the newly created access policy, click + Add token.

  8. Name the token demo-grafana, and click on Create.

  9. In the next window, copy the token.

Next, use this access policy and token to create a new data source in Grafana:

  1. Navigate to Configuration > Data Sources.

  2. Click on Add new data source.

  3. Choose a name for this data source. For demonstration purposes, use Enterprise Logs.

  4. Select Loki.

  5. Set the URL to http://<GEL host>:3100.

  6. Enable Basic Auth and use User demo and as Password the token from your clipboard.

  7. Click Save & Test.

Create a Promtail access policy and token

To be able to have some metrics inside our cluster, create an access policy so that a Promtail agent can write logs into the tenant demo:

  1. Navigate to Grafana Enterprise Logs > Access policies.

  2. Click on Create new access policy.

  3. Choose a name for the policy. For demonstration purposes, use demo-promtail.

  4. Select the tenant demo.

  5. Enable the scope write.

  6. Click on Create.

  7. From the newly created access policy, click on + Add token.

  8. We call the token demo-promtail again and click on Create.

  9. In the next window, copy the token.