Ein programmierbarer Datensammler für Observability auf Basis von OpenTelemetry, der Metriken, Logs, Traces und Continuous Profiling unterstützt.

Apache-2.0Goagentgrafana 1.6k Last Updated: August 04, 2025

Grafana Agent Projekt – Detaillierte Beschreibung

Projektübersicht

Grafana Agent ist eine auf dem OpenTelemetry Collector basierende Distribution, deren Konfigurationsstil von Terraform inspiriert ist. Er ist als flexibler, leistungsstarker und mit verschiedenen Ökosystemen kompatibler Observability-Datensammler konzipiert, einschließlich Prometheus und OpenTelemetry.

⚠️ Wichtiger Hinweis: Grafana Agent ist veraltet und befindet sich jetzt im Long-Term-Support-Modus. Es wird empfohlen, auf die neue Version Grafana Alloy zu migrieren, die auf Grafana Agent Flow basiert.

Kernfunktionen

1. Anbieterneutralität

  • Vollständige Kompatibilität: Vollständig kompatibel mit Prometheus, OpenTelemetry und dem Grafana Open-Source-Ökosystem
  • Multi-Signal-Unterstützung: Erfasst Metriken, Logs, Traces und Continuous Profiling Daten
  • Flexible Bereitstellung: Kann auf beliebig vielen Maschinen bereitgestellt werden und Millionen von aktiven Sequenzen und TB an Logs verarbeiten

2. Komponentisierte Architektur

Grafana Agent basiert auf Komponenten. Komponenten werden miteinander verbunden, um programmierbare Observability-Pipelines zu bilden, die zur Erfassung, Verarbeitung und Übertragung von Telemetriedaten dienen.

3. Datenerfassung und -übertragung

Grafana Agent kann Daten erfassen, transformieren und an folgende Systeme senden:

  • Prometheus-Ökosystem
  • OpenTelemetry-Ökosystem
  • Grafana Open-Source-Ökosystem (einschließlich Loki, Grafana, Tempo, Mimir, Pyroscope)

4. Enterprise-Funktionen

  • Skalierbarkeit: Unterstützt groß angelegte Bereitstellungen und verarbeitet Millionen von aktiven Sequenzen
  • Kampferprobt: Erweitert den im realen Einsatz bewährten Code der Projekte Prometheus und OpenTelemetry Collector
  • Leistungsstark: Unterstützt das Schreiben programmierbarer Pipelines und bietet eine integrierte UI zur Fehlersuche
  • Out-of-the-box: Integration mit Systemen wie MySQL, Kubernetes, Apache usw.

Technische Architektur

Flow-Modus

Diese Seite konzentriert sich hauptsächlich auf den "Flow-Modus", eine von Terraform inspirierte überarbeitete Version von Grafana Agent. Der Flow-Modus bietet eine intuitivere Konfigurationsweise, die es Benutzern ermöglicht:

  • Einfaches Einrichten und Überprüfen der Konfiguration
  • Schnelle Iteration von Telemetrie-Pipelines
  • Reduzierung der Lernkurve

Konfigurationsbeispiel

// Kubernetes-Pods zur Erfassung von Metriken erkennen
discovery.kubernetes "pods" {
  role = "pod"
}

// Metriken von Kubernetes-Pods erfassen
prometheus.scrape "default" {
  targets = discovery.kubernetes.pods.targets
  forward_to = [prometheus.remote_write.default.receiver]
}

// API-Schlüssel von der Festplatte abrufen
local.file "apikey" {
  filename = "/var/data/my-api-key.txt"
  is_secret = true
}

// Metriken an den Prometheus remote_write Endpunkt senden
prometheus.remote_write "default" {
  endpoint {
    url = "http://localhost:9009/api/prom/push"
    basic_auth {
      username = "MY_USERNAME"
      password = local.file.apikey.content
    }
  }
}

Projektstatus und Migration

Hinweis zur Veraltung

Grafana Alloy ist der neue Name unserer OTel Collector Distribution. Grafana Agent ist veraltet und wird bis zum 31. Oktober 2025 im Long-Term-Support (LTS) angeboten. Grafana Agent erreicht am 1. November 2025 das Ende seiner Lebensdauer (EOL).

Migrationsempfehlungen

Die Projektbetreuer empfehlen dringend, zu Grafana Alloy zu migrieren, da dies folgende Vorteile bietet:

  • Bessere Leistung und Stabilität
  • Umfangreichere Enterprise-Funktionen
  • Kontinuierliche Funktionsupdates und Support

Installation und Bereitstellung

Unterstützte Plattformen

  • Linux, macOS, Windows
  • Docker-Container
  • Kubernetes-Cluster
  • Cloud-Plattformen (AWS, GCP, Azure usw.)

Schnellstart

Das Projekt bietet umfassende Dokumentation und Beispiele:

  • Detaillierte Installationsanleitung
  • Einführungstutorial
  • Komponentenreferenzdokumentation
  • Docker Compose Beispielumgebung

Typische Anwendungsfälle

1. Umfangreiche Überwachung

Geeignet für umfangreiche Prometheus-Bereitstellungen, die Millionen von aktiven Sequenzen verarbeiten müssen

2. Multi-Signal-Erfassung

Einheitliche Erfassung von Metriken, Logs, Traces und Performance-Analysedaten

3. Hybrid-Cloud-Umgebung

Bietet eine konsistente Observability-Lösung in Multi-Cloud- und Hybrid-Cloud-Umgebungen

4. DevOps-Integration

Tiefe Integration mit CI/CD-Pipelines und GitOps-Workflows

Zusammenfassung

Grafana Agent bietet als ausgereifter Observability-Datensammler Benutzern leistungsstarke Funktionen zur Erfassung, Verarbeitung und Übertragung von Telemetriedaten. Obwohl sich das Projekt im Wartungsmodus befindet, bilden seine Kernideen und -architektur eine solide Grundlage für die neue Generation von Grafana Alloy. Für bestehende Benutzer wird empfohlen, gemäß den offiziellen Richtlinien schrittweise zu Grafana Alloy zu migrieren, um eine bessere Leistung und kontinuierlichen Support zu erhalten.

Star History Chart