JBoss/WildFly

Supported OS Linux Windows Mac OS

Integration version2.2.0

Información general

Este check monitoriza aplicaciones de JBoss y WildFly.

Configuración

Instalación

El check de JBoss/WildFly está incluido en el paquete del Datadog Agent por lo que no necesitas instalar nada más en tu host de JBoss/WildFly.

Configuración

Este check tiene un límite de 350 métricas por instancia. El número de métricas devueltas se indica en la página de estado. Puedes especificar las métricas que te interesen editando la configuración a continuación. Para saber cómo personalizar las métricas recopiladas, consulta la documentación de checks de JMX para obtener instrucciones más detalladas. Si necesitas monitorizar más métricas, ponte en contacto con el soporte de Datadog.

Host

Para configurar este check para un Agent que se ejecuta en un host:

Recopilación de métricas
  1. Edita el archivo jboss_wildfly.d/conf.yaml, en la carpeta conf.d/ en la raíz de tu directorio de configuración del Agent para comenzar a recopilar los datos de rendimiento de tu servidor de aplicaciones de JBoss o WildFly. Consulta el ejemplo jboss_wildfly.d/conf.yaml para ver todas las opciones disponibles de configuración.

    Según la configuración de tu servidor (particularmente cuando utilices el esquema de JMX remote+http), puede que necesites especificar un JAR personalizado para conectarte al servidor. Coloca el JAR en la misma máquina que tu Agent, y añade su ruta a la opción custom_jar_paths de tu archivo jboss_wildfly.d/conf.yaml.

    Nota: El esquema URL de JMX es diferente según la versión de WildFly:

    • Para Wildfly 9 y posteriores: service:jmx:http-remoting-jmx://<HOST>:<PORT>
    • Para Wildfly 10+: service:jmx:remote+http://<HOST>:<PORT>

    Consulta la página de configuración del subsistema de WildFly JMX para obtener más información.

  2. Reinicia el Agent.

Recopilación de logs

Disponible para el Agent versiones >6.0

  1. La recopilación de logs está desactivada por defecto en el Datadog Agent, actívala en tu archivo datadog.yaml:

    logs_enabled: true
    
  2. A continuación, edita jboss_wildfly.d/conf.yaml descomentando las líneas logs de la parte inferior. Actualiza la path de logs con la ruta correcta a tus archivos de log de JBoss.

    logs:
      - type: file
        path: /opt/jboss/wildfly/standalone/log/*.log
        source: jboss_wildfly
        service: '<APPLICATION_NAME>'
    
  3. Reinicia el Agent.

Contenedores

Recopilación de métricas

Para obtener información sobre entornos en contenedores, consulta la guía de Autodiscovery con JMX.

Recopilación de logs

Disponible para el Agent versiones >6.0

La recopilación de logs se encuentra deshabilitada de manera predeterminada en el Datadog Agent. Para habilitarla, consulta Recopilación de logs de Kubernetes.

ParámetroValor
<LOG_CONFIG>{"source": "jboss_wildfly", "service": "<SERVICE_NAME>"}

Validación

Ejecuta el subcomando de estado del Agent y busca jboss_wildfly en la sección Checks.

Datos recopilados

Métricas

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

Eventos

La integración JBoss/WildFly no incluye ningún evento.

Checks de servicio

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

Recopilación de métricas con JMXFetch

Puedes configurar el Datadog Agent para recopilar métricas de aplicación de Java a través de JMXFetch. Para recopilar las métricas predeterminadas configuradas para la integración de JBoss/Wildfly y Datadog, establece la propiedad del sistema Ddd.jmxfetch.jboss_wildfly.enabled=true.

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con el soporte de Datadog.