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.

L’activation de Glowroot via les variables d’environnement du conteneur, intégrée jusqu’à Relution 27.0, a été supprimée avec Relution 27.1 ; ces variables sont ignorées à partir de Relution 27.1. Le guide suivant fonctionne sur toutes les versions prises en charge — sur les versions jusqu’à 27.0, l’ancienne activation ne doit simplement pas être définie en même temps, sinon Glowroot est intégré deux fois.

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>).

L’interface sur le port 4000 expose les requêtes de base de données, les temps de réponse et les traces d’exécution, et n’est initialement pas protégée par un mot de passe. Elle ne doit en aucun cas être accessible depuis Internet — ne pas élargir le mappage de port 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.

Cet article a-t-il été utile ?