대시보드 컨트롤

대시보드 컨트롤 (Dashboard controls)

사이드바의 Dashboard controls 섹션에서 대시보드를 떠나지 않고 변수, 주석 쿼리, 대시보드 링크, 그리고 데이터를 필터링·그룹핑하는 컨트롤을 추가할 수 있어요. 필터, 변수, 주석, 링크를 각각 추가하는 방법과 추가한 컨트롤을 관리하는 방법을 다룹니다.

출처: 문서

본문

사이드바의 Dashboard controls 섹션에서 대시보드를 떠나지 않고 변수, 주석 쿼리, 대시보드 링크, 그리고 데이터를 필터링·그룹핑하는 컨트롤을 추가할 수 있어요.

필터 및 group by 컨트롤 추가 (Add filters and group by controls)

참고: Filter and Group by 기능은 Ad hoc filters 변수의 이름을 바꾸고 Prometheus·Loki 데이터 소스에 그룹핑을 추가해 확장한 것입니다. 다만 대시보드 스키마에서는 여전히 variables 스키마 속성 아래 "kind": "AdhocVariable" 로 지칭됩니다.

업데이트할 대시보드로 이동해 Edit 를 클릭합니다.
Add new element 아이콘(파란색 더하기)을 클릭합니다.
Filter and Group by 를 클릭합니다.
필터의 Name 을 입력합니다.
(선택) Label 필드에 필터 드롭다운 목록의 표시 이름을 입력합니다. 표시 이름을 입력하지 않으면 드롭다운 목록 라벨은 필터 이름이 됩니다.
(선택) Description 필드에 필터 설명을 입력합니다. 설명은 대시보드의 필터 이름 옆에 정보 아이콘 툴팁으로 나타납니다. 설명은 링크를 지원해요. Markdown 스타일 링크([link text](https://example.com))나 bare URL(https://example.com)을 붙여넣을 수 있습니다. http·https URL만 클릭 가능한 링크로 렌더링되며, 다른 프로토콜은 일반 텍스트로 표시됩니다.
Display 옵션 선택:
- Above dashboard: 필터 드롭다운이 필터 Name·Label 값과 함께 대시보드 위에 표시(기본)
- Above dashboard, label hidden: 필터 이름 없이 대시보드 위에 표시
- Controls menu: 대시보드 위가 아닌 대시보드 컨트롤 메뉴에 표시. 컨트롤 메뉴는 대시보드 툴바의 버튼으로 나타남
- Hidden: 대시보드에 필터 드롭다운 미표시
페이지의 Filter options 섹션 아래에서 다음 옵션을 설정합니다:
- Data source: 드롭다운에서 대상 데이터 소스 선택. Open advanced data source picker 로 더 많은 옵션 보기(데이터 소스 추가 포함, Admins만). 데이터 소스에 대한 자세한 내용은 Add a data source 참고
- Default filters: 기본 key/value 쌍 설정(선택). 대시보드 필터 컨트롤에서 기본값은 정보 아이콘으로 표시됨
- Enable group by: Prometheus·Loki 데이터 소스를 선택한 경우에만 표시. 토글을 켜 데이터 그룹핑 활성화
- Default group by: 대시보드의 기본 key 설정(선택)
- Use static key dimensions: 필터 차원을 CSV로 제공하려면 토글을 켜고 값 입력(선택)
- Allow custom values: 대시보드 사용자가 필터·group by 목록에 커스텀 값을 추가하도록 허용(선택)
Save → (선택) 설명 입력 → Save → Exit edit.

더 자세한 내용은 Filter and group by controls 문서를 참고하세요.

변수 추가 (Add variables)

대시보드에서 Edit → Add new element 아이콘 → Variable 을 선택합니다. (대시보드 상단의 Add variable 더하기 아이콘으로도 가능)
목록에서 변수 유형을 선택합니다. 사이드바에서 Change type 을 클릭해 변수 유형을 업데이트할 수 있어요. (Query, Custom, Textbox, Constant, Data source, Interval, Switch)
변수의 Name 을 입력합니다.
(선택) Label, Description 을 입력합니다(링크 지원, 위와 동일).
Display 옵션 선택: Above dashboard(기본), Above dashboard, label hidden, Controls menu, Hidden.
변수 구성을 완료합니다. 변수 유형별 상세 구성은 각 문서를 참고하세요.
Save → Save → Exit edit.

자세한 내용은 Variables 문서를 참고하세요.

주석 쿼리 추가 (Add annotation queries)

대시보드에서 Edit → Add new element 아이콘 → Annotation query 를 클릭합니다.
주석 쿼리 이름을 입력합니다. 이 이름은 이 쿼리의 주석 이벤트 표시를 켜고 끄는 토글에 부여됩니다. 바로 사용하지 않으려면 Enabled 체크박스를 해제합니다.
주석 이벤트 마커의 색상을 선택합니다.
Show annotation controls in 드롭다운에서 주석 표시 위치 선택: Above dashboard(기본), Controls menu, Hidden.
Show in 드롭다운에서 주석이 표시될 패널 선택: All panels(주석을 지원하는 모든 패널), Selected panels(선택한 모든 패널), All panels except(선택한 것 제외 모든 패널).
주석 쿼리를 추가하려면:
- Open query editor 클릭 → Annotation Query 대화상자에서 Data source 드롭다운 옵션을 선택하고 쿼리를 작성·구성합니다(주석 쿼리 옵션은 데이터 소스마다 다름).
- 또는 Use saved query 클릭 → Saved queries 드로어에서 재사용할 saved query를 선택하고 Select query 클릭.
- 참고: Saved queries는 Grafana Enterprise와 Grafana Cloud에서만 사용할 수 있어요.
(선택) Test annotation query 로 쿼리가 제대로 작동하는지 확인.
Close → Save → Save → Exit edit.

자세한 내용은 Annotations 문서를 참고하세요.

링크 추가 (Add links)

다른 대시보드 링크 추가: Edit → Add new element → Link (기본 유형 Dashboards). With tags 드롭다운에 태그를 입력해 입력한 태그가 있는 대시보드로만 연결을 제한합니다(태그 없으면 모든 대시보드 링크 포함). 링크 옵션: Show as dropdown, Include current time range(예: https://play.grafana.org/d/000000010/annotations?orgId=1&from=now-3h&to=now), Include current template variable values, Open link in new tab, Show in controls menu. Save → Save → Exit edit.

URL 링크 추가: Edit → Add new element → Link → Type을 Link 로 선택 → URL 필드에 링크할 URL 입력(필드 값 포함 가능, 예: https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests) → Tooltip 입력 → Icon 선택 → 링크 옵션 설정(URL 링크 기본 활성화) → Save → Save → Exit edit.

자세한 내용은 Dashboard links 문서를 참고하세요.