팀 폴더 관리

팀 폴더 관리 (Manage team folders)

팀 폴더는 폴더를 팀과 연결해서 관리자와 팀원이 필요한 대시보드, 라이브러리 패널, 알림 규칙을 더 빨리 찾을 수 있게 도와줘요. 팀을 만들 때 전용 폴더를 자동 생성해 소유권을 처음부터 명확히 정할 수 있죠. 팀 폴더도 여전히 일반 폴더이며, 팀 연결은 소유권 메타데이터와 팀 인식 네비게이션을 추가할 뿐 폴더 권한을 바꾸거나 대체하지는 않아요.

출처: 문서

본문

팀 폴더(Team folders)는 현재 공개 미리보기(public preview) 상태예요.

시작하기 전에 다음 항목을 준비했는지 확인하세요.

  • foldersAppPlatformAPI 기능 토글(feature toggle)이 활성화되어 있어야 해요.
  • 루트 레벨 폴더 생성 권한, 또는 사용하려는 상위 폴더에 하위 폴더를 만들 권한이 있어야 해요.
  • UI에서 폴더 소유자를 지정하거나 변경하려면 폴더 권한 관리 권한과 팀 읽기 권한이 필요해요.

팀 폴더 활성화

Grafana OSS 또는 Grafana Enterprise에서 팀 폴더를 활성화하려면 foldersAppPlatformAPI 기능 토글이 켜져 있어야 해요. 기능 토글에 대한 자세한 내용은 "Configure feature toggles" 문서를 참고하세요.

팀을 만들 때 팀 폴더 생성

팀 폴더가 활성화되면 New team(새 팀) 페이지에 팀 폴더를 자동으로 만들 수 있는 옵션이 나타나요. 팀과 폴더를 함께 만들려면:

  1. Administration(관리)을 열고 Users and access > Teams로 이동해요.
  2. New team을 클릭해요.
  3. 팀 정보를 입력해요.
  4. Team folder에서 Auto-create a team folder를 선택해요.
  5. Create를 클릭해요.

Grafana가 팀과 같은 이름의 폴더를 만들고 그 팀을 폴더 소유자로 지정해요. 폴더가 만들어진 뒤 폴더 권한을 검토하고 필요하면 업데이트하세요.

Dashboards에서 팀 폴더 생성 또는 지정

새 팀 폴더 만들기

  1. 기본 메뉴에서 Dashboards를 클릭해요.
  2. New를 클릭하고 New folder를 선택해요.
  3. 고유한 폴더 이름을 입력해요.
  4. Assign an owner to the folder(폴더에 소유자 지정)를 선택해요.
  5. Team 드롭다운에서 폴더를 소유할 팀을 선택해요.
  6. Create를 클릭해요.

Grafana가 일반 폴더를 만들고 선택한 팀을 폴더 소유자로 저장해요.

기존 폴더의 소유자 지정 또는 변경

  1. 기본 메뉴에서 Dashboards를 클릭해요.
  2. 업데이트할 폴더를 열어요.
  3. Folder actions를 클릭하고 Manage folder owner를 선택해요.
  4. 팀을 선택하거나, 소유자를 제거하려면 현재 값을 지워요.
  5. Save owner를 클릭해요.

폴더에 팀 소유자가 있으면 Grafana는 폴더 헤더에 Owned by 라벨을 표시해요.

팀 폴더 찾기

팀 폴더가 활성화되면 Grafana는 대시보드 찾아보기 페이지와 팀 상세 화면에 팀 폴더를 표시해요.

  • Browse dashboards: 폴더를 소유한 팀에 속해 있으면 Dashboards 페이지 상단 근처에 My team folders 섹션이 나타나요. 그 섹션을 펼치면 팀이 소유한 폴더를 열 수 있어요.
  • 대시보드 저장/이동: 대시보드를 저장하거나 이동할 때 폴더 선택기가 폴더 트리 상단에 Team folders 섹션을 보여줘요. 첫 번째 팀 폴더가 기본으로 미리 선택돼요.
  • 팀이 소유한 폴더 검토: 각 팀 페이지에는 그 팀이 소유한 모든 폴더를 나열하는 Folders 탭이 있어요.

팀 폴더에 대한 접근 관리

폴더 소유권은 폴더 권한을 대체하지 않아요. 팀 폴더는 다른 폴더와 동일한 권한 모델을 사용해요. 팀원이 폴더에 접근해야 한다면 팀 또는 사용자·역할·서비스 계정에 대해 폴더 권한을 구성하세요. 자세한 내용은 "Manage dashboard permissions" 문서를 참고해요.

제한 사항

  • 폴더당 팀 소유자는 한 명만 선택할 수 있어요.
  • 저장소 관리(repository-managed) 폴더에는 팀 소유자를 지정하거나 변경할 수 없어요.

다음 단계

더 알아보기 (Learn more)