스프링 & 프로메테우스 & 그라파나 (그라파나 설치, 연동, 사용 방법)

스프링 & 프로메테우스 (설치, 설정, 기본 기능) (tistory.com)

스프링 & 프로메테우스 (설치, 설정, 기본 기능)

저번 글에서 프로메테우스를 설치하고 스프링과 연동해서 메트릭을 수집하고 보관하는 방법에 대해서 알아봤다. 

프로메테우스는 메트릭을 수집하고 보관하는 DB로 프로메테우스를 스프링과 연동하기 위해서는 애플리케이션 설정을 통해 프로메테우스 포맷에 맞게 메트릭을 만들고, 프로메테우스가 이 메트릭을 주기적으로 수집하도록 설정해주면 된다.

 

프로메테우스가 DB라면 이제 그라파나는 이 DB에 있는 데이터를 불러와서 사용자가 보기 편하게 보여주는 대시보드이다. 

 

 

 

1️⃣ 그라파나 설치 

 

Download Grafana | Grafana Labs

Download Grafana | Grafana Labs

위에 링크를 타고 들어가서 자신에게 맞는 OS 를 선택해서 다운로드 해주면 된다. 

그 후 압축을 풀고 그 폴더에서 bin 폴더로 이동해서 grafana-server.exe를 실행해주면된다. 

(실행하려고 하면 window의 pc 보호 화면 경고창이 뜰건데 '추가정보' 클릭 한 다음 실행해주면 된다. 

 

 

실행한 다음에 localhost:3000으로 들어가면

처음엔 로그인 화면이 뜰건데 id: admin, pwd : admin 으로 들어가면 된다

(연습이니까 그냥 비밀번호 다시 설정하라고 할 때 skip한다) 

그 다음엔 메인 화면이 보이면 설치 성공이다. 

 

 

 

 

2️⃣ 그라파나 연동 

그라파나는 프로메테우스를 통해 데이터를 조회하고 보여주는 역할을 한다. 

 

동작 방식을 생각해보면 

1. 애플리케이션에서 마이크로미터가 프로메테우스 포맷에 맞추어 메트릭을 측정한다. 

2. 프로메테우스가 메트릭을 지속적으로 수집해서 저장한다.

3. 그라파나가 프로메테우스를 통해 데이터를 조회해서 대시보드로 보여준다.

 

그라파나가 대시보드를 보여주기 위해서는 그럼 데이터가 필요한데 먼저 그라파나가  프로메테우스를 데이터소스로 사용해서 데이터를 읽어와야 한다. 

 

 

 

프로메테우스 데이터 소스 추가 

- 왼쪽에 Configuration 을 버튼을 클릭하고 Data sources 를 선택한다. 

 

그러면 위에 화면을 볼 수 있는데 Add data source 를 선택한다. 

 

우리는 Data Source를 프로메테우스 사용하기로 했으므로 프로메테우스를 선택한다. 

 

 

프로메테우스 데이터 소스 설정으로는 url에 http://localhost:9090 (프로메테우스 url 을 입력해주면 된다.) 

 

지금은 더 고칠 부분이 없기 때문에 그대로 두고 Save & test 선택하고 나면 설정이 완료된다. 

 

 

 

3️⃣ 그라파나 대시보드 만들기 

그라파나 대시보드를 만들기 위해서는 우선 애플리케이션, 프로메테우스 ,그라파나 모두 실행되고 있는 상태여야 한다. (당연한 얘기긴 함) 

 

 

* 대시보드 만들기

왼쪽에 New -> New Dashboard 선택 

 

우측 상단에 Save dashboard를 선택 

 

name : hello dashboard 

하고 저장 누르면 대시보드가 저장된다. 

 

왼쪽 메뉴에서 Dashboards를 클릭하고 보면 

 

위에서 저장했던 대시보드가 있는 것을 확인할 수 있다. 

 

 

* 패널 만들기 

이제 새로 만든 대시보드에 패널을 추가할 건데 Add a new panel 메뉴 선택한다. 

 

그러면 이런 기본 화면을 확인할 수 있는데 여기서 Builder 탭에서 Code 탭으로 바꿔주고 

Enter a PromQL query... 이 부분에 메트릭을 입력해서 그래프를 만들 수 있다. 

 

 

* CPU 사용량 그래프 만들기 

Enter a PromQL query... 이라는 부분에 system_cpu_usage(시스템의 CPU 사용량) , process_cpu_usage(JVM 프로세스 CPU 사용량) 를 입력하고 Run quries 버튼을 선택하면 된다. 

 

그래프의 이름을 변경하고 싶다면 Options 를 선택하고 Legend를 선택하고 Custom으로 바꿔준 다음에 각각 system cpu, process cpu를 입력해주면 된다. 

 

 

그리고 Save -> Apply 해주면 대시보드에 새로운 패널이 추가된 것을 확인할 수 있다. 

 

 

* 디스크 사용량 추가하기 

위와 같이 패널을 추가해주고, 

Title : 디스크 사용량 

 

PromQL 

- disk_total_bytes 

: 전체 용량 

 

- disk_total_bytes - disk_free_bytes 

: 사용 용량 (전체 디스크 용량 - 남은 디스크 용량) 

 

그래프 데이터 사이즈 변경

오른쪽 옵션 창을 밑으로 내리다 보면 Standard-options -> Unit -> Data -> bytes(SI) 를 선택해주면 GB, TB 단위로 읽기 편하게 바뀐다. 

 

최소값 변경

Standard options -> Min 을 0으로 선택해주면 그래프가 0부터 시작하도록 바뀐다. 

 

마찬가지로 Save -> Apply 해주면 대시보드에 새로운 패널이 추가된다.

 

 

 

4️⃣ 공유 대시보드 

위에서 대시보드를 만든 것처럼 메트릭을 하나하나 추가해서 대시보드를 만들 수 있는데..

이렇게 하나하나 다 만드는 것도 힘들긴 하다... 😀 

따라서 그라파나는 이미 만들어진 대시보드를 가져와서 사용할 수 있도록 하는 기능을 제공해준다. 

 

Dashboards | Grafana Labs

Dashboards | Grafana Labs

 

위 링크를 타고 들어가면 다른 사람들이 만든 대시보드가 공개되어 있고 이를 가져와서 사용할 수 있다!! 

 

 

검색창에 spring이라고 치면 다양한 대시보드를 확인할 수 있다. 

 

 

* 스프링 부트 시스템 모니터 대시보드 

먼저 Spring boot System monitor 대시보드를 불러와서 사용해볼 것이다. 

저 화면에서 Copy ID to clipboard를 클릭해서 ID를 복사해준다. 

 

그라파나 대시보드 화면에서 New -> Import 를 한 다음 

 

복사한 ID를 입력해준 다음 Load 해주면 된다. 

 

대시보드를 확인해보면 거의 대부분의 메트릭이 대시보드에 표현된 것을 확인할 수 있다. 

여기서 대시보드를 수정하고 싶으면 오른쪽 상단에 설정 버튼을 선택한 다음 Make editable 선택해주면 된다. 

 

* Jetty 통계  -> Tomcat 통계 

불러온 대시보드에서는 Jetty라는 웹 서버를 기준으로 통계를 수집하고 있기 때문에 톰캣으로 수정해줘야 한다. 

 

- Thread Config Max 패널 설정 변경 

기존 jetty_threads_config_max -> tomcat_threads_config_max_threads로 변경해준다. 

 

- Thread 패널 설정 변경 

jetty_threads_current -> tomcat_threads_current_threads 로 변경

jetty_threads_busy -> tomcat_threads_busy_threads로 변경 

jetty_threads_idle 제거 

jetty_threads_jobs 제거 

 

다음 Save -> Apply 해주면 추가된 대시보드를 확인할 수 있다. 

 

 

 

* JVM(Micrometer) 대시보드 

아까와 동일하게 id 복사해주고 대시보드에서 import 해준다. 

 

 

이렇게 미리 잘 만들어진 대시보드를 활용하면 좀 더 편리하게 모니터링 환경을 구성할 수 있다!