대시보드 패널 그룹화

대시보드 패널 그룹화 (Dashboard panel groupings)

대시보드에 의미 있는 섹션을 만들기 위해 패널을 행(row)이나 탭(tab)으로 그룹화할 수 있어요. 행·탭은 큰 대시보드를 나누거나 여러 개의 작은 대시보드를 하나로 합치는 데 도움을 줍니다. 패널, 행, 탭을 최대 4단계까지 중첩할 수 있게 설계되어 있어요.

출처: 문서

본문

대시보드는 중첩 컨테이너의 연속으로 볼 수 있어요. 가장 큰 컨테이너가 대시보드이고, 그 안에 패널·행·탭이 들어갑니다. 행·탭이 다음으로 큰 컨테이너이며 패널이나 다른 행·탭을 포함해요.

중첩 가능한 조합:

• 행 안의 행
• 탭 안의 행
• 행 안의 탭

탭 안에 탭은 직접 중첩할 수 없지만, 탭 안의 행 안에 탭은 중첩할 수 있어요(탭 > 행 > 탭). 최대 4단계 중첩까지 가능하며, 이는 대시보드가 최대 6개 구성 레벨을 가질 수 있다는 뜻입니다:

• Dashboard
• Grouping 1 - Row 또는 tab
• Grouping 2 - Row 또는 tab
• Grouping 3 - Row 또는 tab
• Grouping 4 - Row 또는 tab
• Panels

첫 레벨에는 한 가지 유형의 그룹화만 둘 수 있어요. 하지만 첫 레벨 그룹화 안에서는 자유롭게 다양한 요소를 추가할 수 있고, 행·탭 안에는 서로 다른 패널 레이아웃을 가질 수 있어요. 사이드바에서 그룹화를 추가하는 것 외에, 대시보드의 관련 부분 위에 마우스를 올리면 + Add panel, + New row, + New tab, Group panels, 그룹 해제 버튼이 나타납니다.

그룹화 구성 옵션

행이나 탭에 설정할 수 있는 옵션입니다.

그룹화 레이아웃

행·탭으로 패널을 그룹화할 때 Layout 옵션은 선택한 요소와 중첩 레벨에 따라 달라져요. 최대 4단계 중첩(6개 구성 레벨):

• Dashboard: 행/탭 또는 커스텀/오토 레이아웃 선택
• Grouping 1 (outer): 행/탭 선택
• Grouping 2 (middle): 행/탭 선택
• Grouping 3 (middle): 행/탭 선택
• Grouping 4 (inner): 커스텀/오토 그리드 선택
• Panels: 레이아웃 옵션 없음

부모 컨테이너를 클릭하고 레이아웃 선택을 바꿔 행/탭 사이를 전환하거나 패널 레이아웃을 업데이트할 수 있어요.

패널 그룹화

모든 패널 그룹화

1. Edit 클릭
2. Add new element 아이콘(파란 더하기)을 클릭하고 Group into rows 또는 Group into tabs 선택. 또는 패널 하단 위에 마우스를 올려 Group panels 버튼을 클릭하고 Group into row/Group into tab 선택.
3. 모든 패널이 그룹화로 이동하며 점선 파란 테두리가 행·탭을 감싸요. 사이드바에 관련 옵션이 열립니다.

팁: 그룹화는 보통 여러 패널에 쓰지만 패널 하나로 시작할 수도 있어요.

특정 패널만 그룹화

1. Edit 클릭
2. Shift 키를 누르고 그룹화할 패널 모두 선택(다른 그룹화에 이미 있는 패널도 선택 가능)
3. 사이드바에서 Group into row 또는 Group into tab 선택. 선택한 패널이 그룹화되고 남은 패널은 같은 유형의 다른 그룹화에 추가됩니다.

같은 레벨에 그룹화 추가

그룹화를 추가하려는 곳을 클릭하고 + New row 또는 + New tab 클릭(옵션 하나만 표시됨) → 구성 옵션 설정 → + Add panel로 패널 추가.

중첩 그룹화 추가

그룹화 내부의 패널 아래에서 Group panels 클릭 → Group into row 또는 Group into tab(Group into tab은 부모가 행일 때만 가능) → 구성 옵션 설정. 필요하면 그룹화 레벨을 하나 더 추가할 수 있어요.

패널 그룹 해제

몇 개 또는 모든 그룹화를 패널 손실 없이 해제할 수 있어요. 그룹 해제 결과는 구성에 따라 달라집니다.

• 패널만 있는 그룹화: 그룹화 레벨이 제거되고 패널이 다음 상위 그룹화로 병합. 남은 그룹화가 없으면 패널이 대시보드로 이동.
• 중첩 그룹화를 포함한 그룹화: 해제하는 그룹화 레벨만 제거. 중첩 그룹화는 한 단계 올라가고, 패널만 있는 같은 레벨 그룹화는 같은 유형으로 변환되어 구조가 보존됩니다.

중첩 그룹화가 있는 경우 규칙:

• 중첩이 전부 행이거나 전부 탭이면 Grafana가 그 레벨을 자동으로 그 그룹화 유형으로 변환
• 행·탭이 섞여 있거나 탭이 탭에 직접 중첩할 수 없어 변환이 불가능하면 Convert to rows와 Convert to tabs 중 선택하라는 안내
• 해제된 그룹화에 repeat 옵션이 구성되어 있으면 그 옵션은 유실됨. Grafana가 변경 전에 경고

해제된 그룹화에 구성된 섹션 레벨 변수·필터는 유실되지 않고 다음 레벨로 이동합니다.

주의: 그룹화를 해제하지 않고 삭제하면 패널도 함께 삭제됩니다.

그룹화 제거(Ungroup) 단계:

1. Edit 클릭
2. (선택) Content outline 아이콘으로 제거할 그룹화로 빠르게 이동
3. 관련 영역 위에 마우스를 올려 Ungroup rows/Ungroup tabs 버튼 표시 → 클릭
4. 서로 다른 패널 레이아웃에 있던 패널을 해제했다면 공통 레이아웃 선택 안내 → Convert to Auto grid 또는 Convert to Custom
5. 행·탭이 섞인 중첩이 있으면 변환 선택 안내 → Convert to rows 또는 Convert to tabs
6. Save → Exit edit

행 사이에서 탭 드래그

중첩 탭이 있는 여러 행이 있는 대시보드에서 받는 쪽 행에 중첩 탭이 하나만 있어도 드래그 앤 드롭으로 행 사이에 탭을 옮길 수 있어요.

헤더 없는 행으로 그룹화 밖에 패널 배치

패널이 있는 행에서 Hide row header 스위치를 사용하면 보기 모드에서 행 헤더가 숨겨져 패널이 그룹 해제된 것처럼 보입니다. 행 헤더를 숨기면 행을 접을 수 없어요.

섹션 레벨 변수와 필터

그룹화에 그 그룹화의 패널에만 적용되는 변수와 필터를 추가할 수 있어요. 예: 대시보드에 API 게이트웨이와 데이터베이스가 모두 있을 때 각각 다른 $instance 변수를 적용하고 싶다면, 섹션 레벨 변수·필터로 각 행·탭이 독립적인 범위를 갖게 할 수 있어요. 두 그룹화는 같은 시간 범위를 공유하고 기본 대시보드는 그대로 유지됩니다. 패널은 섹션 레벨 변수·필터를 먼저 해석한 뒤 대시보드 레벨 변수로 폴백해요.

패널 쿼리 편집기는 컨텍스트를 인식해 자동완성이 편집 중인 패널에 사용 가능한 변수만 표시해요. 섹션 레벨 변수·필터는 행/탭 변환, 레이아웃 변경, 반복 행·탭에서도 유지되며, 행·탭 해제 시 다음 레벨로 이동합니다.

더 알아보기 (Learn more)

• 대시보드 만들기
• 대시보드 컨트롤
• 패널 레이아웃