Monitorear IBM MQ autohospedado con OpenTelemetry

Instalar recolector NRDOT

Descargue e instale el paquete NRDOT para su distribución de Linux. Reemplace <NRDOT_VERSION> con la última etiqueta de versión de la página nrdot-collector-releases (por ejemplo, v0.12.0).

• Para Debian/Ubuntu:

  bash

  Copia

  $
  curl -LO https://github.com/newrelic/nrdot-collector-releases/releases/download/<NRDOT_VERSION>/nrdot-collector_<NRDOT_VERSION>_linux_amd64.deb
  $
  sudo dpkg -i nrdot-collector_<NRDOT_VERSION>_linux_amd64.deb

• Para RHEL/Rocky/Amazon Linux:

  bash

  Copia

  $
  curl -LO https://github.com/newrelic/nrdot-collector-releases/releases/download/<NRDOT_VERSION>/nrdot-collector_<NRDOT_VERSION>_linux_amd64.rpm
  $
  sudo dnf install ./nrdot-collector_<NRDOT_VERSION>_linux_amd64.rpm

Configurar el Colector NRDOT

Configure el Collector NRDOT para recopilar métricas de IBM MQ y enviarlas a New Relic. Esta configuración se encarga de tres tareas principales:

• Conectarse a sus administradores de colas
• Limpiar los datos
• Enviar los datos a New Relic

1. Para crear el directorio y el archivo de configuración del recolector con los permisos requeridos, ejecute:

   bash

   Copia

   $
   # Config directory — group-readable by nrdot only (it will hold secrets)
   $
   sudo install -d -o root -g nrdot -m 0750 /etc/nrdot-collector
   $
   
   $
   # Create the config file with correct permissions
   $
   sudo install -o root -g nrdot -m 0640 /dev/null /etc/nrdot-collector/ibmmq-config.yaml
   $
   sudo -u nrdot ${EDITOR:-vi} /etc/nrdot-collector/ibmmq-config.yaml

2. Pegue la siguiente configuración en el archivo de configuración creado, reemplazando los marcadores de posición con sus valores reales:

   extensions:
     health_check:
       endpoint: 127.0.0.1:13133
   
   processors:
   
     filter/ibmmq-overhead:
       metrics:
         exclude:
           match_type: regexp
           metric_names:
             - "^go_.*"
             - "^process_.*"
             - "^promhttp_.*"
             - "^scrape_.*"
   
     filter/ibmmq-queues:
       metrics:
         datapoint:
           - 'attributes["queue"] != nil and IsMatch(attributes["queue"], "^SYSTEM\\.(ADMIN\\.|MQSC\\.|DEFAULT\\.|AUTH\\.|CHANNEL\\.|CHLAUTH\\.|CICS\\.|SYNCPOINT\\.|INTERNAL\\.|PENDING\\.|PROTECTION\\.|BROKER\\.|AMQP\\.|DOTNET\\.|REST\\.|RETAINED\\.|SELECTION\\.|DURABLE\\.|HIERARCHY\\.|DDELAY\\.)")'
           - 'attributes["queue"] != nil and IsMatch(attributes["queue"], "^SYSTEM\\.CLUSTER\\.(COMMAND|HISTORY)\\.QUEUE$")'
           - 'attributes["queue"] != nil and IsMatch(attributes["queue"], "^AMQ\\.")'
   
     resourcedetection:
       detectors: [env, ec2, system]
       system:
         resource_attributes:
           host.name:
             enabled: true
           host.id:
             enabled: true
   
     transform/ibmmq-cleanup:
       metric_statements:
         - context: resource
           statements:
             - delete_key(attributes, "server.address")
             - delete_key(attributes, "server.port")
             - delete_key(attributes, "url.scheme")
         - context: datapoint
           statements:
             # Rename the injected identity labels to their OTel dotted form — the
             # names New Relic's IBM MQ entity synthesis keys on. qmgr / queue stay raw.
             - set(attributes["target.name"], attributes["targetName"]) where attributes["targetName"] != nil
             - delete_key(attributes, "targetName")
             - set(attributes["cluster.name"], attributes["clusterName"]) where attributes["clusterName"] != nil
             - delete_key(attributes, "clusterName")
             - delete_key(attributes, "instance")
             - delete_key(attributes, "job")
   
     memory_limiter/ibmmq:
       check_interval: 1s
       limit_mib: 512
       spike_limit_mib: 256
   
     cumulativetodelta/ibmmq: {}
   
     batch/ibmmq:
       send_batch_size: 1000
       timeout: 200ms
   
   exporters:
   
     otlphttp/ibmmq:
       endpoint: ${env:NEW_RELIC_OTLP_ENDPOINT}
       headers:
         api-key: ${env:NEW_RELIC_LICENSE_KEY}
   
   receivers:
   
     prometheus/ibmmq-qm1:
       config:
         scrape_configs:
           - job_name: 'ibmmq-qm1'
             scrape_interval: ${env:IBMMQ_SCRAPE_INTERVAL:-60s}
             scrape_timeout: 15s
             static_configs:
               - targets:
                   - "${env:IBMMQ_QM1_ENDPOINT:-localhost:9157}"
                 labels:
                   targetName: "${env:TARGET_NAME}"
                   clusterName: "${env:IBMMQ_CLUSTER_NAME:-}"
   
   service:
     pipelines:
       metrics/ibmmq-qm1:
         receivers: [prometheus/ibmmq-qm1]
         processors:
           - filter/ibmmq-overhead
           - filter/ibmmq-queues
           - resourcedetection
           - transform/ibmmq-cleanup
           - memory_limiter/ibmmq
           - cumulativetodelta/ibmmq
           - batch/ibmmq
         exporters: [otlphttp/ibmmq]
   
     extensions: [health_check]

   Copia

   Importante

   No reordenes ni elimines los procesadores. El orden de la cadena de procesadores es fundamental para la síntesis de entidades. El procesador transform/ibmmq-cleanup debe ejecutarse después del procesador resourcedetection. Invertir este orden hace que las métricas de IBM MQ se asocien con la propia entidad del recolector en lugar de con las entidades IBMMQ_MANAGER, lo que evita que los datos se muestren en los dashboards.

   Qué hace esta configuración

   Esta configuración crea un pipeline que recopila métricas de los gestores de colas de IBM MQ y enruta datos estructurados a New Relic. Cada componente realiza una función específica:

   Componente	Descripción
   health_check	Proporciona un extremo de estado en 127.0.0.1:13133 que devuelve {"status":"Server available"} para verificar que el recolector se está ejecutando y para solucionar problemas de inicio.
   prometheus/ibmmq-qm1	Se conecta al exportador para cada gestor de colas cada 60 segundos para recopilar métricas. Cada gestor de colas utiliza un receptor independiente; si un gestor de colas falla, los receptores restantes continúan operando normalmente. Para agregar más gestores de colas, consulte la sección Agregar otro gestor de colas.
   filter/ibmmq-overhead	Elimina las métricas internas del exportador (como go_* y process_*) que no contienen una señal de IBM MQ. Esto optimiza los costos de ingesta de datos al filtrar la telemetría innecesaria.
   filter/ibmmq-queues	Excluye las colas internas del sistema IBM MQ (SYSTEM.* y AMQ.*) para que solo las colas de la aplicación se conviertan en entidades IBMMQ_QUEUE. Esto reduce el recuento total de entidades y centra el monitoreo en los activos críticos.
   transform/ibmmq-cleanup	Este es un componente crítico que asigna las métricas a las entidades de IBM MQ correspondientes en New Relic. Sin este componente, los datos aparecen como métricas de recolector genéricas en lugar de sintetizar las entidades IBMMQ_MANAGER y IBMMQ_QUEUE con los dashboards y alertas asociados.
   memory_limiter/ibmmq	Limita el uso de memoria a 512 MB (con un margen para picos de 256 MB) para evitar que el recolector exceda los límites de recursos del sistema.
   batch/ibmmq	Agrupa las métricas antes de la transmisión para reducir la sobrecarga de la red empaquetando hasta 1000 puntos de datos por solicitud.
   otlphttp/ibmmq	Exporta las métricas procesadas a New Relic usando la clave de licencia configurada para la autenticación y el extremo regional designado.

   Cada gestor de colas utiliza un pipeline independiente para que un problema con una instancia no afecte a las demás. El orden de los procesadores es crítico, no reordene ni elimine procesadores, o las métricas no se asignarán correctamente a las entidades de IBM MQ.

Establezca las variables de entorno NRDOT

La configuración de su recolector utiliza variables de entorno para valores específicos del despliegue, como la clave de licencia de New Relic y los extremos del gestor de colas. Este enfoque mantiene los secretos separados de los archivos de configuración y facilita ajustar la configuración sin editar YAML.

1. Cree un archivo de entorno para el recolector NRDOT:

   bash

   Copia

   $
   # Owner nrdot, mode 0600 — this file holds the license key
   $
   sudo install -o nrdot -g nrdot -m 0600 /dev/null /etc/nrdot-collector/ibmmq-env
   $
   sudo -u nrdot ${EDITOR:-vi} /etc/nrdot-collector/ibmmq-env

2. Agregue su valor como líneas KEY=VALUE al archivo, reemplazando los marcadores de posición con sus valores reales:

   # /etc/nrdot-collector/ibmmq-env
   
   # --- Required ---
   
   # New Relic ingest license key (40 chars, suffix NRAL)
   NEW_RELIC_LICENSE_KEY=<YOUR-LICENSE-KEY>
   
   # Stable host identity — first segment of every IBMMQ entity GUID
   TARGET_NAME=<YOUR-HOSTNAME>
   
   # mq-metric-samples exporter endpoints, one per queue manager
   IBMMQ_QM1_ENDPOINT=localhost:9157
   
   # --- Optional (shown with defaults) ---
   
   # OTLP endpoint: US prod default shown; For more information, refer to [New Relic OTLP endpoint](https://docs.newrelic.com/docs/opentelemetry/best-practices/opentelemetry-otlp).
   NEW_RELIC_OTLP_ENDPOINT=https://otlp.nr-data.net:4318
   
   # Optional tag grouping for the IBMMQ_MANAGER entity (does not affect the entity GUID).
   # Leave unset to omit cluster.name (nullable); set it to group QMs under one cluster tag.
   # IBMMQ_CLUSTER_NAME=prod-mq-cluster
   
   # Scrape interval — must be >= the mq-metric-samples pollInterval (default 60s)
   IBMMQ_SCRAPE_INTERVAL=60s

   Copia

   Advertencia

   No cambie el valor TARGET_NAME después del despliegue inicial. Este valor forma el primer segmento del GUID de cada entidad IBMMQ_MANAGER y IBMMQ_QUEUE (target.name:qmgr). Cambiar este valor después del despliegue crea nuevas entidades y deja huérfanas las existentes, lo que rompe los dashboards y las alertas asociados. Seleccione una cadena estable durante la configuración inicial, como el QMID del Queue Manager. Para obtener más información, consulta El modelo de entidad de IBM MQ.

   Configure las siguientes variables de entorno en su shell para verificar la configuración antes de iniciar el recolector:

   Variable	Requerido	Descripción
   NEW_RELIC_LICENSE_KEY	Sí	Tu clave de licencia de ingesta de New Relic.
   TARGET_NAME	Sí	Un identificador para su host, como el nombre de host o el ID del gestor de colas. No cambie esto después del despliegue inicial, ya que se convierte en parte de los ID de su entidad.
   IBMMQ_QM1_ENDPOINT	Sí	Ubicación del exportador de su primer gestor de colas. Por ejemplo, localhost:9157 si se ejecuta en el mismo host.
   NEW_RELIC_OTLP_ENDPOINT	No	Extremo OTLP de New Relic para su región. Para obtener más información, consulte el extremo OTLP de New Relic.
   IBMMQ_CLUSTER_NAME	No	Nombre del Cluster para agrupar sus gestores de colas en New Relic.
   IBMMQ_SCRAPE_INTERVAL	No	Intervalo de recopilación para exportar métricas a New Relic. El intervalo de recopilación predeterminado es de 60 segundos.

Configure el servicio systemd de NRDOT

1. Cree un archivo drop-in de systemd para cargar los archivos de configuración y de entorno.

   bash

   Copia

   $
   sudo mkdir -p /etc/systemd/system/nrdot-collector.service.d
   $
   sudo tee /etc/systemd/system/nrdot-collector.service.d/ibmmq.conf > /dev/null << 'EOF'
   $
   [Service]
   $
   EnvironmentFile=/etc/nrdot-collector/ibmmq-env
   $
   ExecStart=
   $
   ExecStart=/usr/bin/nrdot-collector --config /etc/nrdot-collector/ibmmq-config.yaml
   $
   MemoryMax=1G
   $
   LimitNOFILE=65536
   $
   NoNewPrivileges=true
   $
   ProtectSystem=strict
   $
   ProtectHome=true
   $
   EOF

   La línea ExecStart= vacía borra el comando predeterminado y la segunda línea establece el comando personalizado. Esto evita que el recolector se inicie dos veces. Las otras configuraciones cargan el archivo de entorno, limitan el uso de memoria y mejoran la seguridad.

2. Después de crear el drop-in, verifique que systemd pueda analizarlo sin errores:

   bash

   Copia

   $
   sudo systemd-analyze verify /etc/systemd/system/nrdot-collector.service
   $
   # No output means no syntax errors

Inicia el recolector NRDOT y verifica

1. Inicie el recolector y habilítelo para que se ejecute automáticamente en el arranque:

   bash

   Copia

   $
   sudo systemctl daemon-reload
   $
   sudo systemctl enable --now nrdot-collector.service
   $
   sudo systemctl status nrdot-collector.service --no-pager

   El comando status debería mostrar Active: active (running). Si ve Active: failed, revise los logs con journalctl -u nrdot-collector.service -n 200 --no-pager.

2. Verifique que el recolector esté en buen estado:

   bash

   Copia

   $
   curl -sS http://127.0.0.1:13133
   $
   # Expected: {"status":"Server available", ...}

3. Confirme que sus métricas de IBM MQ fluyen hacia New Relic. Espere 60 segundos después de que se inicie el recolector, luego verifique sus datos usando las consultas de verificación en Buscar y consultar sus datos.

Ver tus datos en New Relic

Una vez que su recolector esté en ejecución y las métricas fluyan, verá sus gestores de colas como entidades IBMMQ_MANAGER en New Relic, con sus colas como entidades IBMMQ_QUEUE secundarias. Para obtener detalles sobre cómo buscar sus datos, ejecutar consultas y configurar dashboards y alertas, consulte Buscar y consultar sus datos.