Encuentre y consulte sus datos de IBM MQ en New Relic

1. Vaya a one.newrelic.com > All entities.
2. Filtre por IBMMQ_MANAGER y IBMMQ_QUEUE, o busque un nombre de gestor de colas.
3. Abra un administrador de colas para ver sus métricas doradas —conexiones, tasas de mensajes put/get— y su dashboard preconfigurado de IBM MQ, con sus colas enumeradas como entidades relacionadas.

Cuando abre una entidad IBMMQ_MANAGER, New Relic muestra un dashboard prediseñado que resume el estado del administrador de colas, las conexiones, el rendimiento de los mensajes, los errores y el uso del sistema de archivos. Abra una entidad IBMMQ_QUEUE para obtener la profundidad por cola, la antigüedad de los mensajes y el rendimiento. También puede crear el suyo propio — consulte Crear dashboard personalizado.

Alertas cuando un gestor de colas sale de su estado de ejecución (2).

FROM Metric SELECT latest(ibmmq_qmgr_status) FACET qmgr, target.name

Umbral recomendado: crítico cuando el valor no es igual a 2 durante al menos 2 minutos.

Alertas cuando un canal sale de su estado de ejecución (3).

FROM Metric SELECT latest(ibmmq_channel_status) FACET qmgr, channel

Umbral recomendado: crítico cuando el valor no es igual a 3 durante al menos 5 minutos (tenga en cuenta los canales que se detienen y se inician legítimamente).

Alertas cuando la profundidad de una cola se acerca a su máximo configurado.

FROM Metric SELECT latest(ibmmq_queue_depth) / latest(ibmmq_queue_attribute_max_depth) * 100 AS 'Depth %' FACET qmgr, queue

Umbral recomendado: advertencia al 80 %, crítico al 95 %.

Alertas cuando los mensajes llegan a la cola de mensajes muertos — por lo general, una señal de mensajes que no se pueden entregar.

FROM Metric SELECT latest(ibmmq_queue_depth) WHERE queue = 'SYSTEM.DEAD.LETTER.QUEUE' FACET qmgr

Umbral recomendado: crítico cuando el valor es mayor que 0.

Esto casi siempre es causado por alterar la forma de la métrica crítica para la entidad. La síntesis de la entidad utiliza como clave las métricas con guion bajo sin procesar (ibmmq_*), la etiqueta qmgr sin procesar y un atributo target.name. Verifique que:

• Los nombres de las métricas no están separados por puntos (debería ver ibmmq_queue_depth, no ibmmq.queue.depth).

• La etiqueta qmgr está presente y no renombrada (no ibmmq.queue_manager.name).

• target.name se establece en las métricas (y el camelCase targetName no — si targetName aún está presente, transform/ibmmq-cleanup no se está ejecutando o está mal ordenado):

  FROM Metric SELECT uniques(target.name), uniques(qmgr) WHERE metricName LIKE 'ibmmq_%' SINCE 30 minutes ago

  Copia

  El orden del procesador en la configuración del recolector es fundamental — resourcedetection → transform/ibmmq-cleanup. Si reordenó o eliminó transform/ibmmq-cleanup, las métricas de IBM MQ se enrutan a la propia entidad del recolector en lugar de a una entidad IBMMQ_MANAGER. Restaure el orden documentado del pipeline.

New Relic espera una temporalidad delta para los contadores; Prometheus emite una acumulativa. El procesador cumulativetodelta/ibmmq los convierte in situ. Si los contadores parecen planos, confirme que el procesador esté presente en cada pipeline de métricas.

El valor target.name (establecido a través de la variable de entorno TARGET_NAME en Linux, o el reetiquetado targetName en Kubernetes) es el primer segmento de cada GUID de IBMMQ_MANAGER y IBMMQ_QUEUE. Cambiarlo después del despliegue crea entidades completamente nuevas y las antiguas se vuelven obsoletas, rompiendo los dashboards y las alertas que apuntan a los GUID antiguos. Elija un valor estable una vez y nunca lo cambie.

Si ya lo cambió, restaure el valor original de TARGET_NAME y reinicie el recolector. Las entidades nombradas correctamente reanudan el reporte; los duplicados creados con el nombre incorrecto dejan de recibir datos y desaparecen de la UI después de la ventana de reporte de la entidad de New Relic.