Grafana로 메트릭 시각화하기

Grafana로 메트릭 시각화하기 (Visualizing metrics using Grafana)

프로메테우스에 저장된 메트릭을 Grafana와 연동해 대시보드로 시각화하는 방법을 배우는 튜토리얼이에요. 프로메테우스 자체에도 기본 그래프 기능이 있지만, Grafana는 더 풍부하고 유연한 대시보드 환경을 제공해요. PromQL 쿼리를 Grafana 패널에 넣어서 다양한 종류의 시각화를 만들고, 대시보드를 모아서 한눈에 서비스를 모니터링하는 방법을 다룹니다.

지난 튜토리얼들에서 만든 메트릭(예: ping_request_count)을 이제 대시보드로 그려보는 실습이에요. Grafana 설치, 프로메테우스 데이터 소스 연결, 패널 쿼리 작성까지 차근차근 따라 할 수 있어요.

출처: 문서

본문

Grafana란?

Grafana는 메트릭 데이터를 시각화하고 대시보드를 만드는 오픈소스 도구예요. 프로메테우스뿐 아니라 다양한 데이터 소스를 지원하며, 풍부한 그래프·패널·알림 기능을 제공해요.

이 튜토리얼에서는 앞서 만든 Go 서버 계측 예제의 메트릭을 Grafana로 시각화해 볼 거예요.

Grafana 설치

Grafana는 공식 다운로드 페이지에서 운영체제에 맞는 버전을 받아 설치할 수 있어요. 설치 후 기본 포트인 http://localhost:3000에서 접속해요.

기본 로그인은 관리자 계정(admin/admin)이에요. 로그인하면 대시보드 화면이 나와요.

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

메트릭을 불러오려면 먼저 프로메테우스를 데이터 소스로 연결해야 해요.

  1. Grafana 왼쪽 메뉴에서 Configuration → Data Sources로 이동
  2. "Add data source" 클릭
  3. Prometheus를 선택
  4. URL을 프로메테우스 서버 주소로 설정 (기본: http://localhost:9090)
  5. Save & Test로 연결 확인

이제 Grafana가 프로메테우스에 쌓인 메트릭을 읽을 수 있게 됐어요.

대시보드와 패널 만들기

데이터 소스를 연결했다면 대시보드를 만들 차례예요.

  1. 왼쪽 메뉴에서 + → Dashboard
  2. "Add panel"로 새 패널 추가
  3. 패널 편집 화면의 쿼리 입력에 PromQL을 작성

예를 들어 앞서 계측한 ping_request_count 메트릭을 그리려면:

rate(ping_request_count[5m])

rate()를 쓰면 카운터의 초당 증가율을 시계열로 그릴 수 있어요. 실행하면 패널에 그래프가 나타나요.

또한 원하는 레이블로 필터링하거나 라벨 값으로 여러 시리즈를 나누어 그릴 수도 있어요:

ping_request_count{job="simple_server"}

패널 시각화 유형

Grafana는 다양한 시각화 유형을 지원해요. 가장 흔한 것들:

  • Time series (시계열): 시간축에 따른 값 변화를 선 그래프로 표시 (가장 기본)
  • Stat: 현재 값 하나를 크게 표시
  • Gauge: 현재 값을 게이지(dial) 형태로 표시
  • Bar gauge: 여러 값의 막대 게이지

방금 만든 쿼리에 알맞은 시각화를 고르고, 패널 이름을 지정한 뒤 저장하면 대시보드에 추가돼요.

값으로 표시하는 방법

카운터를 단순히 현재 값으로 보고 싶다면 rate() 없이 그냥 써도 되지만, 카운터의 의미상 증가율이 더 유용한 경우가 많아요. 게이지 메트릭이라면 값이 자유로이 변하므로 그대로 표시하면 됩니다.

대시보드 저장과 공유

만든 대시보드는 저장되고, 다른 팀원과 공유할 수 있어요. Grafana의 알림 기능을 붙이면 프로메테우스 메트릭 기반으로 조건을 걸어 통지도 가능해요.

이 튜토리얼에서는 Grafana를 설치하고, 프로메테우스를 데이터 소스로 연결하고, PromQL 쿼리로 대시보드 패널을 만드는 방법을 살펴봤어요.

더 알아보기 (Learn more)