Grafana Agent est une version légère de Grafana conçue pour collecter des métriques et des logs, puis les transmettre vers un serveur Grafana ou Grafana Cloud. Cette solution permet de simplifier et unifier la collecte de données de supervision.
Prérequis
- Serveur Linux (Debian, Ubuntu, RHEL, CentOS)
- Accès root ou sudo
- Un accès à Grafana Cloud ou un serveur Grafana avec Grafana Loki et Prometheus configurés
Installation du binaire
Téléchargez la dernière version :
AGENT_VERSION=$(curl -s https://api.github.com/repos/grafana/agent/releases/latest | grep tag_name | cut -d '"' -f4)
wget https://github.com/grafana/agent/releases/download/$AGENT_VERSION/grafana-agent-linux-amd64.zip
unzip grafana-agent-linux-amd64.zip
sudo mv grafana-agent-linux-amd64 /usr/local/bin/grafana-agent
Rendez-le exécutable :
sudo chmod +x /usr/local/bin/grafana-agent
Configuration de base
Créez le fichier de configuration /etc/grafana-agent.yaml :
server:
log_level: info
http_listen_port: 12345
prometheus:
wal_directory: /var/lib/grafana-agent/data
global:
scrape_interval: 15s
configs:
- name: integrations
scrape_configs:
- job_name: 'node_exporter'
static_configs:
- targets: ['localhost:9100']
loki:
positions_directory: /var/lib/grafana-agent/positions
clients:
- url: http://grafana.local:3100/loki/api/v1/push
integrations:
node_exporter:
enabled: true
Adaptez clients.url vers votre endpoint Loki, et les cibles de scrape_configs.
Créer l'utilisateur et les répertoires
sudo useradd --system --no-create-home --shell /usr/sbin/nologin grafana-agent
sudo mkdir -p /var/lib/grafana-agent/{data,positions}
sudo chown -R grafana-agent:grafana-agent /var/lib/grafana-agent
Service systemd
Créez /etc/systemd/system/grafana-agent.service :
[Unit]
Description=Grafana Agent
After=network.target
[Service]
User=grafana-agent
ExecStart=/usr/local/bin/grafana-agent --config.file=/etc/grafana-agent.yaml
Restart=on-failure
[Install]
WantedBy=multi-user.target
Démarrez et activez :
sudo systemctl daemon-reload
sudo systemctl enable --now grafana-agent
Vérification
- Metrics :
curl http://localhost:12345/metrics - Logs : envoyés vers Loki, vérifiez dans Grafana
Intégration dans l'écosystème Grafana
Grafana Agent complète votre infrastructure d'observabilité :
- Utilisez-le avec Prometheus et Grafana pour une collecte centralisée des métriques
- Déployez-le dans la stack monitoring Docker pour une supervision unifiée
- Envoyez vos logs vers Loki pour une gestion centralisée complète
Conclusion
Grafana Agent offre une solution unifiée pour collecter métriques et logs, facilitant la supervision cloud-native. Léger et flexible, il s'intègre parfaitement dans vos environnements existants.
