Surveillance d'Apache Tomcat
Grâce à l' Instana, vous pouvez surveiller de manière exhaustive votre environnement Apache Tomcat afin d'identifier rapidement les goulots d'étranglement et d'optimiser les performances des applications. Pour surveiller Apache Tomcat, installez l'agent hôte Instana. Une fois l'agent installé, le capteur « Apache Tomcat » s'active automatiquement et recueille des données de surveillance en temps réel que vous pouvez consulter dans l'interface utilisateur d' Instana.
Informations de support
Pour vous assurer que le capteur d' Apache Tomcat s est compatible avec votre configuration actuelle, consultez les sections d'informations d'assistance suivantes :
Systèmes d'exploitation pris en charge
Les systèmes d'exploitation pris en charge par le capteur Tomcat correspondent aux exigences de l'agent hôte, qui peuvent être consultées dans la section « Systèmes d'exploitation pris en charge » de chaque agent hôte, comme par exemple les systèmes d'exploitation pris en charge pour Unix.
Versions prises en charge et politique d'assistance
Le capteur prend en charge toutes les versions d' Apache Tomcat, de la version 5.x à la version 11.x.
Le tableau suivant présente la dernière version prise en charge et la politique d'assistance :
| Technologie | Politique de support | Dernière version technologique | Dernière version prise en charge |
|---|---|---|---|
| Apache Tomcat | 45 jours | 11.0.23 | 11.0.22 |
Pour plus d'informations sur la politique d'assistance, consultez la section « Stratégie d'assistance pour les capteurs ».
Prise en charge du traçage côté client
Pour Apache Tomcat, Instana prend en charge le traçage côté client pour Java.
Configuration facultative
Une fois l'agent installé, le capteur « Apache Tomcat » est automatiquement installé et déployé. Le capteur « Apache Tomcat » est activé par défaut et commence à collecter des données de surveillance d' Apache Tomcat.
Dénomination Tomcat
Le capteur « Apache Tomcat » lit le fichier de ServerInfo.properties configuration de Tomcat et en extrait le nom des instances Tomcat. Ce nom s'affiche dans l'interface utilisateur d' Instana.
Si vous le souhaitez, vous pouvez modifier le nom de l'instance Tomcat dans le répertoire « Instana » en modifiant le fichier de ServerInfo.propertiesconfiguration de Tomcat.
Pour éditer le fichier de configuration permettant de renommer l'instance Tomcat, procédez comme suit:
- Go dans le fichier
ServerInfo.propertiessuivant :CATALINA_BASE/lib/org/apache/catalina/util/ServerInfo.properties - Pour modifier le nom de l'instance Tomcat, modifiez la valeur de la zone
server.info. Voir l'exemple suivant :server.info=Apache Tomcat/7.0.x
Configuration d'une fréquence d'interrogation personnalisée
Vous pouvez configurer la fréquence à laquelle l' Instana interroge Apache Tomcat pour collecter des données et des métriques en utilisant le poll_rate paramètre dans le fichier de configuration.yaml l'agent, comme le montre l'exemple suivant :
com.instana.plugin.tomcat:
poll_rate: 1 # values are in seconds. Default value is 1 second.Collecte des métriques
Le capteur « Apache Tomcat » surveille l'instance d' Apache Tomcat et en recueille les métriques suivantes :
Pour afficher ces métriques, procédez comme suit:
- Sélectionnez « Infrastructure » dans la barre latérale de l'interface utilisateur d' Instana.
- Cliquez sur un hôte surveillé spécifique.
Vous pouvez voir le tableau de bord de l'hôte avec toutes les métriques collectées et les processus surveillés.
Données de configuration
Le capteur « Apache Tomcat » recueille les données de configuration suivantes auprès de l'instance « Apache Tomcat » :
| Élément de configuration | Description |
|---|---|
| Version | Apache Tomcat informations sur la version (par exemple, 11.0.13 ) |
| Accueil | Répertoire racine de l'installation de Tomcat (CATALINA_HOME) contenant les binaires, les bibliothèques et les fichiers de configuration |
| Webapps | Liste des applications web déployées, avec des informations telles que le nom, le contexte et les détails de la session :
|
| Servlets | Fournit des informations sur chaque servlet enregistré au sein d'une application Web déployée, notamment le nom du servlet, les requêtes, le temps de réponse moyen et les erreurs (détails disponibles dans le tableau « Applications Web ») |
| Connecteurs | Affiche les détails des connecteurs HTTP, HTTPS ou AJP, tels que le nom du connecteur, le nombre de threads, les threads actifs, le nombre maximal de threads, le port, le type de thread et la connexion :
|
| Programmes d'exécution | Configurations de l'exécuteur du pool de threads, notamment le nombre de threads, la taille des files d'attente, le nombre maximal de threads, le temps d'inactivité maximal et le pool de cœurs |
| Sources de données | Configurations du pool de connexions à la base de données, notamment les noms JNDI, les URL d' JDBC, le nombre de connexions actives et la taille maximale du pool :
|
Métriques de performance
Le capteur « Apache Tomcat » recueille les indicateurs de performance suivants à partir de l'instance « Apache Tomcat » :
| Métrique | Description | Granularité |
|---|---|---|
| Sessions | ||
| Nombre de sessions | Nombre de sessions actuellement actives. Utile pour surveiller l'activité des utilisateurs et gérer les sessions | 1 seconde |
| Demandes | Nombre de requêtes reçues par un servlet par seconde | 1 seconde |
| Temps de réponse moyens | Temps moyen (en millisecondes) nécessaire pour traiter toutes les requêtes de servlet par seconde | 1 seconde |
| Erreurs | Nombre de requêtes erronées par seconde, ce qui permet de suivre les requêtes ayant échoué et les erreurs de l'application | 1 seconde |
| Connecteurs | ||
| Unités d'exécution | Nombre de threads actuellement affectés à un connecteur pour le traitement des requêtes | 1 seconde |
| Unités d'exécution occupées | Nombre de threads traitant actuellement des requêtes, ce qui indique la charge actuelle du connecteur | 1 seconde |
| Nombre maximal d'unités d'exécution | Nombre maximal de threads qu'un pool peut contenir, ce qui contribue à déterminer la capacité maximale de traitement simultané des requêtes | 1 seconde |
| Nombre de connexions | Nombre de connexions actuellement gérées par un point de terminaison, qui recense les connexions réseau actives | 1 seconde |
| Nombre maximal de connexions | Nombre total de connexions simultanées qu'un serveur accepte et traite | 1 seconde |
| Délai d'attente de connexion | Durée maximale (en millisecondes) pendant laquelle Tomcat attend qu'un client envoie une requête « HTTP » complète après l'établissement d'une connexion « TCP » | |
| KeepAliveTimeout | Nombre de millisecondes pendant lesquelles le connecteur attend une nouvelle requête « HTTP » avant de fermer la connexion | |
| Connecteurs - Virtuels | ||
| Nom du connecteur | Identifiant du connecteur | |
| Unités d'exécution virtuelles | Nombre de threads virtuels traitant actuellement des requêtes | 1 seconde |
| Programmes d'exécution | ||
| Nombre d'unités d'exécution | Taille réelle du pool de threads pour les services d'exécution, qui s'adapte dynamiquement en fonction de la charge de travail et de la configuration | 1 seconde |
| Taille de la file d'attente | Nombre de tâches de traitement des requêtes actuellement en attente dans la file d'attente d'un pool de threads | 1 seconde |
| Nombre maximal d'unités d'exécution | Nombre maximal de threads pouvant être alloués ou créés dans un pool. Définit la limite maximale d'augmentation du pool de threads, permettant ainsi d'équilibrer la concurrence et la consommation de ressources. | 1 seconde |
| Nombre maximum inactifs | Nombre de millisecondes pendant lesquelles un thread inactif peut rester dans le pool avant d'être interrompu | |
| Pool de base | Nombre minimum de threads qui restent toujours actifs, qu'ils soient inactifs ou actifs | |
| Sources de données | ||
| Actif | Nombre actuel de connexions actives attribuées à partir d'une source de données spécifique | 1 seconde |
| Max | Nombre maximal de connexions actives pouvant être établies simultanément | 1 seconde |
Signatures d'intégrité
Chaque détecteur dispose d'une base de connaissances organisée de signatures de santé qui sont évaluées en continu par rapport aux métriques entrantes. Ces signatures de santé sont utilisées pour signaler des problèmes ou des incidents qui dépendent de l'impact sur l'utilisateur.
Les événements intégrés déclenchent des problèmes ou des incidents en cas de signature de santé défaillante sur des entités. Les événements personnalisés déclenchent des problèmes ou des incidents en fonction des seuils d'un indicateur spécifique à une entité donnée.
Pour plus d'informations sur les événements intégrés du capteur « Apache Tomcat », consultez la référence des événements intégrés.
Traçage
Instana prend en charge le traçage pour Apache Tomcat. Pour plus d'informations, consultez la section « Surveillance d'une machine virtuelle d' Java ».