This is documentation for the next version of Grafana. For the latest stable release, go to the latest version.

Documentation Grafana documentation Administration Data source management Label Based Access Control (LBAC) for data sources

Label Based Access Control (LBAC) for data sources

Label Based Access Control (LBAC) for data sources simplifies and streamlines data source access management based on team memberships. Label-Based Access Control (LBAC) allows fine-grained access control to data sources by filtering logs or metrics based on labels. It lets administrators configure access rules for teams, ensuring that users only query data relevant to their assigned permissions.

Supported Data Sources

LBAC for data sources is currently available for Loki, Prometheus with basic authentication. Support for additional data sources may be added in future updates.

LBAC for data sources offers:

• Team-based access control using LogQL rules.
• Simplified data source management by consolidating multiple sources into one.
• Dashboard reuse across teams with tailored access.

You can configure user access based upon team memberships using LogQL. LBAC for data sources controls access to logs or metrics depending on the rules set for each team.

This feature addresses two common challenges faced by Grafana users:

1. Having a high number of Grafana Cloud data sources. LBAC for data sources lets Grafana administrators reduce the total number of data sources per instance from hundreds, to one.
2. Using the same dashboard across multiple teams. LBAC for data sources lets Grafana Teams use the same dashboard with different access control rules.

To set up LBAC for data sources for a Loki data source, refer to Configure LBAC for Loki Data Source. To set up LBAC for data sources for a Loki data source, refer to Configure LBAC for Prometheus Data Source.

Logs and Metrics Filtering with LBAC

LBAC for data sources enables you to filter access for both logs and metrics. By defining rules with label selectors, you can specify:

• Logs: Control access to log lines using LogQL queries with labels such as namespace or cluster.
• Metrics: Control access to metric data points using LogQL with labels such as job or region and access for metrics __name__.

This flexibility allows teams to use the same data source for multiple use cases while maintaining secure access boundaries.

Before you begin

To be able to use LBAC for data sources, you need to enable the feature toggle teamHttpHeaders on your Grafana instance.

Limitations

• There is a set number of rules to be configured within a data source, depending on the size of the rules.
  • Around ~500-600 rules is the upper limit.
• If there are no LBAC for data sources rules for a user’s team, that user can query all logs or metrics.
• If an administrator is part of a team with LBAC for data sources rules, those rules are applied to the administrator requests.
• Cloud Access Policy (CAP) LBAC rules override LBAC for data sources rules. CAP are the access controls from Grafana Cloud.

You must remove any label selectors from your Cloud Access Policy that is configured for the data source, otherwise the CAP label selectors override the LBAC for data sources rules. For more information about CAP label selectors, refer to Use label-based access control (LBAC) with access policies.

Data source permissions

• Data source permissions allow the users access to query the data source.
• Administrators set the permissions at the data source level.
• All the teams and users that are part of the data source inherit those permissions.

Recommended setup

It’s recommended that you create a single data source for using LBAC for data sources rules so you have a clear separation of data sources using LBAC for data sources and those that aren’t. All teams should have with only teams having query permission. You should create another data source configured without LBAC for data sources for full access.

LBAC rules

Grafana adds LBAC for data sources rules to the HTTP request via the data source.

If you configure multiple rules for a team, each rule is evaluated separately. Query results include lines that match any of the rules.

Only users with data source Admin permissions can edit LBAC for data sources rules in the Data source permissions tab because changing LBAC rules requires the same access level as editing data source permissions.

To set up LBAC for data sources for a data source, refer to Configure LBAC for data sources.