Ein programmierbarer Datensammler für Observability auf Basis von OpenTelemetry, der Metriken, Logs, Traces und Continuous Profiling unterstützt.
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.