🧐 그라파나 (Grafana)
이전 글에서 간단히 언급했지만 다시 한 번 하도록 하겠습니다.
프로메테우스가 DB라고 한다면, 이 DB에 있는 데이터를 불러서 사용자가 보기 편하게 보여주는 대시보드가 필요합니다.
그라파나는 데이터를 그래프로 보여주는 툴입니다.
수 많은 그래프를 제공하고, 프로메테우스를 포함한 다양한 데이터소스를 지원합니다.
🧐 그라파나 설치
그라파나 설치 사이트(https://grafana.com/grafana/download)로 이동합니다.
여기서는 맥 OS 기준으로 설치를 진행하겠습니다.
위의 명령어를 복사합니다.
이후 그라파나를 설치할 (임의의)폴더로 이동한 뒤, 위의 명령어를 그대로 입력합니다.
(설치하는데 시간이 좀 걸릴 수 있습니다)
그라파나를 설치할 폴더의 bin 폴더로 이동하여 ./grafana-server를 실행합니다.
잘 실행되었다면 localhost:3000으로 접속합니다.
위와 같이 로그인 페이지가 뜰 것인데, username과 password 모두 admin을 입력합니다.
위와 같이 비밀번호를 변경하라는 창이 뜰텐데, 그라파나를 간단히 살펴보는 것이 목적이므로 Skip을 눌러 건너뛰도록 하겠습니다.
이렇게 해서 그라파나의 설치가 끝났습니다.
🧐 그라파나와 프로메테우스 연동
그라파나는 프로메테우스를 통해서 데이터를 조회하고 대시보드에 보여주는 역할을 수행합니다.
우선 애플리케이션과 프로메테우스가 모두 실행중인 상태여야 하기 때문에, 만약 실행중이지 않다면 이들을 모두 실행해주세요.
Home - Administration - Data Sources를 클릭합니다.
Add data source를 클릭합니다.
Prometheus를 클릭합니다.
HTTP의 URL만 http://localhost:9090(프로메테우스 주소)으로 입력한 뒤 나머지는 기본 값 그대로 진행합니다.
Save & test를 클릭합니다.
다음과 같이 Data source is working이 뜬다면 연동 성공입니다.
🧐 대시보드 만들기
이제 그라파나를 사용해서 주요 메트릭을 대시보드로 만들어 보겠습니다.
우선 다음 작업을 반드시 사전에 해두어야 합니다.
- 애플리케이션 실행
- 프로메테우스 실행
- 그라파나 실행
Dashboards를 클릭합니다.
New를 클릭하고 New Dashboard를 클릭합니다.
우선 Save dashboard를 클릭합니다.
대시보드 이름을 원하는데로 바꿔준 뒤 Save를 클릭합니다.
🧐 패널(Panel) 만들기
대시보드를 틀이라 생각하면, 패널은 그 속에 들어가는 실제 그래프를 보여주는 컴포넌트입니다.
Add visualization을 클릭합니다.
먼저 Builder 대신 Code로 변경합니다.
이후 프로메테우스 쿼리를 작성해야 하는데, 우선 간단하게 system_cpu_usage를 작성하였습니다.
이후 Run queries를 통해 쿼리를 실행합니다.
🐳 메트릭 추가하기
이제 프로세스 CPU 사용량도 같이 보여주도록 하겠습니다.
+ Query를 클릭합니다.
process_cpu_usage를 입력하고 Run queries를 클릭합니다.
🐳 시간 변경하기
현재 표시되는 시간 단위가 최근 6시간 기록인데, 이를 최근 30분으로 변경해 보도록 하겠습니다.
시간 표시 부분을 클릭한 뒤 Last 30 minutes로 변경하면 됩니다.
🐳 범례(Legend) 이름 변경하기
위와 같이 차트에 제공되는 데이터의 종류를 구분하는 텍스트를 범례(Legend)라 부릅니다.
현재는 JSON 형태로 표시되어 있는데, 해당 이름을 변경하도록 하겠습니다.
Options - Legend - Custom을 클릭합니다.
원하는 이름(위에서는 system cpu)을 입력하고 엔터를 누르면 범례의 이름이 변경되는 것을 알 수 있습니다.
프로세스 CPU 사용량도 process cpu로 변경해주고 이어서 진행하겠습니다.
🐳 패널 이름 변경하기
위와 같이 화면 우측의 Panel options의 Title에서 패널 이름을 변경할 수 있습니다.
🐳 패널 저장하기
화면 우측 상단의 Save 혹은 Apply를 클릭합니다.
위와 같이 패널이 잘 추가된 것을 확인할 수 있습니다.
🐳 패널 하나 더 추가
이번에는 디스크 사용량을 보여주는 패널을 추가해보도록 하겠습니다.
Add - Visualization을 클릭합니다.
저는 다음과 같이 설정했습니다.
- Title : 디스크 사용량
- 매트릭 : disk_total_bytes
- Legend : 전체 용량
- 매트릭 : disk_total_bytes - disk_free_bytes
- Legend : 사용 용량
🐳 메트릭 단위 변경하기
현재 디스크 사용량이 바이트 단위로 표시되고 있는데, 한눈에 잘 들어오지 않아 단위를 변경하려고 합니다.
Standard options - Unit - Data - bytes(SI) 를 선택합니다.
다음과 같이 바뀌는 것을 확인할 수 있습니다.
🐳 메트릭 최솟값 설정하기
Standard options-Min 에서 최솟값을 설정합니다.
이제 이를 저장합니다.
🐳 패널 위치 변경
패널의 위치를 변경하기 위해서는 단지 해당 패널을 드래그 해주시면 됩니다.
지금까지 변경한 부분들을 Save dashboard를 통해 저장해주도록 하겠습니다.
'[GPUaaS] > Grafana' 카테고리의 다른 글
| [NCP 참고] Grafana Alert vs Prometheus Alertmanager 차이 (0) | 2026.01.13 |
|---|---|
| [NCP 실전] Grafana와 Slack 연동하여 Alert 설정하기 (0) | 2026.01.13 |
| [GPUaaS] 운영자 입장에서는 Grafana Alerting이 훨씬 쉽고 빠르다. (0) | 2026.01.13 |
| [NCP 실전] 실무에서 가장 많이 쓰는 PromQL 템플릿 - Grafana의 Query Builder 쓰면 PromQL 자동 생성 (0) | 2026.01.13 |
댓글