뷰 변수¶

뷰 변수는 Guance 시나리오에서 차트 연동 필터링을 구현하는 핵심 메커니즘입니다. 사용자가 하나 이상의 뷰 변수 값을 변경하여 여러 차트가 동시에 동일한 필터 조건에 응답하고 실시간으로 시각화 결과를 업데이트할 수 있도록 합니다.

사용 사례 비교¶

❌ 뷰 변수 없음	✅ 뷰 변수 있음
호스트 A의 모니터링 보기: CPU 차트로 이동하여 조회 조건을 `host=A`로 수정; 메모리 차트로 이동하여 조회 조건을 `host=A`로 수정; 디스크 차트로 이동하여 조회 조건을 `host=A`로 수정	호스트 A의 모니터링 보기: 상단 드롭다운에서 "호스트 A"를 선택하면 모든 차트가 자동으로 새로고침
10개의 차트를 10번 조작해야 함	10개의 차트를 1번만 조작하면 됨
팀 구성원이 각자 수정하여 구성이 혼란스러워지기 쉬움	통합 진입점, 구성 중앙 관리

대시보드 상단의 전역 필터 컨트롤로서 작동 원리는 다음과 같습니다.

변수 이름: 현재 뷰 변수 컬렉션이 속한 변수 이름입니다. 대시보드에 차트를 추가할 때 차트 조회에서 참조해야 하며 형식은 #{변수 이름}입니다.
표시 이름: 현재 뷰 변수 컬렉션이 대시보드에 표시되는 이름입니다. 예: 변수 이름이 host이면 표시 이름은 호스트 이름입니다.
조회: 선택 가능한 값의 데이터 출처를 정의합니다.
정렬: 조회에서 반환된 뷰 변수에 대해 기본, 오름차순, 내림차순 정렬을 수행합니다.
표시 옵션을 결정합니다.
기본값: 현재 뷰 변수가 대시보드에서 가질 초기값입니다. "표시 옵션" 구성에 따라 드롭다운에 변수가 나열되며, 대시보드에 기본으로 표시할 초기값을 선택할 수 있습니다. 기본값이 비어 있으면 대시보드에 최신 필드 데이터가 표시됩니다. 선택을 클릭하면 현재 목록의 모든 값을 선택할 수 있습니다.
저장.

참고

워크스페이스 데이터가 중단된 경우 뷰 변수에 필드를 미리 설정할 수 있습니다. 데이터가 복구되면 시스템이 자동으로 매칭합니다.

옵션	기능 설명	사용 사례
숨김	활성화하면 편집 모드가 아닐 때 해당 변수가 대시보드에서 표시되지 않습니다.	프로덕션 환경만 보도록 강제하는 등 조건을 고정하는 데 사용합니다.
다중 값	여러 값을 동시에 선택할 수 있습니다.	여러 호스트를 비교해야 할 때 활성화합니다.
포함 `*`	기본 활성화됩니다(❗️ `*`를 선택하면 해당 변수의 필터 조건이 무시되고 차트에 전체 데이터가 표시됩니다). 이 필드 필터를 무시합니다. 차트 조회에 해당 변수의 필터 조건이 포함되지 않습니다. 모든 변수 값이 필터 조건으로 사용됩니다(최대 100개 값 지원). 데이터가 너무 많으면 성능에 영향을 미칠 수 있으므로 필요에 따라 사용하세요.	전체 데이터를 기본으로 확인해야 할 때 활성화합니다.

뷰 변수 목록에서 다음 작업을 수행할 수 있습니다.