Grafana 문제 해결하기 — 로그·패널·변환·렌더링 디버깅 방법
Grafana 문제 해결하기 — 로그·패널·변환·렌더링 디버깅 방법
Grafana를 쓰다 보면 대시보드가 안 뜨거나, 렌더링된 이미지에서 글자가 사라지거나, 성능이 느려지는 문제가 생길 수 있어요. 이럴 때 어디부터 봐야 하는지 방법을 정리해 봤어요. 대부분은 로그를 먼저 확인하고, 변환(transformation) 순서를 점검하면 해결돼요.
본문
Grafana에서 문제가 생겼을 때 확인할 수 있는 도구와 조언을 단계별로 살펴볼게요.
로그로 문제 해결하기
오류나 문제가 생기면 가장 먼저 서버 로그를 확인해 봐요. 유닉스 시스템에서는 보통 /var/log/grafana/grafana.log에 있고, 다른 플랫폼이나 수동 설치에서는 <grafana_install_dir>/data/log에 있어요. 로그를 더 상세히 보려면 Grafana 구성 파일에서 로그 레벨을 올리면 돼요. Grafana CLI의 디버그 로깅 활성화와 구성 파일의 로그 섹션을 참고하면 더 자세히 알 수 있어요.
대시보드·패널 문제 해결하기
대시보드 패널에 문제가 있다면 디버그 정보를 전송해서 도움을 받을 수 있어요. Grafana Labs 지원팀에 패널을 보내 조사하도록 요청할 수 있어요.
변환(transformation) 문제 해결하기
변환의 순서가 중요해요. 여러 변환을 거친 최종 데이터가 이상하다면 변환 순서를 바꿔 보세요. 각 변환은 원본(raw) 데이터가 아니라 바로 이전 변환의 결과를 입력으로 받아요. 이 순서를 기억하면 예상 밖의 결과를 이해하기 쉬워져요.
서버 측 이미지 렌더링에서 글자가 사라질 때 (RPM 기반 Linux)
서버 측 PNG 렌더링은 시각화를 공유할 때(예를 들어 알림에 이미지를 넣을 때) 유용한 선택 기능이에요. 렌더링된 이미지에서 글자가 빠져 보인다면 폰트 패키지가 설치되어 있는지 확인해 봐요. RPM 기반 배포판에서는 아래 명령으로 폰트를 설치해요.
sudo yum install fontconfig
sudo yum install freetype*
sudo yum install urw-fonts
백엔드 성능 문제 해결하기
메모리나 CPU 사용량이 높아지는 백엔드 성능 문제가 있다면 프로파일링과 트레이싱을 구성해 원인을 찾아보세요. Grafana를 프로파일링·트레이싱으로 진단하는 방법 문서를 참고하면 도움이 돼요.
더 많은 도움 받기
Grafana 커뮤니티에서 추가 도움을 받을 수 있어요. 글을 올리거나 댓글을 달려면 로그인이 필요해요.