Documentationbreadcrumb arrow Pluginsbreadcrumb arrow GitLab
Grafana Cloud Enterprise
Last reviewed: March 8, 2026

GitLab data source

The GitLab data source allows you to visualize and monitor GitLab activity in Grafana. You can track statistics such as top contributors, commits per day, deployments, merge requests, and pipeline status. Combine data from the GitLab API with other sources and use template variables to build dynamic, filterable dashboards.

Note

The GitLab data source is an Enterprise plugin. It’s available with a Grafana Cloud Pro or Advanced plan or with Grafana Enterprise. For installation instructions, refer to Install Grafana Enterprise plugins.

Supported GitLab environments

The GitLab data source works with:

  • GitLab.com (SaaS)
  • Self-hosted GitLab (Community Edition and Enterprise Edition)

Note

Some features require specific GitLab tiers. For example, audit events require a GitLab Premium or Ultimate subscription, or a self-hosted instance with admin privileges.

Requirements

  • Grafana version 11.6.7 or later
  • A GitLab personal access token with the read_api scope

Install the plugin

To install the GitLab data source plugin, refer to Installation.

Note

The plugin is pre-installed on Grafana Cloud Pro and Advanced instances.

Supported features

FeatureSupported
MetricsYes
AlertingYes
AnnotationsYes
LogsNo
TracesNo

Supported resource types

The GitLab data source can query the following resource types. For detailed field documentation, refer to the query editor.

Resource typeDescription
Audit eventsInstance, project, or group audit events (requires GitLab Premium)
CommitsCommits from a project, with optional branch/tag filtering
DeploymentsDeployments from a project, filterable by environment and status
EnvironmentsEnvironments configured for a project
IssuesProject issues, searchable by title and description
LabelsLabels defined in a project
Merge request approvalsApproval details for a specific merge request
Merge requestsMerge requests by project, group, or account with extensive filters
PipelinesCI/CD pipelines with filters for scope, status, source, and more
ProjectsProjects accessible to the configured account
ReleasesReleases from a project
TagsGit tags from a project
UsersGitLab users (most filters require admin privileges)

Get started

The following documents help you set up and use the GitLab data source:

Additional resources

After configuring the GitLab data source, you can also:

Pre-built dashboards

The GitLab data source includes a pre-built GitLab Overview dashboard. To import it:

  1. Navigate to the GitLab data source configuration page.
  2. Select the Dashboards tab.
  3. Click Import next to the GitLab Overview dashboard.

Plugin updates

Always ensure that your plugin version is up-to-date so you have access to all current features and improvements. Navigate to Plugins and data > Plugins to check for updates. Grafana recommends upgrading to the latest Grafana version, and this applies to plugins as well.

Note

Plugins are automatically updated in Grafana Cloud.