Elasticsearch 데이터 소스

Elasticsearch 데이터 소스

Elasticsearch는 다양한 용도로 쓰이는 검색·분석 엔진이에요. Grafana에는 Elasticsearch 데이터 소스가 기본 설치되어 있어서 플러그인 설치 없이 Elasticsearch에 저장된 로그나 지표를 질의·시각화하고 그래프에 로그 이벤트를 어노테이션으로 표시할 수 있어요. 이 데이터 소스는 Grafana 릴리스와 독립적으로 업데이트할 수 있는 독립 플러그인으로 패키징돼요.

출처: Elasticsearch data source

본문

참고: Amazon OpenSearch Service(Amazon Elasticsearch Service의 후속작)를 사용한다면 OpenSearch 데이터 소스를 대신 사용하세요.

주요 기능

Elasticsearch 데이터 소스는 다음을 지원해요.

  • 메트릭 쿼리: 버킷 및 지표 집계(bucket and metric aggregations)로 숫자 데이터를 집계·시각화해요.
  • 로그 쿼리: Lucene 쿼리 문법으로 로그 데이터를 검색·필터링·탐색해요.
  • Raw DSL 쿼리: Code 모드에서 네이티브 Elasticsearch Query DSL을 작성해요.
  • ES|QL 쿼리: Elasticsearch의 파이프 기반 쿼리 언어로 데이터를 질의해요.
  • 어노테이션: Elasticsearch 이벤트를 대시보드 그래프에 겹쳐 표시해요.
  • 알림: Elasticsearch 쿼리 결과를 기반으로 알림을 만들어요.

시작하기 전에

Elasticsearch 데이터 소스를 구성하기 전에 다음이 필요해요.

  • Elasticsearch 인스턴스(v7.17+, v8.x, v9.x)
  • Grafana에서 Elasticsearch 서버로의 네트워크 접근
  • 읽기 권한이 있는 적절한 사용자 자격 증명 또는 API 키

지원되는 Elasticsearch 버전

이 데이터 소스는 다음 Elasticsearch 버전을 지원해요.

  • ≥ v7.17
  • v8.x
  • v9.x
  • Elastic Cloud Serverless

Elasticsearch 데이터 소스의 Grafana 유지보수 정책은 Elastic Product End of Life Dates와 일치해요. Grafana는 지원 버전에서만 제대로 동작함을 보장해요. EOL 버전의 Elasticsearch를 쓰면 쿼리는 여전히 실행되지만 쿼리 빌더가 경고를 표시해요. Grafana는 EOL 버전에 대해 기능을 보장하거나 수정을 제공하지 않아요.

시작하기

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

플러그인 업데이트

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

참고: Grafana Cloud에서는 플러그인이 자동으로 업데이트돼요.

이 동작을 조정하려면:

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

독립 플러그인은 Grafana 12.2.0 이상이 필요해요. Grafana 12.1 이하에 번들된 Elasticsearch 데이터 소스는 이전처럼 계속 동작해요. 이 버전들은 외부화의 영향을 받지 않아요.

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

[plugin.elasticsearch]
as_external = true

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

추가 리소스

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

관련 데이터 소스

  • OpenSearch - Amazon OpenSearch Service용
  • Loki - Grafana 로그 집계 시스템

더 알아보기 (Learn more)