JBoss/WildFly

Supported OS Linux Mac OS Windows

Intégration2.0.1

Présentation

Ce check permet de surveiller les applications JBoss et WildFly.

Implémentation

Installation

Le check JBoss/WildFly est inclus avec le package de l’Agent Datadog : vous n’avez donc rien d’autre à installer sur votre host JBoss/WildFly.

Configuration

Ce check prévoit une limite de 350 métriques par instance. Le nombre de métriques renvoyées est indiqué sur la page d’information. Vous pouvez choisir des métriques pertinentes en modifiant la configuration ci-dessous. Pour découvrir comment modifier la liste des métriques recueillies, consultez la documentation relative aux checks JMX afin d’obtenir des instructions détaillées. Si vous souhaitez surveiller plus de 350 métriques, contactez l’assistance Datadog.

Host

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

Collecte de métriques
  1. Modifiez le fichier jboss_wildfly.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir les données de performance de votre serveur d’applications JBoss ou WildFly. Consultez le fichier d’exemple jboss_wildfly.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

    Selon la configuration de votre serveur (notamment si vous utilisez le schéma JMX remote+http), il se peut que vous deviez spécifier un JAR personnalisé pour vous connecter au serveur. Placez le JAR sur la même machine que votre Agent et spécifiez le chemin via l’option custom_jar_paths dans votre fichier jboss_wildfly.d/conf.yaml.

    Remarque : le format des URL JMX est différent selon votre version de WildFly :

    • Wildfly 9 et versions antérieures : service:jmx:http-remoting-jmx://<HOST>:<PORT>
    • Wildfly 10+ : service:jmx:remote+http://<HOST>:<PORT>

    Consultez la page de configuration du sous-système JMX pour WildFly pour en savoir plus.

  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 jboss_wildfly.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 JBoss.

    logs:
      - type: file
        path: /opt/jboss/wildfly/standalone/log/*.log
        source: jboss_wildfly
        service: '<APPLICATION_NAME>'
    
  3. Redémarrez l’Agent.

Environnement conteneurisé

Collecte de métriques

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

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

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

Validation

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

Données collectées

Métriques

jboss.jdbc_connections.active
(gauge)
number of active connections
Shown as connection
jboss.jdbc_connections.count
(gauge)
number of open connections
Shown as connection
jboss.jdbc_connections.idle
(gauge)
number of physical connections currently idle
Shown as connection
jboss.jdbc_connections.request_wait
(rate)
number of requests that had to wait to obtain a physical connection
Shown as connection
jboss.jdbc_preparedstatementcache.hit
(rate)
number of times that statements from the cache were used
Shown as hit
jboss.jdbc_preparedstatementcache.miss
(rate)
number of times that a statement request could not be satisfied with a statement from the cache
Shown as miss
jboss.jdbc_preparedstatementcache.size
(gauge)
number of prepared and callable statements currently cached in the statement cache
jboss.jdbc_xacommit.count
(rate)
number of XAResource commit invocations
Shown as commit
jboss.jdbc_xarecover.count
(rate)
number of XAResource recover invocations
Shown as transaction
jboss.jdbc_xarollback.count
(rate)
number of XAResource rollback invocations
Shown as transaction
jboss.transactions.aborted
(rate)
total number of transactions which have rolled back.
Shown as transaction
jboss.transactions.application_rollbacks
(rate)
number of transactions rolled back by the application.
Shown as transaction
jboss.transactions.committed
(rate)
number of committed transactions.
Shown as transaction
jboss.transactions.count
(rate)
number of transactions (top-level and nested) created so far.
Shown as transaction
jboss.transactions.heuristics
(rate)
number of transactions which have terminated with heuristic outcomes
Shown as transaction
jboss.transactions.inflight
(gauge)
total number of inflight (active) transactions.
Shown as transaction
jboss.transactions.nested
(rate)
number of nested (sub) transactions created so far.
Shown as transaction
jboss.transactions.resource_rollbacks
(rate)
number of transactions rolled back by participants.
Shown as transaction
jboss.transactions.system_rollbacks
(rate)
number of transactions that were rolled back due to an internal system error.
Shown as transaction
jboss.transactions.timed_out
(rate)
total number of transactions rolled back due to timeout.
Shown as transaction
jboss.undertow_listener.bytes_received
(rate)
number of bytes that have been received
Shown as byte
jboss.undertow_listener.bytes_sent
(rate)
number of bytes that have been sent out
Shown as byte
jboss.undertow_listener.error_count
(rate)
number of 500 responses that have been sent
Shown as request
jboss.undertow_listener.processing_time
(gauge)
total processing time of all requests handed by this listener
Shown as nanosecond
jboss.undertow_listener.request_count
(rate)
number of requests served
Shown as request
jboss.undertow_session.active
(gauge)
number of active sessions
Shown as session
jboss.undertow_session.alivetime_avg
(gauge)
average time (in seconds) that expired sessions had been alive
Shown as second
jboss.undertow_session.alivetime_max
(gauge)
longest time (in seconds) that an expired session had been alive
Shown as second
jboss.undertow_session.created
(rate)
total sessions created
Shown as session
jboss.undertow_session.expired
(rate)
number of sessions that have expired
Shown as session
jboss.undertow_session.rejected
(rate)
number of rejected sessions
Shown as session

Événements

L’intégration JBoss/WildFly n’inclut aucun événement.

Checks de service

jboss.can_connect
Returns CRITICAL if the Agent is unable to connect to and collect metrics from the monitored JBoss/WildFly instance, WARNING if no metrics are collected, and OK otherwise.
Statuses: ok, critical, warning

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.