Managing Grafana Users

Grafana works with its own user accounts. A Private Cloud Appliance administrator can sign in to Grafana and add new users. User permissions can be refined through teams and folders.

Users

To add a new user, perform the following procedure as the admin user:

  1. In the vertical menu bar on the left side of the Grafana home page, click the Server Admin (shield) icon.

  2. On the Server Admin drop down menu, click Users.

  3. Click the New User button.

  4. Enter the requested information, and click the Create User button.

    By default, the new user has the Viewer role. You could modify the user to change the role. Another way to change a user's access is to add the user to a team that has the required access.

The following are the Grafana user roles:

  • Admin: Has access to all organization resources, including dashboards, users, and teams.

  • Editor: Can view and edit dashboards, folders, and playlists.

  • Viewer: Can view dashboards and playlists.

By default, an editor can edit all of the listed resources, and a viewer can view all of the listed resources. A user with the Admin role can grant or restrict permissions to specific resources for specific roles, teams, and users. For example, click the Permissions tab on a folder to change the permissions to that folder for the Editor or Viewer roles. Click the Add Permissions button on the Permissions tab to add permissions for specific users or teams.

Teams

To create a new team, perform the following procedure as the admin user:

  1. In the vertical menu bar on the left side of the Grafana home page, click the Configuration (gear) icon.

  2. On the Configuration drop down menu, click Teams.

  3. Click the New Team button.

  4. Enter the requested information, and click the Create button.

  5. Click the Add Member button.

  6. In the Add team member box, click the drop-down arrow and select the user you want to add to the team.

  7. Click the Add to team button.

  8. Click the Settings tab at the top of the page to modify team settings such as home dashboard and time zone.

Folders

Use folders to grant permissions to users and teams. Perform the following procedure as the admin user:

  1. In the vertical menu bar on the left side of the Grafana home page, click the Dashboards (grid) icon.

  2. On the Dashboards drop down menu, click Manage.

  3. For the folder for which you want to grant teams and users permissions, click Go to folder.

  4. At the top of the folder page, click the Permissions tab.

  5. Click the Add Permission button.

  6. In the Add Permission For box, select the team or user, and select the role for the user or for all users on the team.

  7. Click the Save button.

You can also grant permissions for specific dashboards in a folder. Perform the following procedure as the admin user:

  1. In the vertical menu bar on the left side of the Grafana home page, click the Dashboards (grid) icon.

  2. On the Dashboards drop down menu, click Manage.

  3. Click the name of the folder that contains the dashboard, and then click the dashboard.

  4. At the top of the dashboard page, click the gear icon.

  5. In the menu on the left side of the page, click Permissions.

  6. Click the Add Permission button.

  7. In the Add Permission For box, select the team or user, and select the role for the user or for all users on the team.

  8. Click the Save button.

  9. Click the Save Dashboard button.