Configure Grafana
- Tier: Free, Premium, Ultimate
- Offering: GitLab Self-Managed, GitLab Dedicated
Grafana is a tool that enables you to visualize time series metrics through graphs and dashboards. GitLab writes performance data to Prometheus, and Grafana allows you to query the data to display graphs.
Integrate with GitLab UI
After setting up Grafana, you can enable a link to access it from the GitLab sidebar:
- On the left sidebar, at the bottom, select Admin.
- Select Settings > Metrics and profiling.
- Expand Metrics - Grafana.
- Select the Add a link to Grafana checkbox.
- Configure the Grafana URL. Enter the full URL of the Grafana instance.
- Select Save changes.
GitLab displays your link in the Admin area under Monitoring > Metrics Dashboard.
Required Scopes
When setting up Grafana through the process above, no scope shows in the screen in
the Admin area under Applications > GitLab Grafana. However, the read_user
scope is
required and is provided to the application automatically. Setting any scope other than
read_user
without also including read_user
leads to this error when you try to sign in using
GitLab as the OAuth provider:
The requested scope is invalid, unknown, or malformed.
If you see this error, make sure that one of the following is true in the GitLab Grafana configuration screen:
- No scopes appear.
- The
read_user
scope is included.
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support