TP : Installer Alloy avec Docker et explorer son interface

Ce que vous allez apprendre dans ce TP

• Démarrer Alloy dans un conteneur
• Charger une configuration minimale
• Utiliser l'interface web pour diagnostiquer

Introduction #

Ce que vous allez apprendre dans cette section

• Démarrer Alloy dans un conteneur
• Charger une configuration minimale
• Utiliser l'interface web pour diagnostiquer

Contexte. Vous venez d'être chargé de remplacer plusieurs agents de collecte par Grafana Alloy. Avant de toucher à de vrais serveurs, vous le déployez dans un conteneur jetable pour comprendre comment il démarre, comment il se configure et comment diagnostiquer un problème.

Prérequis : Docker installé, un terminal  ·  Durée estimée : 25 min

Dans ce TP, vous allez déployer Alloy avec Docker, lui fournir une configuration minimale puis utiliser son interface pour inspecter le graphe de composants. Prérequis : Docker installé.

Lancer Alloy #

Création de la configuration puis démarrage du conteneur.

1. 1. Créer la configuration minimale

   Pourquoi ? Une configuration minimale permet de valider l'installation sans dépendre d'aucun backend : si elle charge, le binaire et le montage de fichiers fonctionnent.

   Créez un fichier config.alloy qui active l'exportateur prometheus.exporter.self (les métriques d'Alloy lui-même), le scrape, et règle le niveau de log à info au format logfmt.

2. 2. Démarrer le conteneur

   Pourquoi ? Par défaut l'interface n'écoute que sur localhost : sans l'option d'écoute sur toutes les interfaces, le conteneur tourne mais reste inaccessible depuis votre poste.

   Lancez l'image grafana/alloy en montant votre fichier, en exposant le port 12345 et en écoutant sur toutes les interfaces (sinon l'UI reste inaccessible depuis l'hôte).

Explorer l'interface #

L'interface d'Alloy est le meilleur outil de diagnostic.

1. 3. Vérifier la santé et les métriques

   Pourquoi ? Les endpoints de santé sont ceux qu'utiliseront plus tard Kubernetes ou un load balancer pour savoir si Alloy est vivant : autant les connaître dès maintenant.

   Interrogez les endpoints de santé (/-/ready, /-/healthy) et l'endpoint /metrics. Quel code HTTP obtenez-vous ?

2. 4. Parcourir le graphe de composants

   Pourquoi ? Le graphe de composants est l'outil de diagnostic principal : il montre quels composants dépendent les uns des autres et lequel est en erreur.

   Ouvrez http://localhost:12345. Identifiez les composants prometheus.exporter.self.alloy et prometheus.scrape.alloy, puis ouvrez la page Graph. Quel composant dépend de l'autre ?

3. 5. Formater et recharger la configuration

   Pourquoi ? En production vous modifierez la configuration sans redémarrer : il faut savoir que le rechargement valide d'abord la syntaxe et conserve l'ancienne configuration en cas d'erreur.

   Ajoutez volontairement une erreur de syntaxe, observez le comportement, corrigez-la, puis rechargez la configuration à chaud sans redémarrer le conteneur.

Niveau de difficulté : ●○○○○ (1/5)