Detalhes do Projeto Grafana Agent

Visão Geral do Projeto

O Grafana Agent é uma distribuição baseada no OpenTelemetry Collector, com um estilo de configuração inspirado no Terraform. Ele foi projetado para ser um coletor de dados de observabilidade flexível, de alto desempenho e compatível com vários ecossistemas, incluindo Prometheus e OpenTelemetry.

⚠️ Aviso Importante: O Grafana Agent foi descontinuado e agora está em modo de suporte de longo prazo. Recomenda-se migrar para o Grafana Alloy, uma nova versão construída com base no Grafana Agent Flow.

Principais Características

1. Neutralidade do Fornecedor

• Total Compatibilidade: Totalmente compatível com os ecossistemas de código aberto Prometheus, OpenTelemetry e Grafana.
• Suporte a Múltiplos Sinais: Coleta métricas, logs, rastreamento de traces e dados de análise contínua de desempenho.
• Implantação Flexível: Pode ser implantado em qualquer número de máquinas, processando milhões de séries ativas e TBs de logs.

2. Arquitetura Componentizada

O Grafana Agent é construído com base em componentes. Os componentes são conectados para formar pipelines de observabilidade programáveis para coleta, processamento e transmissão de dados de telemetria.

3. Coleta e Transmissão de Dados

O Grafana Agent pode coletar, transformar e enviar dados para:

• Ecossistema Prometheus
• Ecossistema OpenTelemetry
• Ecossistema de código aberto Grafana (incluindo Loki, Grafana, Tempo, Mimir, Pyroscope)

4. Características de Nível Empresarial

• Escalabilidade: Suporta implantações em larga escala, processando milhões de séries ativas.
• Validação em Combate: Estende o código comprovado em batalha dos projetos Prometheus e OpenTelemetry Collector.
• Poderoso: Suporta a escrita de pipelines programáveis e fornece uma UI integrada para depuração.
• Pronto para Uso: Integra-se com sistemas como MySQL, Kubernetes, Apache, etc.

Arquitetura Técnica

Modo Flow

Esta página se concentra principalmente no "Modo Flow", que é uma revisão do Grafana Agent inspirada no Terraform. O Modo Flow oferece uma maneira mais intuitiva de configurar, permitindo que os usuários:

• Configurem e verifiquem facilmente a configuração
• Iterem rapidamente os pipelines de telemetria
• Reduzam a curva de aprendizado

Exemplo de Configuração

// Descobre pods Kubernetes para coletar métricas
discovery.kubernetes "pods" {
  role = "pod"
}

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

// Obtém a chave da API do disco
local.file "apikey" {
  filename = "/var/data/my-api-key.txt"
  is_secret = true
}

// Envia métricas para o endpoint 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
    }
  }
}

Status do Projeto e Migração

Declaração de Descontinuação

Grafana Alloy é o novo nome para nossa distribuição do coletor OTel. O Grafana Agent foi descontinuado e terá suporte de longo prazo (LTS) até 31 de outubro de 2025. O Grafana Agent atingirá o fim da vida útil (EOL) em 1º de novembro de 2025.

Recomendações de Migração

Os mantenedores do projeto recomendam fortemente que os usuários migrem para o Grafana Alloy, pelas seguintes razões:

• Melhor desempenho e estabilidade
• Recursos de nível empresarial mais ricos
• Atualizações e suporte contínuos de recursos

Instalação e Implantação

Plataformas Suportadas

• Linux, macOS, Windows
• Contêineres Docker
• Clusters Kubernetes
• Plataformas de nuvem (AWS, GCP, Azure, etc.)

Início Rápido

O projeto fornece documentação e exemplos completos:

• Guia de instalação detalhado
• Tutoriais de introdução
• Documentação de referência de componentes
• Ambiente de exemplo Docker Compose

Casos de Uso Típicos

1. Monitoramento em Larga Escala

Adequado para implantações Prometheus em larga escala que precisam processar milhões de séries ativas.

2. Coleta de Múltiplos Sinais

Coleta unificada de métricas, logs, rastreamento de traces e dados de análise de desempenho.

3. Ambientes de Nuvem Híbrida

Fornece uma solução de observabilidade consistente em ambientes multi-nuvem e nuvem híbrida.

4. Integração DevOps

Integração profunda com pipelines CI/CD e fluxos de trabalho GitOps.

Resumo

O Grafana Agent, como um coletor de dados de observabilidade maduro, fornece aos usuários poderosos recursos de coleta, processamento e transmissão de dados de telemetria. Embora o projeto tenha entrado em modo de manutenção, seus princípios e arquitetura centrais lançaram uma base sólida para a nova geração do Grafana Alloy. Para os usuários existentes, recomenda-se migrar gradualmente para o Grafana Alloy de acordo com o guia oficial para obter melhor desempenho e suporte contínuo.