Apache ActiveMQ

La integración de Apache ActiveMQ recopila métricas de uso de almacenamiento y de mensajes. Las métricas de almacenamiento incluyen el uso del disco y la memoria. Las métricas de mensajes incluyen la cantidad de mensajes en espera, el tiempo de espera promedio y los mensajes vencidos.

Para obtener más información sobre ActiveMQ, consulta activemq.apache.org/.

Requisitos previos

Para recopilar y transferir métricas de ActiveMQ, debes instalar el Agente de operaciones versión 2.11.0 o posterior.

Debes habilitar la compatibilidad con JMX en la configuración del agente.

Este receptor es compatible con las siguientes versiones de Apache ActiveMQ:

Versiones clásicas 5.8.x a 5.16.x de ActiveMQ.
Versión 2.x de ActiveMQ Artemis

Configura el Agente de operaciones para ActiveMQ

Mediante la guía Configura el Agente de operaciones, agrega los elementos necesarios para recopilar métricas de las instancias de ActiveMQ y reinicia el agente.

Configuración de ejemplo

El siguiente comando crea el archivo de configuración para recopilar y transferir registros de ActiveMQ, y reinicia el Agente de operaciones en Linux.

sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
metrics:
  receivers:
    activemq:
      type: activemq
  service:
    pipelines:
      activemq:
        receivers:
          - activemq
EOF
sudo service google-cloud-ops-agent restart

Configura la recopilación de métricas

A fin de recopilar métricas de ActiveMQ, debes crear un receptor para las métricas de ActiveMQ y, luego, crear una canalización destinada al receptor nuevo. A fin de configurar un receptor para las métricas de ActiveMQ, especifica los siguientes campos:

Campo	Predeterminada	Descripción
`type`		Este valor debe ser `activemq`.
`endpoint`	`http://localhost:1099`	La URL del nodo que se debe supervisar.
`username`		El nombre de usuario configurado si JMX está configurado para requerir autenticación.
`password`		La contraseña configurada si JMX está configurado para requerir autenticación.
`collection_interval`	`60s`	Un valor time.Duration, como `30s` o `5m`.

Qué se supervisa

En la siguiente tabla, se proporciona una lista de métricas que el Agente de operaciones recopila de la instancia ActiveMQ.

Tipo de métrica
Categoría, tipo Recursos supervisados	Etiquetas
`workload.googleapis.com/activemq.connection.count`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/activemq.consumer.count`
`GAUGE`, `INT64` gce_instance	`broker` `destination`
`workload.googleapis.com/activemq.disk.store_usage`
`GAUGE`, `DOUBLE` gce_instance
`workload.googleapis.com/activemq.disk.temp_usage`
`GAUGE`, `DOUBLE` gce_instance
`workload.googleapis.com/activemq.memory.usage`
`GAUGE`, `DOUBLE` gce_instance	`broker` `destination`
`workload.googleapis.com/activemq.message.current`
`GAUGE`, `INT64` gce_instance	`broker` `destination`
`workload.googleapis.com/activemq.message.dequeued`
`CUMULATIVE`, `INT64` gce_instance	`broker` `destination`
`workload.googleapis.com/activemq.message.enqueued`
`CUMULATIVE`, `INT64` gce_instance	`broker` `destination`
`workload.googleapis.com/activemq.message.expired`
`CUMULATIVE`, `INT64` gce_instance	`broker` `destination`
`workload.googleapis.com/activemq.message.wait_time.avg`
`GAUGE`, `DOUBLE` gce_instance	`broker` `destination`
`workload.googleapis.com/activemq.producer.count`
`GAUGE`, `INT64` gce_instance	`broker` `destination`

Recopila registros

ActiveMQ escribe registros en syslog, que el agente de operaciones captura según la configuración predeterminada. No se requiere ninguna configuración de usuario adicional.

Panel de muestra

Puedes ver las métricas de esta integración mediante un panel de Cloud Monitoring de muestra. Completa los procedimientos que se indican en Instala paneles de muestra para importar el panel Descripción general de ActiveMQ CGE de la Biblioteca de muestra y ver los gráficos que muestran tus métricas de ActiveMQ.

Verifica la transferencia

Para verificar que se hayan transferido los registros, ve al Explorador de registros y ejecuta la siguiente consulta a fin de ver los registros de ActiveMQ (reemplaza activemq con el nombre de tu unidad del sistema para ActiveMQ si es necesario):

resource.type="gce_instance"
logName="projects/PROJECT_ID/logs/syslog"
activemq

Puedes usar el Explorador de métricas para verificar que configuraste correctamente el receptor de métricas de ActiveMQ. El agente de operaciones puede tardar uno o dos minutos en comenzar a recopilar métricas.

Para verificar que las métricas se transfieran, ve a Explorador de métricas y ejecuta la siguiente consulta en la pestaña MQL.

fetch gce_instance
| metric 'workload.googleapis.com/activemq.connection.count'
| align rate(1m)
| every 1m

¿Qué sigue?

Para obtener una explicación sobre cómo usar Ansible a fin de instalar el agente de operaciones, configurar una aplicación de terceros y, luego, instalar un panel de muestra, consulta el video Instala el agente de operaciones para solucionar problemas de apps de terceros.