Menu

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Documentationbreadcrumb arrow Grafana documentationbreadcrumb arrow Alertingbreadcrumb arrow Set upbreadcrumb arrow Configure RBACbreadcrumb arrow Manage access using folders or data sources
Enterprise Grafana Cloud

Manage access using folders or data sources

You can extend the access provided by a role to alert rules and rule-specific silences by assigning permissions to individual folders or data sources.

Note

Data source query permissions are required to create or modify an alert rule using that data source.

This allows different users, teams, or service accounts to have customized access to modify or silence alert rules in specific folders or using specific data sources.

Details on the additional access provided by folder permissions are below.

Folder permissionAdditional Access
ViewRead access to all general silences. Read access to alert rules and their rule-specific silences only in the given folder and subfolders.
EditView access and write access to alert rules and their rule-specific silences only in the given folder and subfolders.
AdminSame additional access as Edit.

Some example combinations:

RoleFolder permissionAccess
No Basic Role-None. No access to alert rules or rule-specific silences in the folder.
No Basic RoleViewRead access to all general silences. Read access to alert rules and their rule-specific silences only in the given folder and subfolders.
No Basic RoleEditAbove access and write access to alert rules (given necessary data source query permissions) and their rule-specific silences only in the given folder and subfolders.
Viewer-Read access to alert rules and silences in all folders.
ViewerEditRead access to alert rules and silences in all folders. Write access to alert rules and their rule-specific silences only in the given folder and subfolders.
EditorViewRead and write access to alert rules and silences in all folders. Access can only be extended.

Note

You can’t use folders to customize access to notification resources.

Folder permissions

To manage folder permissions, complete the following steps.

  1. In the left-side menu, click Dashboards.
  2. Choose the folder you want to add permissions for.

Note

It doesn’t matter which tab you’re on (Dashboards, Panels, or Alert rules); the folder permission you set applies to all.
  1. Click Manage permissions from the Folder actions menu.
  2. Update or add permissions as required.

Data source permissions

By default, users with the basic roles Admin, Editor, and Viewer roles have query access to data sources for Grafana Alerting.

If you used fixed roles or custom roles, you need to update data source permissions.

Alternatively, an administrator can assign the role Datasource Reader, which grants the user access to all data sources.

To manage data source permissions, complete the following steps.

  1. In the left-side menu, click Connections > Data sources.
  2. Click the data source you want to change the permissions for.
  3. Click the Permissions tab.
  4. In the Permission column, update the permission, or remove it by clicking X.