Home
Login
grafana/agentPlease refer to the latest official releases for information GitHub Homepage

OpenTelemetry 기반의 프로그래밍 가능한 관측성 데이터 수집기로, 메트릭, 로그, 추적 및 지속적인 성능 분석을 지원합니다.

Apache-2.0Go 1.6kgrafanaagent Last Updated: 2025-06-24

Grafana Agent 프로젝트 상세 소개

프로젝트 개요

Grafana Agent는 OpenTelemetry Collector를 기반으로 하는 배포 버전이며, Terraform에서 영감을 받은 구성 스타일을 사용합니다. Prometheus 및 OpenTelemetry를 포함한 다양한 생태계와 호환되는 유연하고 고성능의 관측성 데이터 수집기로 설계되었습니다.

⚠️ 중요 알림: Grafana Agent는 더 이상 사용되지 않으며 현재 장기 지원 모드에 있습니다. Grafana Agent Flow를 기반으로 구축된 새로운 버전의 Grafana Alloy로 마이그레이션하는 것이 좋습니다.

핵심 기능

1. 공급업체 중립성

  • 완전 호환성: Prometheus, OpenTelemetry 및 Grafana 오픈 소스 생태계와 완전 호환
  • 다중 신호 지원: 메트릭, 로그, 트레이스 및 지속적인 성능 분석 데이터 수집
  • 유연한 배포: 임의의 수의 머신에 배포하여 수백만 개의 활성 시퀀스 및 TB급 로그 처리 가능

2. 컴포넌트화된 아키텍처

Grafana Agent는 컴포넌트를 기반으로 구축됩니다. 컴포넌트는 함께 연결되어 원격 측정 데이터의 수집, 처리 및 전송을 위한 프로그래밍 가능한 관측성 파이프라인을 형성합니다.

3. 데이터 수집 및 전송

Grafana Agent는 다음 위치로 데이터를 수집, 변환 및 전송할 수 있습니다.

  • Prometheus 생태계
  • OpenTelemetry 생태계
  • Grafana 오픈 소스 생태계 (Loki, Grafana, Tempo, Mimir, Pyroscope 포함)

4. 엔터프라이즈급 기능

  • 확장성: 대규모 배포를 지원하며 수백만 개의 활성 시퀀스 처리
  • 실전 검증: Prometheus 및 OpenTelemetry Collector 프로젝트의 실전 검증된 코드 확장
  • 강력한 기능: 프로그래밍 가능한 파이프라인 작성 지원 및 디버깅을 위한 내장 UI 제공
  • 즉시 사용 가능: MySQL, Kubernetes, Apache 등 시스템과 통합

기술 아키텍처

Flow 모드

이 페이지는 주로 "Flow 모드"에 중점을 둡니다. 이는 Grafana Agent의 Terraform에서 영감을 받은 수정 버전입니다. Flow 모드는 사용자에게 다음과 같은 기능을 제공하는 보다 직관적인 구성 방식을 제공합니다.

  • 쉬운 구성 설정 및 검사
  • 빠른 원격 측정 파이프라인 반복
  • 학습 곡선 감소

구성 예시

// 메트릭을 수집하기 위해 Kubernetes 포드 검색
discovery.kubernetes "pods" {
  role = "pod"
}

// Kubernetes 포드에서 메트릭 수집
prometheus.scrape "default" {
  targets = discovery.kubernetes.pods.targets
  forward_to = [prometheus.remote_write.default.receiver]
}

// 디스크에서 API 키 가져오기
local.file "apikey" {
  filename = "/var/data/my-api-key.txt"
  is_secret = true
}

// Prometheus remote_write 엔드포인트로 메트릭 전송
prometheus.remote_write "default" {
  endpoint {
    url = "http://localhost:9009/api/prom/push"
    basic_auth {
      username = "MY_USERNAME"
      password = local.file.apikey.content
    }
  }
}

프로젝트 상태 및 마이그레이션

더 이상 사용되지 않음 설명

Grafana Alloy는 OTel Collector 배포판의 새로운 이름입니다. Grafana Agent는 더 이상 사용되지 않으며 2025년 10월 31일까지 장기 지원(LTS)이 제공됩니다. Grafana Agent는 2025년 11월 1일에 수명 종료(EOL)에 도달합니다.

마이그레이션 권장 사항

프로젝트 유지 관리자는 다음과 같은 이유로 사용자가 Grafana Alloy로 마이그레이션할 것을 강력히 권장합니다.

  • 더 나은 성능 및 안정성
  • 더 풍부한 엔터프라이즈급 기능
  • 지속적인 기능 업데이트 및 지원

설치 및 배포

지원 플랫폼

  • Linux, macOS, Windows
  • Docker 컨테이너
  • Kubernetes 클러스터
  • 클라우드 플랫폼 (AWS, GCP, Azure 등)

빠른 시작

프로젝트는 다음과 같은 완전한 문서 및 예제를 제공합니다.

  • 자세한 설치 가이드
  • 시작하기 튜토리얼
  • 컴포넌트 참조 문서
  • Docker Compose 예제 환경

일반적인 사용 시나리오

1. 대규모 모니터링

수백만 개의 활성 시퀀스를 처리해야 하는 대규모 Prometheus 배포에 적합

2. 다중 신호 수집

메트릭, 로그, 트레이스 및 성능 분석 데이터를 통합적으로 수집

3. 하이브리드 클라우드 환경

다중 클라우드 및 하이브리드 클라우드 환경에서 일관된 관측성 솔루션 제공

4. DevOps 통합

CI/CD 파이프라인 및 GitOps 워크플로우와 긴밀하게 통합

요약

Grafana Agent는 성숙한 관측성 데이터 수집기로서 사용자에게 강력한 원격 측정 데이터 수집, 처리 및 전송 기능을 제공합니다. 프로젝트가 유지 관리 모드로 전환되었지만 핵심 이념과 아키텍처는 차세대 Grafana Alloy의 견고한 기반을 마련했습니다. 기존 사용자는 공식 가이드에 따라 Grafana Alloy로 점진적으로 마이그레이션하여 더 나은 성능과 지속적인 지원을 받는 것이 좋습니다.

Star History Chart