Documentation Plugins GitLab Configure

Configure the GitLab data source

This document explains how to configure the GitLab data source in Grafana.

Before you begin

Before configuring the data source, ensure you have:

• Grafana permissions: Organization administrator role
• GitLab account: A GitLab.com or self-hosted GitLab instance
• GitLab personal access token: A token with the read_api scope

Create a GitLab personal access token

To authenticate with GitLab, create a personal access token with read_api permissions:

1. In GitLab, navigate to your Personal Access Tokens page.
2. Enter a name in the Token name field.
3. Set an expiration date in the Expiration date field.
4. Under Select scopes, select read_api.
5. Click Create personal access token.
6. Copy the token value. You can’t view the token again after you leave the page.

Add the data source

To add the GitLab data source:

1. Click Connections in the left-side menu.
2. Click Add new connection.
3. Type GitLab in the search bar.
4. Select GitLab.
5. Click Add new data source.

Configure settings

The following table describes the available configuration settings:

Verify the connection

Click Save & test to verify the connection.

If the connection is successful, you see the message Plugin health check successful.

If you see an error, refer to Troubleshoot GitLab data source issues for help resolving common errors.

Provision the data source

You can define the data source using YAML files as part of Grafana’s provisioning system. For more information about provisioning, refer to Provision Grafana.

YAML Copy

apiVersion: 1

datasources:
  - name: GitLab
    type: grafana-gitlab-datasource
    access: proxy
    url: https://gitlab.com/api/v4
    jsonData:
      pageLimit: 5
      enableSecureSocksProxy: false
    secureJsonData:
      accessToken: <YOUR_ACCESS_TOKEN>

Replace <YOUR_ACCESS_TOKEN> with your GitLab personal access token.

Provision the data source with Terraform

You can provision the GitLab data source with the Grafana Terraform provider.

hcl Copy

resource "grafana_data_source" "gitlab" {
  type = "grafana-gitlab-datasource"
  name = "GitLab"
  url  = "https://gitlab.com/api/v4"

  json_data_encoded = jsonencode({
    pageLimit              = 5
    enableSecureSocksProxy = false
  })

  secure_json_data_encoded = jsonencode({
    accessToken = var.gitlab_access_token
  })
}