Surveillance Apache Tomcat — compteurs, règles et aperçu du plugin

Ce guide explique comment ajouter des compteurs de performance pour Apache Tomcat, définir des règles de traitement d’événements personnalisées et comprendre les vues principales du plugin Tomcat. Vous trouverez des étapes pas à pas, une méthodologie, des checklists par rôle, des conseils de dépannage et des critères d’acceptation pour vérifier vos configurations.

Ajouter des compteurs de performance pour Apache Tomcat

Les compteurs de performance mesurent l’activité et la santé d’un système (métriques). L’application lit leurs valeurs à intervalles prédéfinis. L’objectif est de sonder et collecter des données pour produire des graphiques et tableaux de bord utiles à l’analyse. Vous pouvez définir un compteur manuellement ou le charger depuis un modèle. Les modèles de compteurs fournissent des paramètres de sondage prédéfinis pour des dispositifs spécifiques afin d’accélérer la création.

Chaque modèle de compteur inclut :

• Nom et description — identifiant unique et description facultative.
• Type de dispositif — type de l’élément supervisé.
• Type de protocole — protocole utilisé pour la collecte.
• Intervalle de sondage — pause entre deux relevés.

Étapes pour ajouter des compteurs Tomcat :

1. Dans la vue Accueil, sélectionnez l’hôte dans l’arborescence.
2. Ouvrez l’onglet Moniteurs puis passez à la liste des compteurs en cliquant sur le lien Counter list en haut à droite. La liste des compteurs s’affiche.
3. Sélectionnez Create counter dans le menu d’action global et cliquez sur Go.

4. Choisissez le compteur à créer puis cliquez sur Next.
5. Une fois les données chargées, la fenêtre d’édition s’ouvre avec tous les attributs du compteur à compléter.

6. Spécifiez le reste des paramètres (alarmes, seuils, etc.) puis cliquez sur Finish.
7. Le nouveau compteur est créé et visible dans la liste.

Important

• Testez toujours un compteur avec un intervalle de sondage plus long en production puis réduisez-le si nécessaire. Les intervalles typiques sont de 10 s à 5 min selon l’objet monitoré et l’impact réseau.
• Définissez des seuils pertinents par rapport aux SLA applicables.

Créer des règles de traitement d’événements personnalisées pour Apache Tomcat

Les règles de traitement permettent d’automatiser la gestion des événements : génération d’alarmes, suppression ou transfert d’événements et assignation de sévérité.

Pour affecter une règle de traitement d’événements :

1. Sélectionnez l’hôte puis allez dans l’onglet Events.
2. Cochez les événements souhaités, choisissez Assign processing rules et cliquez sur Go.
3. Une fenêtre de dialogue apparaît.

4. Sélectionnez la catégorie de règle et cliquez sur Add new rule.
5. La règle nouvellement créée devient active immédiatement.

Notes

• Les règles s’appliquent en temps réel ; il n’est pas nécessaire de se déconnecter pour que les modifications prennent effet.
• Documentez chaque règle (nom, objectif, auteur, date de modification) pour faciliter la gouvernance et les audits.

Aperçu du plugin Tomcat

Le plugin Tomcat expose quatre vues principales utiles pour le suivi et le diagnostic :

• Vue informations générales — version de Tomcat, nom et version du système d’exploitation, fournisseur et version de la JVM, informations JVM, port de contrôle, temps de réponse moyen. Contient aussi un tableau de bord avec des graphiques de synthèse des réponses et de disponibilité des threads.
• Vue applications — état des applications : sessions en cours, sessions maximales, performance des servlets et pages : URL et temps de réponse moyen.
• Vue processeurs de requêtes — métriques par processeur et processeur global (URI, worker, compteurs de requêtes et d’erreurs, octets envoyés et reçus, temps de traitement) et graphique de synthèse des réponses par connecteur.
• Vue connecteurs et pools de threads — paramètres des connecteurs (port, protocole, secure, redirect port, max post size), pool de threads (nom, threads occupés, threads actuels, max spare threads) et graphique de disponibilité des threads.

Si vous avez suivi ce guide, vous pouvez maintenant surveiller une application Apache Tomcat et visualiser ses métriques principales.

Mini-méthodologie pour une adoption efficace

1. Inventaire initial — identifiez les hôtes Tomcat critiques et les applications exposées.
2. Baseline — collectez des métriques pendant une période calme (ex. 48–72 h) pour définir des valeurs de référence.
3. Déploiement progressif — activez des compteurs et règles sur un environnement de préproduction, puis augmentez la couverture.
4. Automatisation — appliquez des modèles et règles pour homogénéiser la configuration.
5. Revue périodique — audit trimestriel des compteurs, seuils et règles.

Checklist par rôle

Administrateur système

• Vérifier la connectivité du protocole de collecte.
• Valider les droits d’accès à la JVM et aux JMX (si utilisés).
• Surveiller l’impact réseau des intervalles de sondage.

Ingénieur DevOps

• Déployer les modèles de compteurs via l’outil d’automatisation.
• Configurer les seuils selon les SLA.
• Intégrer les alertes aux canaux de notification (e-mail, webhook, incident).

Responsable applicatif

• Valider les métriques métier (sessions actives, temps de réponse pour endpoints critiques).
• Demander ajustement des seuils selon le comportement réel de l’application.

Support niveau 1

• Connaître les règles de triage d’événements.
• Savoir reconnaître les alertes communes (saturation threads, erreurs 5xx, fuite de sessions).

Quand ça échoue — dépannage rapide

Symptôme : pas de nouvelles métriques

• Vérifier que le service de collecte est démarré.
• Contrôler les ports et pare-feu entre le collecteur et le serveur Tomcat.
• Confirmer les permissions JMX ou credentials du protocole utilisé.

Symptôme : compteurs avec zéros ou valeurs incohérentes

• Valider la version du plugin et sa compatibilité avec la version de Tomcat.
• Reprendre la configuration du compteur (chemins, MBeans, expressions).

Symptôme : trop d’alertes

• Examiner les seuils ; utiliser des fenêtres d’évaluation plus longues ou des règles de suppression pour les bruits.
• Activer des règles d’annulation basées sur l’historique (par ex. ignorer pics isolés).

Critères d’acceptation

• Les compteurs configurés remontent des valeurs cohérentes pendant au moins 24 heures.
• Les alertes critiques déclenchent une notification sur le canal défini.
• Les règles de traitement appliquent la sévérité attendue et ne bloquent pas les événements prioritaires.
• Les dashboards affichent les graphiques de réponse et de threads sans erreurs de collecte.

Fiche technique et bonnes pratiques

• Intervalles de sondage recommandés : 10 s à 5 min selon criticité et charge.
• Prioriser la surveillance des endpoints métier et des ressources JVM (heap, GC, threads).
• Documenter chaque compteur et règle pour réplicabilité.

Résumé

• Ajoutez des compteurs via la liste des compteurs et les modèles pour accélérer la création.
• Créez des règles de traitement pour automatiser la gestion des événements.
• Utilisez les quatre vues du plugin Tomcat pour couvrir l’infrastructure et l’application.
• Testez, documentez et révisez régulièrement les compteurs et règles.

Important

La surveillance efficace combine métriques techniques et compréhension métier : associez temps de réponse, disponibilité de threads et indicateurs applicatifs pour obtenir des alertes exploitables.