대시보드 문제 해결
대시보드 문제 해결 (Troubleshoot dashboards)
대시보드가 기대한 대로 표시되지 않을 때 흔한 문제와 해결 방법을 안내해요. 빈 패널, 데이터 소스 오류, 변수 문제, 패널 렌더링 문제 등을 진단하는 방법을 다뤄요.
출처: 문서
본문
빈 패널 (No data)
패널에 데이터가 없으면 다음을 확인해요:
- 시간 범위: 선택한 시간 범위에 데이터가 있는지 확인. 시간 범위가 너무 좁거나 미래라면 데이터가 안 보여요.
- 데이터 소스 접근: 데이터 소스가 올바르고 접근 가능한지 확인. Grafana 서버가 데이터 소스에 연결할 수 있어야 해요.
- 쿼리 결과: 쿼리 문법이 올바른지, 변수가 제대로 치환되는지 확인.
- 라벨/필터: 데이터를 필터링하는 라벨·변수가 실제 데이터와 일치하는지 확인.
데이터 소스 오류
패널에 데이터 소스 오류가 표시되면:
- 데이터 소스 설정(URL, 인증)을 검증.
- 데이터 소스의 Explore에서 쿼리를 직접 실행해 오류를 확인.
- 네트워크·방화벽이 데이터 소스 접근을 막지 않는지 확인.
변수 문제
변수로 대시보드를 필터링할 때:
- 변수 쿼리가 데이터를 반환하는지 확인.
- 변수 값이 실제 존재하는 값과 일치하는지 확인.
- 변수 의존성(상위 변수에 의한 하위 변수)이 올바른지 확인.
패널 렌더링 문제
패널이 로딩되지 않거나 느리면:
- 쿼리 성능: 복잡한 쿼리가 느리면 타임아웃이 날 수 있어요. 쿼리 최적화, 인덱스, 쿼리 캐싱을 고려해요.
- 브라우저 문제: 캐시를 지우고, 다르게 렌더링 환경(이미지 렌더러)을 확인.
- 범위: 시각화에 적합한 시간 범위·데이터 형태인지 확인(예: 표 데이터를 시계열 그래프에 쓰는 경우).
기타 흔한 문제
- 권한: 대시보드를 보거나 보는 데 필요한 권한이 있는지 확인.
- 애노테이션: 애노테이션 데이터 소스가 올바른지 확인.
- 패널 이벤트·링크: 링크가 올바른 URL을 가리키는지 확인.
진단 팁
- Query Inspector: 패널 편집 → 쿼리 인스펙터로 원문 쿼리·응답·오류를 확인.
- Explore에서 재현: 대시보드 쿼리를 Explore에서 재현해 문제를 격리.
- 데이터 소스 상태 확인: Administration > Data sources에서 연결 테스트.