Analyse des performances avec Glowroot
En cas de problèmes de performances, l’assistance Relution peut demander une analyse avec Glowroot →. Glowroot enregistre la durée de chaque requête et présente le résultat dans sa propre interface web.
Télécharger et vérifier Glowroot
Le paquet Glowroot est téléchargé depuis repo.relution.io. Il correspond à la version de
Java de l’image Relution (actuellement Java 25) ; la version de Java contenue dans l’image
utilisée s’affiche avec :
docker run --rm relution/relution:latest java -version
La somme de contrôle garantit que le paquet est arrivé intact :
wget https://repo.relution.io/glowroot/glowroot-java25-dist.zip
echo "3b9db6b0fc0903233c5e17b6cfa7b022ef8ba6d71ae7d39a9fff6f637608f20c glowroot-java25-dist.zip" | sha256sum -c
unzip glowroot-java25-dist.zip
Les commandes sont exécutées dans le répertoire contenant le fichier docker-compose.yml.
La décompression y crée le répertoire glowroot. Si la vérification renvoie FAILED au
lieu de OK, le paquet ne doit pas être utilisé.
Rendre l’interface web accessible
Par défaut, Glowroot ne lie son interface web qu’à localhost à l’intérieur du conteneur.
Pour qu’elle sorte du conteneur, le fichier glowroot/admin.json est créé avant le
démarrage :
echo '{"web": {"bindAddress": "0.0.0.0"}}' > glowroot/admin.json
Glowroot écrit sa configuration, ses enregistrements et ses journaux à côté de l’agent. Le
répertoire doit donc appartenir à l’utilisateur du conteneur (UID 20001) :
sudo chown -R 20001:20001 glowroot
Configurer le conteneur
Dans le fichier docker-compose.yml, le répertoire est monté dans le conteneur et l’agent
est intégré via JAVA_TOOL_OPTIONS :
relution:
image: relution/relution:latest
environment:
- JAVA_TOOL_OPTIONS=-javaagent:/opt/glowroot/glowroot.jar
volumes:
- ./glowroot:/opt/glowroot
ports:
- '127.0.0.1:4000:4000'
Si JAVA_TOOL_OPTIONS est déjà définie, l’entrée -javaagent est ajoutée à la valeur
existante au lieu de la remplacer. Après la recréation du conteneur
(docker compose up -d), l’interface est disponible sur le port 4000. Grâce au répertoire
monté, les enregistrements sont conservés même lorsque le conteneur est recréé.
Le mappage de port 127.0.0.1:4000:4000 lie l’interface à l’adresse de bouclage du
serveur ; elle n’est donc accessible que depuis le serveur lui-même à l’adresse
http://localhost:4000 — depuis un poste de travail, par exemple via un tunnel SSH
(ssh -L 4000:localhost:4000 <server>).
127.0.0.1:4000:4000 en 4000:4000.Protéger l’interface par un mot de passe
En plus de la liaison au bouclage, l’interface peut être protégée par un mot de passe, par
exemple contre d’autres utilisateurs du même serveur. Pour cela, un utilisateur avec le
rôle Administrator et un mot de passe est créé dans l’interface sous
Administration → Users, puis l’utilisateur anonymous est supprimé. Glowroot stocke
le hachage du mot de passe dans glowroot/admin.json ; grâce au répertoire monté, il est
conservé lors des redémarrages.
Comme l’interface utilise du HTTP non chiffré, le mot de passe ne remplace pas la liaison au bouclage : via un mappage de port ouvert, il serait transmis en clair.
Désactiver Glowroot
Glowroot ne reste intégré que le temps de l’analyse. Pour le désactiver, la ligne
JAVA_TOOL_OPTIONS et le mappage de port sont retirés et le conteneur est recréé. Le
répertoire glowroot peut ensuite être supprimé ; s’il est conservé, les enregistrements
précédents sont de nouveau disponibles lors d’une analyse ultérieure.