Grafana와 InfluxDB 시작하기

Grafana와 InfluxDB 시작하기 (Get started with Grafana and InfluxDB)

InfluxDB는 InfluxData가 개발한 오픈소스 시계열 데이터베이스(TSDB)예요. 운영 모니터링, 애플리케이션 메트릭, IoT 센서 데이터, 실시간 분석 같은 분야의 시계열 데이터를 빠르고 고가용성으로 저장·검색하도록 최적화되어 있어요. 이 문서는 InfluxDB를 Grafana와 함께 연결하고 쿼리하는 과정을 안내해요.

출처: 문서

본문

InfluxDB 설치

InfluxDB를 다운로드해 로컬에 설치하거나 InfluxDB Cloud에 가입할 수 있어요. 일부 InfluxDB 버전에서는 Windows 설치 프로그램을 제공하지 않아요.

다른 InfluxDB 소프트웨어 설치

  • Telegraf를 설치해요. 이 도구는 메트릭을 InfluxDB로 가져오는 에이전트예요. 자세한 내용은 Telegraf 문서를 참고하세요.
  • InfluxDB Cloud를 사용한다면 InfluxDB Cloud CLI를 다운로드해 설치해요. 이 도구는 클라우드 계정에 명령줄 지시를 보낼 수 있게 해줘요. 자세한 내용은 Influx CLI 문서를 참고하세요.

InfluxDB에 데이터 넣기

로컬 머신에 InfluxDB를 다운로드해 설치했다면 Quick Start 기능으로 InfluxDB 메트릭을 시각화해요. 클라우드 계정을 쓴다면 마법사가 초기 과정을 안내해요. Configure Telegraf 문서를 참고하세요.

Windows 사용자 주의: Windows 사용자는 추가 조정이 필요할 수 있어요. InfluxData 문서와 "Using Telegraf on Windows" 블로그 글의 특별 지침을 찾아보세요. InfluxDB Cloud의 일반 시스템 모니터링 템플릿은 Windows와 호환되지 않아요. Windows로 시스템을 모니터링하려면 Windows System Monitoring Template을 사용해야 해요.

Grafana에 InfluxDB 데이터 소스 추가

Grafana에는 InfluxDB 데이터 소스를 두 개 이상 정의할 수 있어요.

  1. 일반 지침에 따라 데이터 소스를 추가해요.
  2. 쿼리 언어로 InfluxQL을 쓸지 Flux를 쓸지 결정해요.

InfluxDB 가이드

InfluxDB는 각 버전을 Grafana에 연결하는 가이드를 제공해요.

중요 팁

  • Grafana 토큰이 읽기 접근 권한이 있는지 확인하세요. 없으면 인증 오류가 나고 Grafana를 InfluxDB에 연결할 수 없어요.
  • 버킷(bucket)과 토큰 이름에 아포스트로피나 기타 비표준 문자를 피하세요.
  • 조직이나 버킷의 텍스트 이름이 동작하지 않으면 ID 번호를 시도해보세요.
  • InfluxDB에서 버킷 이름을 바꾸면 Grafana와 Telegraf .conf 파일에서도 바꿔야 해요.

쿼리 추가

이 단계는 Grafana에서 데이터 소스를 설정할 때 선택한 쿼리 언어에 따라 달라져요.

InfluxQL 쿼리 언어

쿼리 편집기에서 select measurement를 클릭해요. Grafana가 가능한 시리즈 목록을 표시하고, 하나를 클릭해 선택하면 Grafana가 사용 가능한 데이터를 그래프로 그려줘요. 표시할 데이터가 없으면 다른 선택을 시도하거나 데이터 소스를 확인하세요.

Flux 쿼리 언어

간단한 Flux 쿼리를 만들어요.

  1. 패널을 추가해요.
  2. 쿼리 편집기에서 InfluxDB-Flux 데이터 소스를 선택해요. 자세한 내용은 Queries 문서를 참고하세요.
  3. Table 시각화를 선택해요.
  4. 쿼리 편집기 텍스트 필드에 buckets()를 입력하고 편집기 밖을 클릭해요.

이 일반 쿼리는 버킷 목록을 반환해요. InfluxDB Explore 뷰에서도 Flux 쿼리를 만들 수 있어요.

  1. 브라우저에서 InfluxDB 기본 UI에 로그인해요 (OSS는 보통 http://localhost:8086, Cloud는 https://cloud2.influxdata.com).
  2. Explore를 클릭해 Data Explorer를 열어요.
  3. InfluxDB Data Explorer는 Flux 쿼리를 만드는 두 메커니즘(그래픽 쿼리 편집기와 스크립트 편집기)을 제공해요. 그래픽 쿼리 편집기로 쿼리를 만들면 비슷한 형태가 돼요.
  4. Script Editor를 클릭해 쿼리 텍스트를 보고, Flux 코드의 모든 줄을 복사해요.
  5. Grafana에서 패널을 추가하고 복사한 Flux 코드를 쿼리 편집기에 붙여넣어요.
  6. Apply를 클릭하면 Flux 쿼리의 데이터가 있는 새 패널이 표시돼요.

Grafana Explore에서 InfluxDB 메트릭 확인

Grafana 인스턴스에서 Explore 뷰로 이동해 모니터링하려는 메트릭을 실험하는 쿼리를 만들어요. 여기서 메트릭 수집과 관련된 문제도 디버깅할 수 있어요.

대시보드 구축 시작

Explore와 Data Explorer로 데이터를 실험하고, 마음에 드는 쿼리를 대시보드에 패널로 추가해보세요. 더 알아보려면:

더 알아보기 (Learn more)