Te ofrecemos esta traducción automática para facilitar la lectura.
En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.
Referencia de métricas y atributos de IBM MQ OpenTelemetry
Esta referencia cubre las métricas y atributos de IBM MQ recopilados a través de OpenTelemetry: las métricas que el exportador mq-metric-samples publica y el recolector reenvía a New Relic. Se aplica tanto a los despliegues de host de Linux como de Kubernetes; la forma de la métrica es idéntica.
Recopilación de métricas
Todas las métricas mantienen la forma original de Prometheus que emite el exportador: nombres con guion bajo (ibmmq_*) y las etiquetas originales qmgr, queue y channel, además del atributo de identidad target.name y la etiqueta opcional cluster.name que adjunta el recolector. La síntesis de la entidad de IBM MQ de New Relic depende de esta forma, por lo que el recolector reenvía los nombres y las etiquetas sin cambios.
Importante
Habilite las estadísticas de MQI en cada gestor de colas, o las métricas de rendimiento y tiempo permanecerán vacías. El estado del gestor de colas, la profundidad de la cola y el estado del canal se informan sin configuración adicional, pero las métricas de actividad de MQI (las tablas de rendimiento de la cola y de actividad de MQI del gestor de colas — ibmmq_queue_mqput_count, ibmmq_queue_average_queue_time_seconds, etc.) requieren que la recopilación de estadísticas esté activada, lo cual está desactivado de forma predeterminada. Habilítelo una vez por gestor de colas con MQSC — por ejemplo ALTER QMGR STATMQI(ON) STATQ(ON), luego ALTER QLOCAL(...) STATQ(ON) para cualquier cola en la que desee estadísticas por cola (o confíe en el valor predeterminado STATQ del gestor de colas). Sin esto, el exportador está en buen estado y la entidad aparece, pero esos paneles se muestran en blanco. Consulte la documentación de mq-metric-samples para conocer las estadísticas exactas de las que depende cada métrica.
Sugerencia
Las métricas de estado informan valores enum numéricos, no 1/0 — consulte la referencia de códigos de estado a continuación antes de generar alertas sobre ellas. Los contadores son convertidos a temporalidad delta por el recolector, por lo tanto, use sum() / rate() en una ventana en lugar de latest() al graficarlos.
Las siguientes tablas agrupan las métricas de OpenTelemetry por área. Para listar cada métrica que realmente se reporta en su cuenta, ejecute:
FROM Metric SELECT uniques(metricName,2000)WHERE metricName LIKE'ibmmq_%' SINCE 1day ago
Métrica
Métrica
Descripción
ibmmq_qmgr_status
Estado de ejecución del gestor de colas (2 = en ejecución).
ibmmq_qmgr_command_server_status
Estado de ejecución del servidor de comandos (2 = en ejecución).
ibmmq_qmgr_channel_initiator_status
Estado de ejecución del iniciador de canal (el proceso del gestor de colas que inicia y administra los canales MQ) (2 = en ejecución).
ibmmq_qmgr_connection_count
Número actual de conexiones al gestor de colas.
ibmmq_qmgr_uptime
Tiempo de actividad del gestor de colas, en segundos.
ibmmq_qmgr_active_listeners
Número de listeners activos.
ibmmq_qmgr_active_services
Número de servicios activos.
ibmmq_qmgr_concurrent_connections_high_water_mark
Pico de conexiones concurrentes.
Métrica
Descripción
ibmmq_qmgr_cpu_load_one_minute_average_percentage
Promedio de carga de CPU de 1 minuto para el gestor de colas (también _five_ y _fifteen_minute_).
ibmmq_qmgr_user_cpu_time_percentage
Tiempo de CPU en el espacio de usuario consumido por el gestor de colas.
ibmmq_qmgr_system_cpu_time_percentage
Tiempo de CPU del sistema (kernel) consumido por el gestor de colas.
Espacio libre en el sistema de archivos del gestor de colas.
ibmmq_qmgr_mq_fdc_file_count
Número de archivos de volcado de diagnóstico de IBM MQ (FFST/FDC — escritos cuando el gestor de colas registra un error interno). Un recuento en aumento indica problemas que vale la pena investigar.
Métrica
Descripción
ibmmq_queue_depth
Número actual de mensajes en la cola.
ibmmq_queue_attribute_max_depth
Profundidad máxima de cola configurada.
ibmmq_queue_oldest_message_age
Edad del mensaje más antiguo en la cola, en segundos.
ibmmq_queue_uncommitted_messages
Número de mensajes no confirmados.
ibmmq_queue_time_since_put
Segundos desde el último MQPUT a la cola.
ibmmq_queue_time_since_get
Segundos desde el último MQGET de la cola.
ibmmq_queue_input_handles
Manejadores de entrada abiertos (consumidores) en la cola.
ibmmq_queue_output_handles
Manejadores de salida abiertos (productores) en la cola.
ibmmq_queue_browse_handles
Manejadores de exploración abiertos en la cola.
ibmmq_queue_publish_handles
Identificadores de publicación abiertos en la cola.
ibmmq_queue_qfile_current_size
Tamaño actual del archivo de cola en el disco.
ibmmq_queue_qfile_max_size
Tamaño máximo del archivo de cola en el disco.
Estos contadores rastrean las llamadas API de mensajes principales de IBM MQ por cola: MQPUT / MQPUT1 (poner un mensaje en una cola) y MQGET (obtener un mensaje de una cola). Requieren que las estadísticas de MQI estén habilitadas en el gestor de colas (consulte Recopilación de métricas).
Estado del canal simplificado con menos valores de enumeración (informativo; para alertas, use ibmmq_channel_status y la referencia de códigos de estado).
Estos contadores a nivel del gestor de colas resumen la actividad y las fallas de la API en todos los objetos — útiles para detectar errores de la aplicación y la rotación de transacciones. Requieren que las estadísticas de MQI estén habilitadas (consulte Recopilación de métricas).
Métrica
Descripción
ibmmq_qmgr_interval_mqput_mqput1_total_count
Total de MQPUT + MQPUT1 llamadas en el intervalo.
ibmmq_qmgr_interval_destructive_get_total_count
Total de llamadas destructivas MQGET en el intervalo.
ibmmq_qmgr_published_to_subscribers_message_count
Mensajes publicados para los suscriptores (rendimiento de publicación/suscripción).
Las métricas de estado de IBM MQ informan valores enum numéricos, no1/0 — y el valor saludable ("running") difiere según la métrica (2 para el estado a nivel del gestor de colas, 3 para el estado del canal). Genere una alerta sobre la desigualdad con el valor en ejecución (por ejemplo, ibmmq_qmgr_status != 2):
Métrica
Valor saludable
Significado
ibmmq_qmgr_status
2
El gestor de colas está en ejecución
ibmmq_qmgr_command_server_status
2
El servidor de comandos se está ejecutando
ibmmq_qmgr_channel_initiator_status
2
El iniciador de canal se está ejecutando
ibmmq_channel_status
3
El canal está en ejecución
Cualquier otro valor (o un punto de datos faltante) significa que el componente no está en su estado de ejecución.
Atributos de recursos
El recolector agrega atributos de identidad y contexto a cada métrica de IBM MQ. Algunos son comunes a todos los despliegues; otros dependen de si el recolector se ejecuta en un host de Linux o en Kubernetes.
Atributo
Descripción
Ejemplo
target.name
Atributo de identidad estable — el primer segmento de cada GUID de entidad de IBM MQ. Inyectado como la etiqueta de extracción targetName, luego renombrado a target.name por el recolector.
prod-mq-01, prod-mq-cluster
qmgr
Nombre del gestor de colas (etiqueta del exportador sin procesar; la síntesis de la entidad lo usa como clave).
QM1
queue
Nombre de la cola (en métricas a nivel de cola).
APP.ORDERS.IN
channel
Nombre del canal (en métricas a nivel de canal).
APP.SVRCONN
cluster.name
Etiqueta de agrupación opcional para gestores de colas en el mismo clúster de MQ. No forma parte del GUID de la entidad; es seguro dejarlo sin configurar o cambiarlo más adelante.
prod-mq
instrumentation.provider
Siempre es opentelemetry para esta integración; utilícelo para limitar las consultas a la ruta de OpenTelemetry.
opentelemetry
Atributo
Descripción
Ejemplo
host.id
Identificador del host que ejecuta el recolector, del procesador resourcedetection (detectores system / ec2). Vincula el gestor de colas a su entidad de host subyacente.
i-1234567890abcdef0
Atributo
Descripción
Ejemplo
k8s_namespace
Namespace del pod exportador descubierto, sellado por las reglas de reetiquetado del recolector.
ibmmq
k8s_pod
Nombre del pod exportador descubierto.
qm1-0
host.id
Identificador del nodo que ejecuta el pod, de resourcedetection.
ip-10-0-1-23
Detalles de la recopilación de métricas
Frecuencia de recopilación
Intervalo predeterminado: 60 segundos (scrape_interval del recolector). Debe ser mayor o igual que el propio pollInterval del exportador mq-metric-samples.
Configurable: ajuste IBMMQ_SCRAPE_INTERVAL (Linux) o scrape_interval en el values.yaml de Helm (Kubernetes).
Fuente de datos
Todas las métricas provienen del exportador mq-metric-samples, que sondea cada administrador de colas a través de PCF y vuelve a publicar las estadísticas como métricas de Prometheus en un extremo HTTP /metrics. El receptor prometheus del recolector extrae ese extremo.
Tipos métricos
Medidores —valores en un momento dado como ibmmq_qmgr_status, ibmmq_queue_depth y ibmmq_channel_status. Grafique con latest().
Contadores —totales acumulados como ibmmq_queue_mqput_count. El procesador cumulativetodelta del recolector los convierte a temporalidad delta, así que grafique con sum() o rate() en lugar de latest().