Colector de datos de observabilidad programable basado en OpenTelemetry, que admite métricas, registros, rastreo de trazas y análisis continuo del rendimiento.

Descripción Detallada del Proyecto Grafana Agent

Resumen del Proyecto

Grafana Agent es una distribución basada en OpenTelemetry Collector, con un estilo de configuración inspirado en Terraform. Está diseñado para ser un recolector de datos de observabilidad flexible, de alto rendimiento y compatible con múltiples ecosistemas, incluyendo Prometheus y OpenTelemetry.

⚠️ Recordatorio Importante: Grafana Agent ha sido descontinuado y ahora está en modo de soporte a largo plazo. Se recomienda migrar a la nueva versión de Grafana Alloy, construida sobre Grafana Agent Flow.

Características Principales

1. Neutralidad del Proveedor

• Compatibilidad Total: Totalmente compatible con los ecosistemas de código abierto de Prometheus, OpenTelemetry y Grafana.
• Soporte Multi-Señal: Recolecta métricas, logs, trazas y datos de análisis de rendimiento continuo.
• Implementación Flexible: Se puede implementar en cualquier número de máquinas, manejando millones de series activas y TBs de logs.

2. Arquitectura Componentizada

Grafana Agent está construido sobre componentes. Los componentes se conectan entre sí para formar pipelines de observabilidad programables para la recolección, procesamiento y transmisión de datos de telemetría.

3. Recolección y Transmisión de Datos

Grafana Agent puede recolectar, transformar y enviar datos a:

• Ecosistema Prometheus
• Ecosistema OpenTelemetry
• Ecosistema de código abierto de Grafana (incluyendo Loki, Grafana, Tempo, Mimir, Pyroscope)

4. Características de Nivel Empresarial

• Escalabilidad: Soporta implementaciones a gran escala, manejando millones de series activas.
• Validado en Batalla: Extiende el código probado en batalla de los proyectos Prometheus y OpenTelemetry Collector.
• Potente: Soporta la escritura de pipelines programables y proporciona una UI integrada para la depuración.
• Listo para Usar: Integrado con sistemas como MySQL, Kubernetes, Apache, etc.

Arquitectura Técnica

Modo Flow

Esta página se centra principalmente en el "Modo Flow", que es una revisión de Grafana Agent inspirada en Terraform. El Modo Flow proporciona una forma más intuitiva de configurar, permitiendo a los usuarios:

• Configurar e inspeccionar fácilmente la configuración
• Iterar rápidamente en pipelines de telemetría
• Reducir la curva de aprendizaje

Ejemplo de Configuración

// Descubre pods de Kubernetes para recolectar métricas
discovery.kubernetes "pods" {
  role = "pod"
}

// Recolecta métricas de pods de Kubernetes
prometheus.scrape "default" {
  targets = discovery.kubernetes.pods.targets
  forward_to = [prometheus.remote_write.default.receiver]
}

// Obtiene la clave API del disco
local.file "apikey" {
  filename = "/var/data/my-api-key.txt"
  is_secret = true
}

// Envía métricas al endpoint remote_write de Prometheus
prometheus.remote_write "default" {
  endpoint {
    url = "http://localhost:9009/api/prom/push"
    basic_auth {
      username = "MY_USERNAME"
      password = local.file.apikey.content
    }
  }
}

Estado del Proyecto y Migración

Nota de Descontinuación

Grafana Alloy es el nuevo nombre de nuestra distribución de OTel Collector. Grafana Agent ha sido descontinuado y proporcionará soporte a largo plazo (LTS) hasta el 31 de octubre de 2025. Grafana Agent alcanzará el fin de su vida útil (EOL) el 1 de noviembre de 2025.

Recomendaciones de Migración

Los mantenedores del proyecto recomiendan encarecidamente a los usuarios que migren a Grafana Alloy, por las siguientes razones:

• Mejor rendimiento y estabilidad
• Funciones de nivel empresarial más ricas
• Actualizaciones y soporte continuos de funciones

Instalación e Implementación

Plataformas Soportadas

• Linux, macOS, Windows
• Contenedores Docker
• Clústeres de Kubernetes
• Plataformas en la nube (AWS, GCP, Azure, etc.)

Inicio Rápido

El proyecto proporciona documentación y ejemplos completos:

• Guía de instalación detallada
• Tutoriales de inicio
• Documentación de referencia de componentes
• Entorno de ejemplo de Docker Compose

Casos de Uso Típicos

1. Monitorización a Gran Escala

Adecuado para implementaciones de Prometheus a gran escala que necesitan manejar millones de series activas.

2. Recolección Multi-Señal

Recolección unificada de métricas, logs, trazas y datos de análisis de rendimiento.

3. Entornos de Nube Híbrida

Proporciona una solución de observabilidad consistente en entornos multi-nube e híbridos.

4. Integración DevOps

Integración profunda con pipelines de CI/CD y flujos de trabajo GitOps.

Resumen

Grafana Agent, como un recolector de datos de observabilidad maduro, proporciona a los usuarios una potente capacidad de recolección, procesamiento y transmisión de datos de telemetría. Aunque el proyecto ha entrado en modo de mantenimiento, sus ideas y arquitectura centrales sientan una base sólida para la nueva generación de Grafana Alloy. Para los usuarios existentes, se recomienda migrar gradualmente a Grafana Alloy de acuerdo con la guía oficial para obtener un mejor rendimiento y soporte continuo.