변수
변수 (Variables)
변수는 대시보드 쿼리, 패널 제목, 링크, 기타 대시보드 요소에서 사용할 수 있는 값의 자리표시자예요. 변수 값을 바꾸면 그 변수를 사용하는 모든 대시보드 요소가 업데이트돼요. 변수는 대시보드 상단에 드롭다운(또는 텍스트 필드)으로 표시되어, 뷰어가 대시보드를 편집하지 않고 표시 내용을 바꿀 수 있게 해요.
출처: 문서
본문
예를 들어 여러 서버를 모니터링해야 한다면 서버마다 대시보드를 만들 수도 있지만, 변수를 쓰는 패널 하나로 서버를 선택할 수도 있어요. 변수를 사용하면 서버·애플리케이션·리전·센서 이름 같은 값을 하드코딩하지 않고 한 번 정의해 대시보드 전체에 재사용할 수 있어요. 또한 하나의 대시보드로 여러 동일 데이터 소스·서버를 커버하는 단일 소스(single-source) 대시보드를 만들어 중복과 유지보수를 줄일 수 있어요.
변수는 다음에 사용할 수 있어요:
- 데이터 소스 쿼리
- 패널 반복(repeating) 옵션
- 대시보드·패널 링크
- 제목
- 설명
- 변환(transformations)
변수 작업은 보통 다음 과정을 따라요:
- 뷰어가 제어할 값에 맞는 변수 유형 선택.
- 변수를 대시보드에 추가.
- 쿼리·제목·링크·기타 대시보드 필드에서 변수 사용.
- 대시보드가 커지면 변수 순서·의존성·URL 동작 관리.
변수 설정을 보려면 대시보드 오른쪽 위의 Edit 클릭 → 툴바의 Dashboard options 아이콘 → Variables 섹션 확장.
사용자가 만든 변수와 전역 변수
Grafana는 두 종류의 변수를 지원해요:
- 사용자가 만든 변수: 대시보드별로 정의·구성하는 변수. 뷰어가 서버, 데이터 소스, 리전, 환경, 간격 같은 값을 선택할 때 사용. 설정은 Add variables 참고.
- 전역 변수(Global variables): Grafana가 자동 제공하는 내장 변수(현재 시간 범위, 대시보드 이름, 조직, 로그인 사용자 등). 전체 참조는 Global variables 참고.
변수 유형 선택
변수 유형은 Grafana가 값을 어떻게 얻고 사용자가 어떻게 상호작용하는지에 따라 고른다. 대표 유형:
- Query: 쿼리가 반환한 값 목록(예:
groupByNode(movingAverage(apps.$app.$server.counters.requests.count, 10), 2, 'sum')). - Custom: 수동으로 정의한 값 목록.
- Constant: 고정 값.
- Text box: 사용자가 입력하는 자유 텍스트.
- Data source: 데이터 소스 선택.
- Interval: 시간 간격 드롭다운.
- Ad hoc filters: 임시 키/값 필터.
사용 예 — 쿼리 변수
쿼리 변수는 다른 쿼리의 결과를 드롭다운으로 보여줘요. 예:
groupByNode(movingAverage(apps.$app.$server.counters.requests.count, 10), 2, 'sum')
변수($app, $server)가 치환되면서 동적 쿼리가 돼요.