Installation

4. Installation #

Déploiement sur Linux, Docker et Kubernetes.

Quelle méthode choisir ? #

Avec Docker #

docker run --name alloy \
  -v "$PWD/config.alloy:/etc/alloy/config.alloy" \
  -p 12345:12345 \
  grafana/alloy:v1.21.3 \
  run --server.http.listen-addr=0.0.0.0:12345 \
      --storage.path=/var/lib/alloy/data \
      /etc/alloy/config.alloy

L'interface ne répond pas ? Par défaut, Alloy écoute sur 127.0.0.1:12345, donc uniquement dans le conteneur. D'où l'option --server.http.listen-addr=0.0.0.0:12345. Hors d'un conteneur, gardez la valeur par défaut, ou protégez ce port : l'interface expose la configuration.

Sur Debian ou Ubuntu #

sudo mkdir -p /etc/apt/keyrings
sudo wget -O /etc/apt/keyrings/grafana.asc https://apt.grafana.com/gpg-full.key
echo "deb [signed-by=/etc/apt/keyrings/grafana.asc] https://apt.grafana.com stable main" \
  | sudo tee /etc/apt/sources.list.d/grafana.list
sudo apt-get update
sudo apt-get install alloy

sudo systemctl enable --now alloy
sudo systemctl status alloy
sudo journalctl -u alloy -f

La configuration se trouve dans /etc/alloy/config.alloy. Les options du service sont dans /etc/default/alloy (/etc/sysconfig/alloy sur RHEL) : CUSTOM_ARGS reçoit par exemple l'adresse d'écoute.

Sur Kubernetes #

helm repo add grafana https://grafana.github.io/helm-charts
helm repo update
helm install alloy grafana/alloy -n monitoring --create-namespace -f values.yaml

Le déploiement et ses modes sont détaillés dans le chapitre Déployer à grande échelle.

Vérifier l'installation #

alloy --version
alloy validate config.alloy
curl http://localhost:12345/-/ready     # Alloy is ready.
curl http://localhost:12345/-/healthy   # All Alloy components are healthy.
curl -X POST http://localhost:12345/-/reload   # config reloaded

Bonne pratique : épinglez un tag précis de l'image (grafana/alloy:v1.21.3), et lancez alloy validate dans votre CI avant chaque déploiement.