Skip to content
Last updated

Grafana integration

Grafana is an open-source observability platform for visualizing metrics, logs, and traces. Integrating Grafana with Frontegg allows your application to access dashboards, data sources, alerts, and annotations on behalf of your users using a Grafana service account token.


Prerequisites

Connect Grafana

Step 1: Open the Administration panel

Log in to your Grafana instance and click Administration in the left sidebar to expand the administration menu.

Grafana Administration panel

Step 2: Open the Service accounts page

In the Administration menu, click Users and access, then click Service accounts. The Service accounts page lists all existing service accounts for your instance.

Grafana Service accounts page

Step 3: Create a new service account

Click Add service account. On the form that appears, enter a descriptive name in the Display name field (for example, Frontegg Integration), then click Create.

Grafana create service account form

Step 4: Add a service account token

After the service account is created, you are taken to the service account detail page. Click Add service account token to create an API token for this service account.

Grafana service account detail page

Step 5: Generate the token

In the dialog that appears, enter a name for the token (for example, Frontegg Integration) and choose an expiration option. Select No expiration to create a permanent token, or Set expiration date to define a specific validity period. Click Generate token.

Grafana generate token dialog

Step 6: Copy your token

A dialog displays the generated token value. Copy the token and store it in a safe place.

Copy your token now

This is the only time Grafana will display the token value. If you lose it, you will need to delete the token and create a new one.

Grafana token created dialog

Configure the Frontegg portal

Once you have obtained your Grafana service account token from the steps above, enter it in the integration configuration page of the Frontegg portal:

  1. Open the Frontegg portal and navigate to [ENVIRONMENT] → Integrations → Grafana.
  2. Enter the service account token in the API Key field.
  3. Enter your Grafana instance URL in the Grafana instance URL field. Use the root URL of your Grafana stack — for example, https://mycompany.grafana.net for Grafana Cloud or https://grafana.your-company.com for a self-hosted instance. Do not include a trailing slash or an /api suffix.
  4. Click Save.

Keep your token secure

Never share or commit your service account token to version control.

Additional resources