IBM WAS

Supported OS Linux Mac OS Windows

Intégration2.1.0

Présentation

Ce check permet de surveiller IBM Websphere Application Server (WAS) avec l’Agent Datadog. Il est compatible avec IBM WAS versions >= 8.5.5.

Configuration

Suivez les instructions ci-dessous pour installer et configurer ce check lorsque l’Agent est exécuté sur un host. Consultez la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer ces instructions à des environnements conteneurisés.

L’intégration Datadog/IBM WAS permet de recueillir les compteurs PMI activés depuis l’environnement WebSphere Application Server. Son implémentation nécessite d’activer le servlet PerfServlet, qui offre un moyen à Datadog de récupérer les données de performance issues de WAS.

Par défaut, ce check recueille les métriques associées à JDBC, à la JVM, au pool de threads et au gestionnaire de sessions du servlet. Il est également possible de recueillir des métriques supplémentaires en les spécifiant dans la section « custom_queries ». Consultez le fichier d’exemple de configuration du check pour découvrir des exemples.

Installation

Le check IBM WAS est inclus avec le package de l’Agent Datadog.

Activer PerfServlet

Le fichier .ear du servlet (PerfServletApp.ear) est situé dans le répertoire <WAS_HOME>/installableApps, où <WAS_HOME> correspond au chemin d’installation de WebSphere Application Server.

Le servlet de performance se déploie de la même manière que tout autre servlet. Déployez-le sur une instance unique du serveur d’application au sein du domaine.

Remarque : depuis la version 6.1, vous devez activer la sécurité des applications pour faire fonctionner PerfServlet.

Modifier l’ensemble de statistiques surveillé

Par défaut, votre serveur d’application est uniquement configuré pour la surveillance « Basic ». Pour gagner en visibilité sur votre JVM, vos connexions JDBC et vos connexions servlet, remplacez la valeur de l’ensemble de statistiques surveillé pour votre serveur d’application « Basic » par « All ».

Depuis la console d’administration de WebSphere, vous pouvez accéder à ce réglage depuis Application servers > <VOTRE_SERVEUR_APP> > Performance Monitoring Infrastructure (PMI).

Une fois ce changement effectué, cliquez sur « Apply » pour enregistrer la configuration et redémarrer votre serveur d’application. Les métriques JDBC, JVM et servlet supplémentaires apparaissent quelques instants plus tard dans Datadog.

Configuration

    Host

    Pour configurer ce check lorsque l’Agent est exécuté sur un host :

    Collecte de métriques

    1. Modifiez le fichier ibm_was.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos données de performance IBM WAS. Consultez le fichier d’exemple ibm_was.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

    2. Redémarrez l’Agent.

    Collecte de logs

    Disponible à partir des versions > 6.0 de l’Agent

    1. La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous devez l’activer dans datadog.yaml :

      logs_enabled: true

    2. Modifiez ensuite ibm_was.d/conf.yaml en supprimant la mise en commentaire des lignes logs en bas du fichier. Mettez à jour la ligne path en indiquant le bon chemin vers vos fichiers de log WAS.

      logs:
  - type: file
    path: /opt/IBM/WebSphere/AppServer/profiles/InfoSphere/logs/server1/*.log
    source: ibm_was
    service: websphere

    3. Redémarrez l’Agent.

    Environnement conteneurisé

    Consultez la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer les paramètres ci-dessous à un environnement conteneurisé.

    Collecte de métriques
    ParamètreValeur
    <NOM_INTÉGRATION>ibm_was
    <CONFIG_INIT>vide ou {}
    <CONFIG_INSTANCE>{"servlet_url": "http://%%host%%:%%port%%/wasPerfTool/servlet/perfservlet"}
    Collecte de logs

    Disponible à partir des versions > 6.0 de l’Agent

    La collecte des logs est désactivée par défaut dans l’Agent Datadog. Pour l’activer, consultez la section Collecte de logs avec Kubernetes.

    ParamètreValeur
    <CONFIG_LOG>{"source": "ibm_was", "service": "<NOM_SERVICE>"}

    Validation

    Lancez la sous-commande status de l’Agent et cherchez ibm_was dans la section Checks.

    Données collectées

    Métriques

    Événements

    IBM WAS n’inclut aucun événement.

    Checks de service

    Dépannage

    Besoin d’aide ? Contactez l’assistance Datadog.