Supported OS

Versión de la integración5.0.0

Información general

El check de ActiveMQ recopila métricas para agentes, colas, productores, consumidores, etc.

Nota: Este check también admite ActiveMQ Artemis (futura versión de ActiveMQ 6) e informa métricas bajo el espacio de nombres activemq.artemis. Consulta [metadata.csv]1 para ver una lista de métricas proporcionada por esta integración.

Nota: Si estás ejecutando una versión de ActiveMQ anterior a la 5.8.0, consulta los archivos de versiones de ejemplo del Agent 5.10.x.

Configuración

Instalación

El check de ActiveMQ del Agent está incluido en el paquete del Datadog Agent, por lo que no necesitas instalar nada más en tus nodos de ActiveMQ.

El check recopila métricas de JMX con JMXFetch. Se necesita una JVM en cada nodo para que el Agent pueda ejecutar JMXFetch. Datadog recomienda utilizar una JVM proporcionada por Oracle.

Configuración

host

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

  1. Asegúrate de que JMX Remote esté activado en tu servidor de ActiveMQ.

  2. Configura el Agent para conectarse a ActiveMQ. Edita activemq.d/conf.yaml, en la carpeta conf.d/ en la raíz del directorio de configuración del Agent. Consulta el activemq.d/conf.yaml de ejemplo para conocer todas las opciones de configuración disponibles. Consulta el archivo metrics.yaml para ver la lista de métricas recopiladas por defecto.

    init_config:
      is_jmx: true
      collect_default_metrics: true
    
    instances:
      - host: localhost
        port: 1616
        user: username
        password: password
        name: activemq_instance
    
  3. 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ñade este bloque de configuración a tu archivo activemq.d/conf.yaml para empezar a recopilar tus logs de ActiveMQ:

    logs:
      - type: file
        path: "<ACTIVEMQ_BASEDIR>/data/activemq.log"
        source: activemq
        service: "<SERVICE_NAME>"
      - type: file
        path: "<ACTIVEMQ_BASEDIR>/data/audit.log"
        source: activemq
        service: "<SERVICE_NAME>"
    
  3. Reinicia el Agent.

En contenedores

Para entornos en contenedores, consulta las plantillas de integración de Autodiscovery para obtener orientación sobre la aplicación de los parámetros que se indican a continuación.

Recopilación de métricas
ParámetroValor
<INTEGRATION_NAME>activemq
<INIT_CONFIG>"is_jmx": true
<INSTANCE_CONFIG>{"host": "%%host%%","port":"1099"}
Recopilación de logs

Disponible para las versiones 6.0 o posteriores del Agent

La recopilación de logs está desactivada por defecto en el Datadog Agent. Para activarla, consulta recopilación de logs de Kubernetes.

ParámetroValor
<LOG_CONFIG>{"source": "activemq", "service": "<YOUR_APP_NAME>"}

Validación

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

Datos recopilados

Métricas

activemq.artemis.address.bytes_per_page
(gauge)
(Solo Artemis) Número de bytes utilizados por cada página para esta dirección.
Se muestra como byte
activemq.artemis.address.number_of_messages
(rate)
(Solo Artemis) La suma de mensajes en cola, incluyendo mensajes en entrega.
Se muestra como mensaje
activemq.artemis.address.pages_count
(gauge)
(Solo Artemis) Número de páginas utilizadas por esta dirección.
Se muestra como página
activemq.artemis.address.routed_messages
(rate)
(Solo Artemis) Número de mensajes enrutados a una o más vinculaciones, en forma de tasa.
Se muestra como mensaje
activemq.artemis.address.size
(gauge)
(Solo Artemis) Número de bytes estimados que están siendo utilizados por todas las colas vinculadas a esta dirección; se utiliza para controlar la paginación y el bloqueo.
Se muestra como byte
activemq.artemis.address.unrouted_messages
(rate)
(Solo Artemis) Número de mensajes no enrutados a ninguna vinculación, como tasa.
Se muestra como mensaje
activemq.artemis.address_memory_usage
(gauge)
(Solo Artemis) Memoria utilizada por todas las direcciones en agente para mensajes en memoria.
Se muestra como byte
activemq.artemis.address_memory_usage_pct
(gauge)
(Solo Artemis) Memoria utilizada por todas las direcciones del agente como porcentaje del tamaño máximo global.
Se muestra como porcentaje
activemq.artemis.connection_count
(gauge)
(Solo Artemis) Número de clientes conectados a este servidor.
Se muestra como conexión
activemq.artemis.disk_store_usage_pct
(gauge)
(Solo Artemis) Porcentaje del total de disco utilizado.
Se muestra como porcentaje
activemq.artemis.max_disk_usage
(gauge)
(Solo Artemis) Límite máximo de uso del disco en porcentaje.
Se muestra como porcentaje
activemq.artemis.queue.consumer_count
(gauge)
(Solo Artemis) Número de consumidores que consumen mensajes de esta cola.
activemq.artemis.queue.max_consumers
(gauge)
(Solo Artemis) Número máximo de consumidores permitidos en esta cola al mismo tiempo.
activemq.artemis.queue.message_count
(gauge)
(Solo Artemis) Número de mensajes actualmente en esta cola (incluye mensajes programados, paginados y en entrega), como tasa.
Se muestra como mensaje
activemq.artemis.queue.messages_acknowledged
(rate)
(Solo Artemis) Número de mensajes reconocidos desde que se creó esta cola, en forma de tasa.
Se muestra como mensaje
activemq.artemis.queue.messages_added
(rate)
(Solo Artemis) Número de mensajes añadidos a esta cola desde su creación, en forma de tasa.
Se muestra como mensaje
activemq.artemis.queue.messages_expired
(rate)
(Solo Artemis) Número de mensajes caducados de esta cola desde que se creó, en forma de tasa.
Se muestra como mensaje
activemq.artemis.queue.messages_killed
(rate)
(Solo Artemis) Número de mensajes eliminados de esta cola desde que se creó debido a que se superaron los intentos de entrega máximos, en forma de tasa.
Se muestra como mensaje
activemq.artemis.total_connection_count
(rate)
(Solo Artemis) Número de clientes que se han conectado a este servidor desde que se inició, en forma de tasa.
Se muestra como conexión
activemq.artemis.total_consumer_count
(rate)
(Solo Artemis) Número de consumidores que consumen mensajes de todas las colas de este servidor, en forma de tasa.
activemq.artemis.total_message_count
(rate)
(Solo Artemis) Número de mensajes en todas las colas del servidor, en forma de tasa.
Se muestra como conexión
activemq.artemis.total_messages_acknowledged
(rate)
(Solo Artemis) Número de mensajes reconocidos desde todas las colas de este servidor desde que se inició, en forma de tasa.
Se muestra como conexión
activemq.artemis.total_messages_added
(rate)
(Solo Artemis) Número de mensajes enviados a este servidor desde que se inició, en forma de tasa.
Se muestra como conexión
activemq.broker.memory_pct
(gauge)
El porcentaje de memoria en uso.
Se muestra como porcentaje
activemq.broker.store_pct
(gauge)
El porcentaje de tienda en uso.
Se muestra como porcentaje
activemq.broker.temp_pct
(gauge)
El porcentaje de temporal en uso.
Se muestra como porcentaje
activemq.queue.avg_enqueue_time
(gauge)
En promedio, la cantidad de tiempo (ms) que los mensajes permanecieron en cola.
Se muestra como milisegundo
activemq.queue.consumer_count
(gauge)
El número de consumidores conectados.
activemq.queue.dequeue_count
(gauge)
La tasa de mensajes que se están poniendo en cola.
Se muestra como mensaje
activemq.queue.dispatch_count
(gauge)
La tasa de mensajes que se están enviando.
Se muestra como mensaje
activemq.queue.enqueue_count
(gauge)
La tasa de mensajes que se están poniendo en cola.
Se muestra como mensaje
activemq.queue.expired_count
(gauge)
La tasa de mensajes que están caducando.
Se muestra como mensaje
activemq.queue.in_flight_count
(gauge)
La tasa de mensajes que están por desplegar.
Se muestra como mensaje
activemq.queue.max_enqueue_time
(gauge)
La cantidad máxima de tiempo (ms) que los mensajes permanecieron en cola.
Se muestra como milisegundo
activemq.queue.memory_pct
(gauge)
El porcentaje de memoria actualmente en uso.
Se muestra como porcentaje
activemq.queue.min_enqueue_time
(gauge)
La cantidad mínima de tiempo (ms) que los mensajes permanecieron en cola.
Se muestra como milisegundo
activemq.queue.producer_count
(gauge)
El número de productores conectados.
activemq.queue.size
(gauge)
La cantidad de mensajes que quedaron en cola.
Se muestra como mensaje

Eventos

El check de ActiveMQ no incluye ningún evento.

Checks de servicio

activemq.can_connect

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

Estados: ok, critical, warning

Solucionar problemas

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

Referencias adicionales

Documentación útil adicional, enlaces y artículos: