템플릿 변수 추가하기

템플릿 변수 추가하기

템플릿 변수(template variables)는 대시보드를 동적이고 재사용 가능하게 만들어주는 기능입니다. 변수를 대시보드 상단의 드롭다운으로 만들고, 쿼리·패널에서 ${변수명}으로 참조하면 사용자가 값을 바꿀 때마다 전체 대시보드가 갱신돼요.

출처: Add template variables

본문

변수란?

변수는 대시보드에 전달되는 값을 나타내는 자리표시자입니다. 변수 값을 바꾸면 그 변수를 참조하는 모든 쿼리와 패널, 경고가 새 값으로 다시 평가됩니다.

일반적인 변수 사용 예:

  • 서버, 애플리케이션, 센서 이름을 하드코딩하지 않고 드롭다운으로 선택
  • 데이터 소스, 시간 범위, 메트릭 이름을 동적으로 지정

변수 추가

  1. 대시보드의 Settings를 엽니다.
  2. Variables 탭을 클릭합니다.
  3. Add variable을 클릭합니다.
  4. General 설정에서 다음을 지정합니다.
    • Name – 변수의 이름. ${name}으로 참조됩니다.
    • Label – 드롭다운에 표시할 레이블(선택).
    • Type – 변수의 유형.
    • Hide – 변수의 표시 여부(표시, 숨김, 라벨만).
  5. 유형별 설정을 완료하고 Add를 클릭합니다.

변수 유형

  • Query – 데이터 소스 쿼리 결과의 값을 드롭다운으로 표시합니다. 가장 일반적이며, 예를 들어 특정 측정 항목의 호스트 목록을 가져옵니다.
  • Custom – 직접 정의한 값 목록을 드롭다운으로 표시합니다.
  • Constant – 변하지 않는 하나의 상수 값.
  • Text box – 사용자가 값을 입력하는 텍스트 상자.
  • Interval – 1m, 1h 같은 시간 간격 값을 선택합니다.
  • Data source – 데이터 소스 목록을 선택합니다.
  • Ad hoc filter – 임시로 키-값 필터를 추가합니다. 쿼리에서 $adhoc로 참조해 WHERE 절로 적용됩니다.

Query 변수

Query 변수는 다음과 같이 구성합니다.

  1. Type을 Query로 설정합니다.
  2. Data source – 값을 가져올 데이터 소스를 선택합니다.
  3. Query – 값 목록을 반환하는 쿼리를 입력합니다(예: label_values(metric, host)).
  4. Refresh – 변수 값 갱신 시점(On time range change, On dashboard load, Never)을 설정합니다.
  5. Multi-value / Include All option – 변수를 여러 값 선택으로 하거나 "All" 옵션을 포함할지 설정합니다.

변수 사용

  • 쿼리에서 ${변수명}로 참조합니다.
  • 시각화 구성에서도 사용할 수 있습니다.
  • 변수 값은 URL 쿼리 파라미터로도 전달되어 대시보드 상태를 공유할 수 있습니다.

변수 값 포맷팅

변수 값이 여러 개이거나 "All"일 때 쿼리에서 사용하는 포맷을 지정할 수 있습니다(glob, regex, pipe, csv 등). 이는 데이터 소스의 쿼리 문법에 맞춥니다.

더 알아보기