Présentation

Ce check permet de surveiller des serveurs WebLogic Oracle.

Configuration

Installation

Le check WebLogic est inclus avec le package de l’Agent Datadog. Vous n’avez donc rien d’autre à installer sur votre serveur.

1. Ce check, qui repose sur JMX, recueille les métriques du serveur MBean de la plateforme qui sont exportées par la JVM. La surveillance JMX à distance doit donc être activée pour vos serveurs WebLogic. Consultez la rubrique Surveillance et gestion à distance (en anglais) pour obtenir des instructions d’installation.

2. Définissez la propriété système -Djavax.management.builder.initial=weblogic.management.jmx.mbeanserver.WLSMBeanServerBuilder pour activer ces métriques sur le serveur MBean de la plateforme. Cette propriété peut être configurée dans la console d’administration du serveur WebLogic ou dans des scripts de démarrage de serveur :

   Activation dans la console d’administration

   Domain => Configuration => General => Advanced => Platform MBean Server Enabled
   

   Activation dans des scripts de démarrage de serveur

   -Djavax.management.builder.initial=weblogic.management.jmx.mbeanserver.WLSMBeanServerBuilder
   

   Pour en savoir plus, consultez la documentation WebLogic (en anglais).

3. Vérifiez que l’attribut PlatformMBeanServerUsed est défini sur true dans la console d’administration du serveur WebLogic. Il s’agit de la valeur par défaut depuis la version 10.3.3.0 des serveurs WebLogic. Ce paramètre est accessible depuis la console d’administration des serveurs WebLogic ou peut être configuré à l’aide de WebLogic Scripting Tool (WSLT).

   Activation dans la console d’administration

   Domain (<WEBLOGIC_SERVER>) => Configuration => General => (Advanced) => Platform MBeanServer Enabled
   

   Activation dans WLST

   Commencez une session d’édition. Accédez au répertoire JMX du domaine et utilisez le paramètre cmo.setPlatformMBeanServerUsed(true) pour activer l’attribut si ce dernier est défini sur false.

   Par exemple :

   # > java weblogic.WLST
   (wlst) > connect('weblogic','weblogic')
   (wlst) > edit()
   (wlst) > startEdit()
   (wlst) > cd('JMX/<DOMAIN_NAME>')
   (wlst) > set('EditMBeanServerEnabled','true')
   (wlst) > activate()
   (wlst) > exit()
   

   Appliquez les modifications et redémarrez le serveur WebLogic.

Configuration

1. Modifiez le fichier weblogic.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 WebLogic. Consultez le fichier d’exemple weblogic.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

   Ce check prévoit une limite de 350 métriques par instance. Exécutez la commande status de l’Agent Datadog pour vérifier le nombre de métriques actuellement renvoyées. Choisissez les métriques qui vous intéressent en modifiant la configuration.

   Pour découvrir comment modifier la liste des métriques à recueillir, consultez la documentation relative aux checks JMX afin d’obtenir des instructions détaillées. Si vous devez surveiller davantage de métriques, contactez l’assistance Datadog.

2. Redémarrez l’Agent.

Validation

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

Données collectées

Métriques

Collecte de logs

1. Par défaut, les services de journalisation de WebLogic reposent sur une implémentation basée sur les API de logging Java. Dupliquez et modifiez la pipeline d’intégration si vous utilisez un autre format.

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

3. Supprimez la mise en commentaire du bloc de configuration des logs du fichier weblogic.d/conf.yaml et modifiez les paramètres. Modifiez les valeurs des paramètres path et service en fonction de votre environnement. Consultez le fichier d’exemple weblogic.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

    - type: file
      path: <DOMAIN_DIR>/servers/<ADMIN_SERVER_NAME>/logs/<ADMIN_SERVER_NAME>.log
      source: weblogic
      service: admin-server
      log_processing_rules:
        - type: multi_line
          name: new_log_start_with_date
          pattern: (\####)?<\w{3} (0?[1-9]|[12][0-9]|3[01]), \d{4}
    - type: file
      path: <DOMAIN_DIR>/servers/<ADMIN_SERVER_NAME>/logs/<DOMAIN_NAME>.log
      source: weblogic
      service: domain
      log_processing_rules:
        - type: multi_line
          name: new_log_start_with_date
          pattern: (\####)?<\w{3} (0?[1-9]|[12][0-9]|3[01]), \d{4}
    - type: file
      path: <DOMAIN_DIR>/servers/<SERVER_NAME>/logs/<SERVER_NAME>.log
      source: weblogic
      service: managed-server
      log_processing_rules:
        - type: multi_line
          name: new_log_start_with_date
          pattern: (\####)?<\w{3} (0?[1-9]|[12][0-9]|3[01]), \d{4}
    - type: file
      path: <DOMAIN_DIR>/servers/*/logs/access.log 
      source: weblogic
      service: http-access
      log_processing_rules:
        - type: multi_line
          name: new_log_start_with_date
          pattern: .*\[\d{2}\/(\w{3}|\w{4})\/\d{4}:\d{2}:\d{2}:\d{2} (\+|-)\d{4}\]
   

4. Redémarrez l’Agent.

Environnement conteneurisé

Pour les environnements conteneurisés, consultez le guide Autodiscovery avec JMX.

Événements

L’intégration WebLogic n’inclut aucun événement.

Checks de service

weblogic.can_connect
Returns OK if the Agent is able to connect to and collect metrics from the monitored WebLogic instance, WARNING if no metrics are collected, and OK otherwise.
Statuses: ok, critical, warning

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.