grafana/docs/sources/administration/team-management/_index.md

54 lines
2.8 KiB
Markdown
Raw Normal View History

Docs: Update Grafana Teams documentation (#86942) * added config doc * added content * added new topic docs and made updates * minor updates * updates based on feedback * ran prettier , made updates * removed original doc, updates to topic docs * removed old index doc * fixed format issue * Update docs/sources/administration/team-management/administering-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/configure-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/configure-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/configure-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/configure-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/administering-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/_index.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/configure-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/configure-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/configure-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/configure-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * edits based on feedback * updates based on feedback * improved some wording * ran prettier * minor correction * added aliases * Update docs/sources/administration/team-management/configure-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * added contractions * Removed .nx --------- Co-authored-by: Jack Baldry <jack.baldry@grafana.com>
2024-05-29 13:22:45 +08:00
---
aliases:
- ../manage-users/add-or-remove-user-from-team/
- ../manage-users/create-or-remove-team/
- ../manage-users/manage-teams/
- manage-users-and-permissions/manage-teams/
description: This document introduces Grafana Teams and Teams concepts.
labels:
products:
- enterprise
- oss
- cloud
keywords:
- authorization
- microservices
- architecture
menuTitle: Grafana Teams
title: Grafana Teams
weight: 100
---
# Grafana Teams
Grafana Teams makes it easy to organize and administer groups of users in your enterprise. Teams allows you to grant permissions to a group of users instead of granting permissions to individual users one at a time.
Teams are useful in a wide variety of scenarios, such as when onboarding new colleagues or needing access to reports on secure financial data. When you add a user to a team, they get access to all resources assigned to that team.
## Teams concepts
A Grafana Team is a group of users within an organization that have common permissions, including access to dashboards and data sources, and those permissions apply to **all members** of that team. For example, instead of assigning six users access to the same dashboard, you can create a team that consists of those users and assign dashboard permissions to the team. A user can belong to multiple teams.
A Team grants permissions to a wide variety of resources including:
- dashboards
- data sources
- folders
- alerts
- reports
- cloud access policies
- annotations
- playlists
{{< admonition type="note" >}}
All members of a Grafana Team have the same exact permissions. A single Team can't have members with different access levels to resources shared within that Team.
Additionally, when a user belongs to multiple Teams that have different permission levels for the same resource, the user receives the highest (most permissive) access level from any of their Teams. For example, if a user belongs to two Teams, one with Viewer access and another with Editor access to a folder, the user will have Editor access to that folder.
Docs: Update Grafana Teams documentation (#86942) * added config doc * added content * added new topic docs and made updates * minor updates * updates based on feedback * ran prettier , made updates * removed original doc, updates to topic docs * removed old index doc * fixed format issue * Update docs/sources/administration/team-management/administering-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/configure-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/configure-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/configure-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/configure-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/administering-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/_index.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/configure-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/configure-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/configure-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/administration/team-management/configure-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * edits based on feedback * updates based on feedback * improved some wording * ran prettier * minor correction * added aliases * Update docs/sources/administration/team-management/configure-grafana-teams.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * added contractions * Removed .nx --------- Co-authored-by: Jack Baldry <jack.baldry@grafana.com>
2024-05-29 13:22:45 +08:00
{{< /admonition >}}
A user can be a `Member` or an `Administrator` for a given Team. `Members` of a Team inherit permissions from the team, but they don't have team administrator privileges, and can't edit the team itself. Team `Administrators` can add members to a team and update its settings, such as the team name, team members team roles, UI preferences, and home dashboard.
There are two types of Teams, `isolated` or `collaborative`. Isolated teams can only see their own resources. They can't see other teams resources like dashboards, data, or alerts. Collaborative teams have access to other teams resources.
For information about how to optimize Teams, refer to [How to best organize your teams and resources in Grafana](https://grafana.com/blog/2022/03/14/how-to-best-organize-your-teams-and-resources-in-grafana/).