Vista previa pública
Esta característica es actualmente una vista previa pública.
Nuestra integración IBM MQ recopila y envía métricas dimensionales desde IBM MQ.
Puede ver estos datos métricos en un panel prediseñado, crear políticas de alertas y crear consultas y gráficos personalizados.
dashboard instalado a través del New Relic IBM MQ monitor inicio rápido.
Para obtener datos de la infraestructura IBM MQ, nuestra integración IBM MQ utiliza un exportador Prometheus de terceros, que expone Prometheus métrica en el puerto especificado en la configuración. La integración recopila estas métricas, las transforma en entidad, las filtra y luego las envía a New Relic.
Importante
La integración de IBM MQ no admite la arquitectura ARM64.
Para instalar la integración de monitoreo de IBM MQ, ejecute los siguientes pasos:
Compatibilidad y requisitos
Versiones de IBM MQ
Nuestra integración es compatible con IBM MQ 9.0 o superior.
Sistema operativo soportado
- linux
- Windows
Para obtener una lista completa de versiones específicas de Linux y Windows, consulte la tabla de sistemas operativos compatibles.
Importante
La arquitectura ARM64 no es compatible.
Requisito del sistema
- Instale el agente de infraestructura, versión mínima 1.24.0.
- Distribución Linux o versión Windows compatible con el agente de infraestructura.
- Biblioteca de IBM MQ Redistributable Client en el cuadro de agente.
- Verifique o agregue la ruta de la biblioteca en la variable de entorno
LD_LIBRARY_PATHen Linux o siga estos pasos en Windows. - Asegúrese de que el monitoreo de estadísticas de cola esté habilitado en MQ.
- Cree un usuario en MQ con permisos de solo lectura.
Instalar y activar
Para instalar la integración, siga las instrucciones para su entorno:
Otros ambientes
¿Te ha ayudado este documento con la instalación?
Configurar la integración
Para configurar la integración, edite la configuración en el archivo de configuración YAML de la integración, ibmmq-config.yml. La configuración de formato YAML de una integración es donde puede colocar las credenciales de inicio de sesión requeridas y configurar cómo se recopilan los datos. Las opciones que cambie dependen de su configuración y preferencia. El archivo de configuración tiene configuraciones comunes aplicables a todas las integraciones.
Para leer todo sobre estas configuraciones comunes, consulte nuestro documento de formato de configuración .
Valores de instancia de IBM MQ
Están disponibles las siguientes opciones de configuración:
Configuración | Descripción | Por defecto |
|---|---|---|
hostname | Nombre de host del servicio IBM MQ | N/A |
port | Puerto del servicio IBM MQ | N/A |
queue_manager | Nombre del administrador de colas | N/A |
channel | Nombre del canal utilizado para conectarse al gestor de colas. Normalmente puedes usar | N/A |
username | Nombre de usuario para autenticarse en el servicio IBM MQ. Si no se especifica la contraseña, la autenticación de usuario/contraseña está deshabilitada y el nombre de usuario no debe especificarse en la configuración. El exportador se conectará enviando como | N/A |
password | Contraseña para autenticarse en el servicio IBM MQ | N/A |
monitored_queues | Colas para monitor (se aceptan comodines y ! para excluir) | N/A |
monitored_channels | Canales a monitor (se aceptan comodines y ! para excluir) | N/A |
monitored_topics | Temas a monitor (se aceptan comodines y ! para excluir) | N/A |
monitored_subscriptions | Suscripción para monitor (se aceptan comodines y ! para excluir) | N/A |
exporter_port | Puerto para exponer el extremo de scrape. Si no se proporciona, se utilizará un puerto aleatorio para iniciar el exportador. | port aleatorio |
scrape_timeout | Tiempo hasta que se agote el tiempo de espera de una solicitud de extracción | 5s |
mqsslkeyr | Necesario para configurar TLS MQSSLKEYR especifica la ubicación del almacén de claves que contiene el certificado digital que pertenece al usuario o al servidor. Debe especificarse sin la extensión para que apunte tanto | N/A |
ccdt_url | Necesario para configurar la ruta TLS al archivo ccdt. Se establecerán automáticamente dos variables de entorno diferentes: MQCCDTURL e IBMMQ_CONNECTION_CCDTURL. | N/A |
home | El Cliente IBMMQ necesita permisos para escribir en un directorio especificado en la variable de entorno HOME. | N/A |
ld_library_path | Variable de entorno LD_LIBRARY_PATH para el cliente IBMMQ utilizado por el exportador. | N/A |
Archivos de muestra ibmmq-config.yml
Buscar y utilizar datos
- El inicio rápido New Relic IBM MQ monitor está disponible a través de Observabilidad instantánea (I/O). Proporciona un dashboard que le permite explorar fácilmente sus datos, comprender el contexto y resolver problemas más rápido.
- Para obtener más información sobre cómo encontrar y utilizar sus datos, consulte Comprender los datos de integración.
- métrica se adjuntan a los tipos de muestra y evento métrica de la entidad
IBMMQ_MANAGERyIBMMQ_QUEUE. - Puede consultar los datos de New Relic para fines de resolución de problemas o para crear gráficos y paneles personalizados.
Datos métricos
Se crean dos entidades: IBMMQ_MANAGER y IBMMQ_QUEUE.
Las siguientes dimensiones métricas se capturan raspando el exportador y se vinculan a la entidad IBMMQ_MANAGER:
Nombre | Descripción | Dimensiones |
|---|---|---|
| Buffers rcvd |
|
| Búfers enviados |
|
| Bytes registrados |
|
| Bytes enviados |
|
| Tipo de canal de instancia |
|
| Mensajes (API llamamada para SVRCONN) |
|
|
| |
| Estado del canal: simplificado |
|
| Subestado del canal |
|
| Tiempo desde el mensaje |
|
| Tipo de canal |
|
| Modificar el recuento de suscripciones duraderas |
|
| Estado del iniciador del canal |
|
| Estado del servidor de comandos |
|
| Recuento de confirmaciones |
|
| Conexiones simultáneas: marca de límite superior |
|
| Conteo de conexiones |
|
| Carga de CPU: promedio de quince minutos |
|
| Carga de CPU: promedio de cinco minutos |
|
| Carga de CPU: promedio de un minuto |
|
| Crear un recuento de suscripciones duradero |
|
| Crear recuento de suscripción no duradero |
|
| Eliminar el recuento de suscripciones duraderas |
|
| Eliminar el recuento de suscripciones no duraderas |
|
| Suscriptor duradero: marca de límite superior |
|
| Suscriptor duradero: marca de límite inferior |
|
| Recuento de mensajes caducados |
|
| ¿Cuántas publicaciones de recursos procesadas? |
|
| Recuento de navegación fallido |
|
| Error al crear/alterar/reanudar el recuento de suscripciones |
|
| Recuento MQCB fallido |
|
| Recuento MQCLOSE fallido |
|
| Recuento fallido de MQCONN/MQCONNX |
|
| MQGET fallido: recuento |
|
| Recuento MQINQ fallido |
|
| Recuento MQOPEN fallido |
|
| Recuento MQPUT fallido |
|
| Recuento MQPUT1 fallido |
|
| Recuento de MQSET fallido |
|
| Recuento MQSUBRQ fallido |
|
| Recuento de temas MQPUT/MQPUT1 fallidos |
|
| Recibí mensajes no persistentes: recuento de bytes |
|
| Recibí mensajes persistentes: recuento de bytes |
|
| Intervalo de obtención destructiva total: recuento de bytes |
|
| Intervalo de conteo destructivo total |
|
| Recuento total de bytes de MQPUT/MQPUT1 del intervalo |
|
| Recuento total de MQPUT/MQPUT1 del intervalo |
|
| Intervalo total de bytes de tema transferidos |
|
| Log : espacio principal actual en uso |
|
| Archivo de registro del sistema - bytes en uso |
|
| Archivo de registro del sistema - bytes max |
|
| Log - bytes en uso |
|
| Log - bytes lógicos escritos |
|
| Log - bytes máx. |
|
| Log - bytes físicos escritos |
|
| Log - carga de trabajo utilización del espacio primario |
|
| Log - escribir latencia |
|
| Log - tamaño de escritura |
|
| Sistema de archivos de errores MQ - espacio libre |
|
| Sistema de archivos de errores MQ: bytes en uso |
|
| Recuento de archivos MQ FDC |
|
| Sistema de archivos MQ traza - espacio libre |
|
| Sistema de archivos MQ traza - bytes en uso |
|
| Recuento de MQCB |
|
| Recuento de MQCLOSE |
|
| Recuento de MQCONN/MQCONNX |
|
| Recuento de MQCTL |
|
| Recuento MQDISC |
|
| Recuento de MQINQ |
|
| Recuento de MQOPEN |
|
| Recuento de MQSET |
|
| Recuento MQSTAT |
|
| Recuento de MQSUBRQ |
|
| Suscriptor no duradero: marca de límite superior |
|
| Suscriptor no duradero: marca de límite inferior |
|
| Exploración de mensajes no persistentes: recuento de bytes |
|
| Exploración de mensajes no persistentes: recuento |
|
| Obtener - recuento destructivo de mensajes no persistentes |
|
| Recuento de MQPUT de mensajes no persistentes |
|
| Recuento de MQPUT1 de mensajes no persistentes |
|
| No persistente: recuento de temas MQPUT/MQPUT1 |
|
| Exploración de mensajes persistentes: recuento de bytes |
|
| Exploración de mensajes persistentes: recuento |
|
| Mensaje persistente destructivo get - count |
|
| Recuento de MQPUT de mensajes persistentes |
|
| Recuento de mensajes persistentes MQPUT1 |
|
| Persistente: recuento de temas MQPUT/MQPUT1 |
|
| Publicado para suscriptores: recuento de bytes |
|
| Publicado para suscriptores: recuento de mensajes |
|
| Recuento de colas purgadas |
|
| Poner mensajes no persistentes: recuento de bytes |
|
| Poner mensajes persistentes: recuento de bytes |
|
| Sistema de archivos del Administrador de colas: espacio libre |
|
| Sistema de archivos del Administrador de colas: bytes en uso |
|
| Porcentaje libre de RAM |
|
| Bytes totales de RAM |
|
| Bytes totales de RAM: estimación para el administrador de colas |
|
| Reanudar el recuento de suscripciones duraderas |
|
| Recuento de reversiones |
|
| Estado del administrador de colas |
|
| Recuento de errores de eliminación de suscripción |
|
| Tiempo de CPU del sistema: porcentaje estimado para el administrador de colas |
|
| Porcentaje de tiempo de CPU del sistema |
|
| Tema Total del intervalo MQPUT/MQPUT1 |
|
| Tiempo de actividad |
|
| Tiempo de CPU del usuario: porcentaje estimado para el administrador de colas |
|
| Porcentaje de tiempo de CPU del usuario |
|
| Mensajes recibidos |
|
| Tiempo desde que se recibió el mensaje |
|
| Tipo de suscripción |
|
| Mensajes recibidos |
|
| Número de editores |
|
| Número de suscriptores |
|
| Tiempo desde el mensaje |
|
Las siguientes dimensiones métricas se capturan raspando el exportador y se vinculan a la entidad IBMMQ_QUEUE:
Nombre | Descripción | Dimensiones |
|---|---|---|
| Profundidad máxima de la cola |
|
| Uso de cola |
|
| tiempo promedio de cola |
|
| bytes evitados en cola |
|
| cola evitada pone |
|
| Profundidad de la cola |
|
| MQGET destructivo falla |
|
| MQGET destructivo falla con MQRC_NO_MSG_AVAILABLE |
|
| MQGET destructivo falla con MQRC_TRUNCATED_MSG_FAILED |
|
| recuento de bytes no persistentes de MQGET destructivo |
|
| recuento de mensajes no persistentes MQGET destructivos |
|
| recuento de bytes persistente destructivo MQGET |
|
| recuento destructivo de mensajes persistentes MQGET |
|
| mensajes caducados |
|
| Controladores de entrada |
|
| contención de bloqueo |
|
| Recuento de MQCLOSE |
|
| La exploración MQGET falla |
|
| La exploración MQGET falla con MQRC_NO_MSG_AVAILABLE |
|
| La exploración MQGET falla con MQRC_TRUNCATED_MSG_FAILED |
|
| MQGET explora el recuento de bytes no persistentes |
|
| MQGET explora el recuento de mensajes no persistentes |
|
| MQGET explora el recuento de bytes persistentes |
|
| MQGET explora el recuento de mensajes persistentes |
|
| Recuento de bytes MQGET |
|
| Recuento de MQGET |
|
| Recuento de MQINQ |
|
| Recuento de MQOPEN |
|
| Recuento de bytes MQPUT |
|
| Recuento de MQPUT/MQPUT1 |
|
| Recuento de mensajes no persistentes MQPUT |
|
| Recuento de mensajes persistentes MQPUT |
|
| Recuento de mensajes no persistentes MQPUT1 |
|
| Recuento de mensajes persistentes MQPUT1 |
|
| Recuento de MQSET |
|
| recuento de bytes no persistente |
|
| Mensaje más antiguo |
|
| Controladores de entrada |
|
| recuento de bytes persistente |
|
| recuento de cola purgada |
|
| Tamaño actual del archivo de cola |
|
| Tamaño máximo del archivo de cola |
|
| Tiempo de cola largo |
|
| Tiempo de cola corto |
|
| revertir el recuento de MQGET |
|
| revertir el recuento de MQPUT |
|
| Tiempo desde que se obtuvo |
|
| Tiempo desde que se puso |
|
| Mensajes no confirmados (recuento) |
|
Comprueba el código fuente
Esta integración es software de código abierto. Esto significa que puedes explorar su código fuente y enviar mejoras, o crear tu propia bifurcación y compilarla.
Además, esta integración aprovecha un exportador de código abierto creado por la comunidad.