InfluxDB 데이터 소스

InfluxDB 데이터 소스

InfluxDB는 InfluxData가 개발한 오픈소스 시계열 데이터베이스(TSDB)예요. 운영 모니터링, 애플리케이션 지표, IoT 센서 데이터, 실시간 분석 같은 분야에서 시계열 데이터를 빠르고 가용성 높게 저장·검색하도록 최적화되어 있어요. Grafana에는 InfluxDB 데이터 소스가 기본 제공되어 설치할 것이 없어요.

출처: InfluxDB data source

본문

이 데이터 소스는 Grafana 릴리스와 무관하게 업데이트할 수 있는 독립 플러그인으로 패키징돼요. Grafana는 이 데이터 소스에 대해 SQL, InfluxQL, Flux의 세 가지 쿼리 언어 선택을 포함한 여러 구성 옵션을 제공해요. SQL과 InfluxQL은 시각적 빌더와 코드 편집 모드를 모두 제공하고, Flux는 코드 편집기만 제공해요.

지원 버전

이 데이터 소스는 다음 InfluxDB 제품을 지원해요.

  • InfluxDB OSS 1.x, 2.x, 3.x
  • InfluxDB Enterprise 1.x, 3.x
  • InfluxDB Cloud Serverless
  • InfluxDB Cloud Dedicated
  • InfluxDB Cloud (TSM)

지원 기능

기능 지원
Metrics 예
Logs 예
Traces 아니요
Alerting 예
Annotations 예

시작하기

다음 문서가 InfluxDB 데이터 소스를 설정하고 사용하는 데 도움을 줘요.

추가 기능

데이터 소스를 구성한 뒤에는:

플러그인 업데이트

Grafana v13.2부터 InfluxDB 데이터 소스는 Grafana OSS와 Enterprise 모두에 기본 설치된 독립 플러그인으로 동작해요. 이로써 Grafana 릴리스와 무관하게 더 자주 업데이트할 수 있어요. Grafana는 플러그인 카탈로그를 자동으로 확인해 서버를 다시 시작할 때마다 최신 버전을 설치해요.

이 동작을 조정하려면:

  • 자동 업데이트 해제: 구성 파일에서 preinstall_auto_update를 false로 설정해요.
  • 수동 업데이트: Grafana를 다시 시작하지 않고 Administration > Plugins 페이지에서 언제든 업데이트해요.

독립 플러그인은 Grafana 12.3.0 이상이 필요해요. Grafana 13.1 이하에 번들된 InfluxDB 데이터 소스는 이전처럼 계속 동작해요. 그 버전들은 이 변경의 영향을 받지 않아요.

주의: Grafana는 플러그인 버전 13.1.0 이상을 실행할 것을 권장해요. 이전 버전은 기본 로그 레벨에서 API 토큰을 Grafana 서버 로그에 일반 텍스트로 기록할 수 있어요. 이전 버전을 실행했다면 서버 로그를 민감한 것으로 취급하고 노출됐을 수 있는 토큰을 교체하세요.

Grafana 12.3.x~13.1.x를 실행하는 사용자는 Grafana 13.2로 업그레이드하기 전에 최신 기능을 원한다면 플러그인 카탈로그에서 독립 플러그인을 설치할 수 있어요. 이 버전들에서 독립 플러그인을 사용하려면 구성 파일에 다음을 추가해요.

[plugin.influxdb]
as_external = true

[plugins]
; Install the latest version on startup:
preinstall_sync = influxdb
; Or install a specific version:
; preinstall_sync = influxdb@<version>

셀프 관리 Grafana에서는 플러그인 버전을 직접 제어할 수 있어요. 문제 있는 업데이트 후 롤백하려면 preinstall_sync = influxdb@<version>으로 알려진-좋은 버전을 고정하고 Grafana를 다시 시작하거나, Administration > Plugins 페이지에서 특정 버전을 설치해요.

참고: Grafana Cloud에서는 플러그인 업데이트가 자동 관리돼요. 플러그인을 특정 버전으로 고정하거나 이전 버전으로 직접 롤백할 수 없어요. 플러그인 업데이트가 대시보드나 쿼리에 문제를 일으키면 Grafana Support에 문의하세요.

관련 리소스

더 알아보기 (Learn more)