[그라파나] - [1] 그라파나(Grafana) 대시보드 생성

 

 

 

 

🧐 그라파나 (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를 통해 저장해주도록 하겠습니다.

 

 

 

 

 

 

 

🧐 마무리

이렇게 해서 그라파나를 간단하게 사용해 보았는데요, 위의 과정을 따라하셨다면 느끼겠지만 대시보드를 하나하나 입력해서 만드는 과정이 조금 번거롭고 힘듭니다.

그라파나는 이미 만들어둔 대시보드를 가져다가 사용할 수 있는 기능을 제공하는데요, 다음 글에서 이어서 확인해 보도록 하겠습니다.

 

 

 

 

 

 

 

📚 Reference

[스프링 부트 - 핵심 원리와 활용. 섹션 9] - 김영한님