JBoss/WildFly

Supported OS Linux Windows Mac OS

Versión de la integración3.1.0

Información general

Este check monitoriza las aplicaciones 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 page (página) de estado. Puedes especificar las métricas que te interesan 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 asistencia técnica 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 de jboss_wildfly.d/conf.yaml para ver todas las opciones de configuración disponibles.

    En función de la configuración de tu servidor (particularmente cuando utilices el esquema de JMX de 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 de 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 page (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 las versiones 6.0 o posteriores del Agent

  1. La recopilación de logs está desactivada en forma predeterminada 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.

En contenedores

Recopilación de métricas

Para entornos en contenedores, consulta la guía Autodiscovery con JMX.

Recopilación de logs

Disponible para las versiones 6.0 o posteriores del Agent

La recopilación de logs está desactivada en forma predeterminada en el Datadog Agent. Para activarla, consulta la 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(https://docs.datadoghq.com/agent/guide/agent-commands/#agent-status-and-information) y busca jboss_wildfly en la sección Checks.

Datos recopilados

Métricas

jboss.jdbc_connections.active
(gauge)
número de connections (conexiones) activas
Mostrado como connection (conexión)
jboss.jdbc_connections.count
(gauge)
número de connections (conexiones) abiertas
Mostrado como connection (conexión)
jboss.jdbc_connections.idle
(gauge)
número de connections (conexiones) físicas actualmente inactivas
Mostrado como connection (conexión)
jboss.jdbc_connections.request_wait
(rate)
número de solicitudes que han tenido que esperar para obtener una connection (conexión) física
Mostrado como connection (conexión)
jboss.jdbc_preparedstatementcache.hit
(rate)
número de veces que se han utilizado sentencias de la caché
Mostrado como acierto
jboss.jdbc_preparedstatementcache.miss
(rate)
número de veces que no se ha podido satisfacer una solicitud de sentencia con una sentencia de la caché
Mostrado como fallo
jboss.jdbc_preparedstatementcache.size
(gauge)
número de sentencias preparadas y ejecutables almacenadas actualmente en la caché de sentencias
jboss.jdbc_xacommit.count
(rate)
número de invocaciones de confirmación de XAResource
Mostrado como confirmación
jboss.jdbc_xarecover.count
(rate)
número de invocaciones de recuperación de XAResource
Mostrado como transacción
jboss.jdbc_xarollback.count
(rate)
número de invocaciones de reversiones de XAResource
Mostrado como transacción
jboss.transactions.aborted
(rate)
número total de transacciones que se han reverido.
Mostrado como transacción
jboss.transactions.application_rollbacks
(rate)
número de transacciones revertidas por la aplicación.
Mostrado como transacción
jboss.transactions.committed
(rate)
número de transacciones confirmadas.
Mostrado como transacción
jboss.transactions.count
(rate)
número de transacciones (de nivel superior y anidadas) creadas hasta el momento.
Mostrado como transacción
jboss.transactions.heuristics
(rate)
número de transacciones que han finalizado con resultados heurísticos
Mostrado como transacción
jboss.transactions.inflight
(gauge)
número total de transacciones a bordo (activas).
Mostrado como transacción
jboss.transactions.nested
(rate)
número de (sub) transacciones anidadas creadas hasta el momento.
Mostrado como transacción
jboss.transactions.resource_rollbacks
(rate)
número de transacciones revertidas por los participantes.
Mostrado como transacción
jboss.transactions.system_rollbacks
(rate)
número de transacciones que se han revertido debido a un error interno del sistema.
Mostrado como transacción
jboss.transactions.timed_out
(rate)
número total de transacciones revertidas debido al tiempo de expiración.
Mostrado como transacción
jboss.undertow_listener.bytes_received
(rate)
número de bytes que se han recibido
Mostrado como byte
jboss.undertow_listener.bytes_sent
(rate)
número de bytes que se han enviado
Mostrado como byte
jboss.undertow_listener.error_count
(rate)
número de 500 respuestas que se han enviado
Mostrado como solicitud
jboss.undertow_listener.processing_time
(gauge)
tiempo total de procesamiento de todas las solicitudes entregadas por este receptor
Mostrado como nanosegundo.
jboss.undertow_listener.request_count
(rate)
número de solicitudes atendidas
Mostrado como solicitud
jboss.undertow_session.active
(gauge)
número de sesiones activas
Mostrado como sesión
jboss.undertow_session.alivetime_avg
(gauge)
tiempo medio (en segundos) que han estado activas las sesiones caducadas
Mostrado como segundo
jboss.undertow_session.alivetime_max
(gauge)
mayor tiempo (en segundos) que una sesión caducada ha estado activa
Mostrado como segundo
jboss.undertow_session.created
(rate)
total de sesiones creadas
Mostrado como sesión
jboss.undertow_session.expired
(rate)
número de sesiones que han expirado
Mostrado como sesión
jboss.undertow_session.rejected
(rate)
número de sesiones rechazadas
Mostrado como sesión

Eventos

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

Checks de servicio

jboss.can_connect

Devuelve CRITICAL si el Agent no puede conectarse y recopilar métricas de la instancia de JBoss/WildFly monitorizada, WARNING si no se recopilan métricas y OK en caso contrario.

Estados: ok, crítico, advertencia

Recopilación de métricas con JMXFetch

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

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con asistencia técnica de Datadog.