Présentation détaillée du projet Grafana Agent

Aperçu du projet

Grafana Agent est une distribution basée sur OpenTelemetry Collector, avec un style de configuration inspiré de Terraform. Il est conçu pour être un collecteur de données d'observabilité flexible, performant et compatible avec divers écosystèmes, notamment Prometheus et OpenTelemetry.

⚠️ Avertissement important : Grafana Agent est obsolète et se trouve désormais en mode de support à long terme. Il est recommandé de migrer vers la nouvelle version de Grafana Alloy, construite sur la base de Grafana Agent Flow.

Caractéristiques principales

1. Neutralité du fournisseur

• Compatibilité totale : Entièrement compatible avec les écosystèmes open source Prometheus, OpenTelemetry et Grafana.
• Prise en charge multi-signaux : Collecte des métriques, des logs, des traces et des données d'analyse de performance continue.
• Déploiement flexible : Peut être déployé sur un nombre quelconque de machines, traitant des millions de séries actives et des téraoctets de logs.

2. Architecture basée sur des composants

Grafana Agent est construit sur la base de composants. Les composants sont connectés entre eux pour former des pipelines d'observabilité programmables, utilisés pour la collecte, le traitement et la transmission des données de télémétrie.

3. Collecte et transmission des données

Grafana Agent peut collecter, transformer et envoyer des données vers :

• L'écosystème Prometheus
• L'écosystème OpenTelemetry
• L'écosystème open source Grafana (y compris Loki, Grafana, Tempo, Mimir, Pyroscope)

4. Caractéristiques d'entreprise

• Extensibilité : Prend en charge les déploiements à grande échelle, traitant des millions de séries actives.
• Validation en conditions réelles : Étend le code éprouvé des projets Prometheus et OpenTelemetry Collector.
• Fonctionnalités puissantes : Prend en charge l'écriture de pipelines programmables et fournit une interface utilisateur intégrée pour le débogage.
• Prêt à l'emploi : Intégration avec des systèmes tels que MySQL, Kubernetes, Apache, etc.

Architecture technique

Mode Flow

Cette page se concentre principalement sur le "Mode Flow", une version révisée de Grafana Agent inspirée de Terraform. Le mode Flow offre une méthode de configuration plus intuitive, permettant aux utilisateurs de :

• Configurer et vérifier facilement la configuration
• Itérer rapidement sur les pipelines de télémétrie
• Réduire la courbe d'apprentissage

Exemple de configuration

// Découverte des pods Kubernetes pour collecter les métriques
discovery.kubernetes "pods" {
  role = "pod"
}

// Collecte des métriques à partir des pods Kubernetes
prometheus.scrape "default" {
  targets = discovery.kubernetes.pods.targets
  forward_to = [prometheus.remote_write.default.receiver]
}

// Récupération de la clé API à partir du disque
local.file "apikey" {
  filename = "/var/data/my-api-key.txt"
  is_secret = true
}

// Envoi des métriques au point de terminaison 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
    }
  }
}

État du projet et migration

Annonce d'obsolescence

Grafana Alloy est le nouveau nom de notre distribution OTel Collector. Grafana Agent est obsolète et bénéficiera d'un support à long terme (LTS) jusqu'au 31 octobre 2025. Grafana Agent atteindra sa fin de vie (EOL) le 1er novembre 2025.

Recommandations de migration

Les mainteneurs du projet recommandent fortement aux utilisateurs de migrer vers Grafana Alloy, pour les raisons suivantes :

• Meilleures performances et stabilité
• Fonctionnalités d'entreprise plus riches
• Mises à jour et support continus des fonctionnalités

Installation et déploiement

Plateformes prises en charge

• Linux, macOS, Windows
• Conteneurs Docker
• Clusters Kubernetes
• Plateformes cloud (AWS, GCP, Azure, etc.)

Démarrage rapide

Le projet fournit une documentation et des exemples complets :

• Guide d'installation détaillé
• Tutoriels de démarrage
• Documentation de référence des composants
• Environnement d'exemple Docker Compose

Cas d'utilisation typiques

1. Surveillance à grande échelle

Convient aux déploiements Prometheus à grande échelle nécessitant le traitement de millions de séries actives.

2. Collecte multi-signaux

Collecte unifiée des métriques, des logs, des traces et des données d'analyse de performance.

3. Environnement cloud hybride

Fournit une solution d'observabilité cohérente dans les environnements multi-cloud et cloud hybride.

4. Intégration DevOps

Intégration profonde avec les pipelines CI/CD et les flux de travail GitOps.

Résumé

Grafana Agent, en tant que collecteur de données d'observabilité mature, offre aux utilisateurs de puissantes capacités de collecte, de traitement et de transmission des données de télémétrie. Bien que le projet soit entré en mode de maintenance, ses concepts et son architecture fondamentaux ont jeté des bases solides pour la nouvelle génération de Grafana Alloy. Pour les utilisateurs existants, il est recommandé de migrer progressivement vers Grafana Alloy conformément aux directives officielles afin de bénéficier de meilleures performances et d'un support continu.