Configuración de IBM Integration Bus para la habilitación de datos

Para que algunos datos estén disponibles en la Consola de Cloud APM, debe configurar IBM® Integration Bus para habilitar la recopilación de datos necesaria.

Antes de empezar

Asegúrese de que el Agente de IBM Integration Bus esté configurado.

Recuerde: la habilitación del rastreo de transacciones exige el reinicio del nodo de integración (intermediario).

Acerca de esta tarea

El Agente de IBM Integration Bus sólo puede supervisar estadísticas de archivado y de recursos después de habilitar la recopilación de datos para el nodo de integración (intermediario). Del mismo modo, si desea visualizar el rastreo de transacciones en los paneles de instrumentos de middleware y topología, debe habilitar el rastreo de transacciones dentro del nodo de integración (intermediario) antes de habilitar el rastreo de transacciones para el Agente de IBM Integration Bus..

Decida qué tipo de datos debe supervisar con el Agente de IBM Integration Bus y siga estos pasos según sus necesidades.

Los servidores de integración que son propiedad del nodo de integración tienen un archivo de configuración server.conf.yaml predeterminado para cada servidor de integración que se almacena en un subdirectorio del directorio de nodo de integración. Las propiedades que establezca para el nodo de integración en el archivo node.conf.yaml son heredadas por los servidores de integración de los que es propietario. Sin embargo, puede cambiar las propiedades de un servidor de integración modificándolas en su archivo server.conf.yaml. (Para obtener más información, consulte Configuración de un nodo de integración modificando el archivo node.conf.yaml en la documentación de IBM App Connect Enterprise).

Procedimiento

Para habilitar la recopilación de datos de estadísticas de archivado para el nodo de integración (intermediario), consulte Habilitación de la recopilación de datos de estadísticas y contabilidad de archivado.
Para habilitar la recopilación de datos de estadísticas de recursos para un nodo de integración (intermediario), consulte Estadísticas de estadísticas de recursos de JVM.
Para habilitar el rastreo de transacciones para los flujos de mensajes dentro del nodo de integración (intermediario), consulte Habilitación del rastreo de transacciones.
Si ya no desea datos de rastreo de transacciones, recuerde que debe inhabilitar el rastreo de transacciones para el nodo de integración (intermediario) en el que se ha habilitado. Consulte Inhabilitación del rastreo de transacciones.

Habilitación de la recopilación de datos de estadísticas y contabilidad de archivado

Acerca de esta tarea

Para habilitar la recopilación de estadísticas y contabilidad de archivados para flujos de mensajes que pertenecen al nodo de integración (intermediario), emita el mandato mqsichangeflowstats desde el directorio bin del directorio de instalación del nodo de integración (intermediario) .

Recuerde: emita el mandato mqsichangeflowstats para el nodo de integración (intermediario) de acuerdo con sus requisitos para la supervisión de datos. Se recomienda que habilite solo las estadísticas que necesita, porque puede haber una gran cantidad de datos y proceso cuando se tienen muchos flujos de mensajes. Si desea información más detallada sobre el mandato mqsichangeflowstats, consulte la documentación de IBM Integration Bus.

Importante: IBM Cloud Application Performance Management no soporta los datos estadísticos y de contabilidad de instantáneas debido a la cantidad de datos y el proceso necesarios para el intervalo de instantánea establecido en 20 segundos. Los datos de archivado proporcionan los mismos atributos exactos que datos de instantánea, y son más aptos para la supervisión de producción regular proporcionada por IBM Cloud Application Performance Management. Si ha habilitado la recopilación de datos de instantánea para el nodo de integración (intermediario), recuerde configurar Agente de IBM Integration Bus para no almacenar los datos de instantánea. Si desea más instrucciones, consulte Inhabilitación de la recopilación de datos de instantánea para el agente.

Procedimiento

Para obtener la mayoría de datos de los flujos de mensajes, emita el mandato siguiente. Este mandato es aconsejable porque no habilita las estadísticas de terminal más detalladas que proporcionan recuentos de invocaciones por terminal y por nodo. El nivel de terminal consume una gran cantidad de almacenamiento.
```
mqsichangeflowstats
nombre_intermediario
-a
-g -j -c active -t none -n basic -o xml
```

En ACE versión 11, para obtener la mayoría de los datos para flujos de mensajes, modifique el archivo node.conf.yaml o server.conf.yaml como se indica a continuación. Estas propiedades se recomiendan porque no habilitan las estadísticas de terminal más detalladas que proporcionan recuentos de invocación por terminal y por nodo. El nivel de terminal consume una gran cantidad de almacenamiento.

Estadísticas:
  # Los flujos de mensajes de aplicación heredarán de forma predeterminada los valores de Instantánea y Archivador
  # establecidos aquí
  Instantánea:
    #publicationOn: 'inactive' # elija 1 de : active|inactive, valor predeterminado inactive
                               # Asegúrese de que Events.OperationalEvents.MQ|MQTT
                               # se ha establecido para outputFormat json,xml
    #accountingOrigin: 'none'  # elija 1 de : none|basic
    #nodeDataLevel: 'none'     # elija 1 de : none|basic|advanced
    #outputFormat: 'usertrace' # lista separada por comas de:
                               #csv,bluemix,json,xml,usertrace
    #threadDataLevel: 'none'   # elija 1 de : none|basic
  Archivador:
    archivalOn: 'active'     # elija 1 de : active|inactive,
                             # valor predeterminado inactive
                               # Asegúrese de que Events.OperationalEvents.MQ|MQTT
                               # se ha establecido para formato de salida xml
    #accountingOrigin: 'none'  # elija 1 de : none|basic
    #majorInterval: 60         # Establece el intervalo en minutos con el que
                               # se publican las estadísticas de archivado
    nodeDataLevel: 'basic'         # elija 1 de : none|basic|advanced
    outputFormat: 'xml' # lista separada por comas de : csv,xml,usertrace
    #threadDataLevel: 'none'   # elija 1 de : none|basic

Nota: Si desea inhabilitar este valor, comente las líneas de archivalOn: 'active', nodeDataLevel: 'basic' y outputFormat: 'xml'.

Para obtener todos los datos soportados por el Agente de IBM Integration Bus, emita el mandato siguiente:
```
mqsichangeflowstats
nombre_intermediario -a -g -j -c active -t
none -n
advanced -o xml
```

En ACE versión 11, para obtener todos los datos soportados por el Agente de IBM Integration Bus, modifique el archivo node.conf.yaml o server.conf.yaml como se indica a continuación:

Estadísticas:
  # Los flujos de mensajes de aplicación heredarán de forma predeterminada los valores de Instantánea y Archivador
  # establecidos aquí
  Instantánea:
    #publicationOn: 'inactive' # elija 1 de : active|inactive, valor predeterminado inactive
                               # Asegúrese de que Events.OperationalEvents.MQ|MQTT
                               # se ha establecido para outputFormat json,xml
    #accountingOrigin: 'none'  # elija 1 de : none|basic
    #nodeDataLevel: 'none'     # elija 1 de : none|basic|advanced
    #outputFormat: 'usertrace' # lista separada por comas de:
                               # csv,bluemix,json,xml,usertrace
    #threadDataLevel: 'none'   # elija 1 de : none|basic
  Archivador:
    archivalOn: 'active'    # elija 1 de : active|inactive, valor predeterminado inactive
                               # Asegúrese de que Events.OperationalEvents.MQ|MQTT
                               # se ha establecido para formato de salida xml
    #accountingOrigin: 'none'  # elija 1 de : none|basic
    #majorInterval: 60         # Establece el intervalo en minutos con el que
                               # se publican las estadísticas de archivado
    nodeDataLevel: 'advanced'         # elija 1 de : none|basic|advanced
    outputFormat: 'xml' # lista separada por comas de : csv,xml,usertrace
    #threadDataLevel: 'none'   # elija 1 de : none|basic

Nota: Si desea inhabilitar este valor, comente las líneas de archivalOn: 'active', nodeDataLevel: 'advanced' y outputFormat: 'xml'.

Para reducir la cantidad de datos pero seguir supervisando de forma razonable todos los flujos de mensajes sin más detalles, emita el mandato siguiente:
```
mqsichangeflowstats
nombre_intermediario
-a -g
-j -c active -t none -n none -o xml
```

En ACE versión 11, para reducir la cantidad de datos pero seguir supervisando de forma razonable todos los flujos de mensajes sin más detalles, modifique el archivo node.conf.yaml o server.conf.yaml del siguiente modo:

Estadísticas:
  # Los flujos de mensajes de aplicación heredarán de forma predeterminada los valores de Instantánea y Archivador
  #establecidos aquí
  Instantánea:
    #publicationOn: 'inactive' # elija 1 de : active|inactive, valor predeterminado inactive
                               # Asegúrese de que Events.OperationalEvents.MQ|MQTT
                               # se ha establecido para outputFormat json,xml
    #accountingOrigin: 'none'  # elija 1 de : none|basic
    #nodeDataLevel: 'none'     # elija 1 de : none|basic|advanced
    #outputFormat: 'usertrace' # lista separada por comas de:
                               # csv,bluemix,json,xml,usertrace
    #threadDataLevel: 'none'   # elija 1 de : none|basic
  Archivador:
    archivalOn: 'active'    # elija 1 de : active|inactive, valor predeterminado inactive
                               # Asegúrese de que Events.OperationalEvents.MQ|MQTT
                               # se ha establecido para formato de salida xml
    #accountingOrigin: 'none'  # elija 1 de : none|basic
    #majorInterval: 60         # Establece el intervalo en minutos con el que
                               # se publican las estadísticas de archivado
    nodeDataLevel: 'none'         # elija 1 de : none|basic|advanced
    outputFormat: 'xml' # lista separada por comas de : csv,xml,usertrace
    #threadDataLevel: 'none'   # elija 1 de : none|basic

Nota: Si desea inhabilitar este valor, comente las líneas de archivalOn: 'active', nodeDataLevel: 'none' y outputFormat: 'xml'.

Si tiene una gran cantidad de flujos de mensajes y desea reducir la cantidad de datos, puede especificar qué flujos de mensajes supervisar sustituyendo la opción -g o -j en los mandatos indicados.
- Para especificar un servidor de integración concreto (grupo de ejecución) para la habilitación, sustituya -g con -e nombre_servidor_integración.
- Para identificar un flujo de mensajes concreto para la habilitación, sustituya -j con -f nombre_flujo_mensajes.
- Si ha agrupado los flujos de mensajes en aplicaciones, para especificar una aplicación concreta para la habilitación, añada -k nombre_aplicación a la opción -j.
El Agente de IBM Integration Bus recopila datos de estadísticas y de contabilidad de archivado a intervalos de 5 minutos. Para establecer el intervalo con el que el nodo de integración (intermediario) genera los datos de estadísticas y contabilidad de archivado en el mismo intervalo, emita el mandato siguiente con el nodo de integración (intermediario) detenido y, después, reinícielo:
```
mqsichangebroker
nombre_intermediario -v
5
```

En ACE versión 11, el Agente de IBM Integration Bus recopila datos de estadísticas y contabilidad de archivado a intervalos de 5 minutos. Para establecer el intervalo con el que el nodo de integración (intermediario) genera los datos de estadísticas y contabilidad de archivado en el mismo intervalo, modifique el archivo node.conf.yaml o server.conf.yaml del siguiente modo:

Estadísticas:
  # Los flujos de mensajes de aplicación heredarán de forma predeterminada los valores de Instantánea y Archivador
  # establecidos aquí
  Instantánea:
    #publicationOn: 'inactive' # elija 1 de : active|inactive, valor predeterminado inactive
                               # Asegúrese de que Events.OperationalEvents.MQ|MQTT
                               # se ha establecido para outputFormat json,xml
    #accountingOrigin: 'none'  # elija 1 de : none|basic
    #nodeDataLevel: 'none'     # elija 1 de : none|basic|advanced
    #outputFormat: 'usertrace' # lista separada por comas de:
                               # csv,bluemix,json,xml,usertrace
    #threadDataLevel: 'none'   # elija 1 de : none|basic
  Archivador:
    archivalOn: 'active'       # elija 1 de : active|inactive, valor predeterminado inactive
                               # Asegúrese de que Events.OperationalEvents.MQ|MQTT
                               # se ha establecido para formato de salida xml
    #accountingOrigin: 'none'  # elija 1 de : none|basic
    majorInterval: 5         # Establece el intervalo en minutos a los
                               # se publican las estadísticas de archivado
    nodeDataLevel: 'none'      # elija 1 de : none|basic|advanced
    outputFormat: 'xml' # lista separada por comas de : csv,xml,usertrace
    #threadDataLevel: 'none'   # elija 1 de : none|basic

Resultados

Una vez configurado e iniciado el Agente de IBM Integration Bus, la contabilidad de flujo de mensajes y los estadísticos se visualizan en los siguientes widgets de grupo:

Panel de instrumentos de flujo de mensaje
- Confirmaciones y restituciones
- Microsegundos de CPU
- Microsegundos transcurridos
- Velocidad de bytes de entrada
- Velocidad de mensajes de entrada
- Tamaño de mensaje de entrada
- Microsegundos de CPU de espera de mensajes de entrada
- Microsegundos transcurridos de espera de mensajes de entrada
- Errores de flujo de mensajes
- Estadísticas de nodos de proceso de mensajes
Panel de instrumentos del nodo de proceso
- Microsegundos de CPU
- Microsegundos transcurridos
- Invocaciones
- Estado de nodo de proceso
- Estadísticas de terminal

Estadísticas de estadísticas de recursos de JVM

Acerca de esta tarea

Para habilitar las estadísticas de recursos de JVM para los servidores de integración que pertenecen al nodo de integración (intermediario), emita el mandato mqsichangeresourcestats desde el directorio bin del directorio de instalación del nodo de integración (intermediario) .

Recuerde: las estadísticas de recursos de JVM se consideran opcionales porque solo se muestran unos pocos atributos de datos para el coste alto del agente que procesa estos datos cada 20 segundos. Asegúrese de que tiene en cuenta si realmente necesita los datos estadísticos de recurso de la JVM.

Procedimiento

Para habilitar las estadísticas en todos los servidores de integración del nodo de integración (intermediario), emita el mandato siguiente:
```
mqsichangeresourcestats
nombre_intermediario -c active
```

En ACE versión 11, para habilitar las estadísticas en todos los servidores de integración del nodo de integración (intermediario), modifique el archivo node.conf.yaml como se indica a continuación:

Estadísticas:
  # Los flujos de mensajes de aplicación heredarán de forma predeterminada los valores de Instantánea y Archivador
  # establecidos aquí
  Instantánea:
    #publicationOn: 'inactive' # elija 1 de : active|inactive, valor predeterminado inactive
                               # Asegúrese de que Events.OperationalEvents.MQ|MQTT
                               # se ha establecido para outputFormat json,xml
    #accountingOrigin: 'none'  # elija 1 de : none|basic
    #nodeDataLevel: 'none'     # elija 1 de : none|basic|advanced
    #outputFormat: 'usertrace' # lista separada por comas de:
                               # csv,bluemix,json,xml,usertrace
    #threadDataLevel: 'none'   # elija 1 de : none|basic
  Archivador:
    archivalOn: 'active'       # elija 1 de : active|inactive, valor predeterminado inactive
                               # Asegúrese de que Events.OperationalEvents.MQ|MQTT
                               # se ha establecido para formato de salida xml
    #accountingOrigin: 'none'  # elija 1 de : none|basic
    majorInterval: 5         # Establece el intervalo en minutos con el que
                             # se publican las estadísticas de archivado
    nodeDataLevel: 'advanced'     # elija 1 de : none|basic|advanced
    outputFormat: 'xml' # lista separada por comas de : csv,xml,usertrace
    threadDataLevel: 'basic'      # elija 1 de : none|basic
   Recurso:
     reportingOn: true       # elija 1 de : true|false, valor predeterminado false
......

Nota: Si desea inhabilitar este valor, comente reportingOn: true.

Para habilitar las estadísticas para un servidor de integración determinado en el nodo de integración (intermediario), emita el mandato siguiente>
```
mqsichangeresourcestats
nombre_intermediario -e
nombre_servidor_integración -c
active
```

En ACE versión 11, para habilitar las estadísticas de un servidor de integración determinado en el nodo de integración (intermediario), modifique el archivo server.conf.yaml como se indica a continuación:

Estadísticas:
  # Los flujos de mensajes de aplicación heredarán de forma predeterminada los valores de Instantánea y Archivador
  # establecidos aquí
  Instantánea:
    #publicationOn: 'inactive' # elija 1 de : active|inactive, valor predeterminado inactive
                               # Asegúrese de que Events.OperationalEvents.MQ|MQTT
                               # se ha establecido para outputFormat json,xml
    #accountingOrigin: 'none'  # elija 1 de : none|basic
    #nodeDataLevel: 'none'     # elija 1 de : none|basic|advanced
    #outputFormat: 'usertrace' # lista separada por comas de:
                               # csv,bluemix,json,xml,usertrace
    #threadDataLevel: 'none'   # elija 1 de : none|basic
  Archivador:
    archivalOn: 'active'       # elija 1 de : active|inactive, valor predeterminado inactive
                               # Asegúrese de que Events.OperationalEvents.MQ|MQTT
                               # se ha establecido para formato de salida xml
    #accountingOrigin: 'none'  # elija 1 de : none|basic
    majorInterval: 5           # Establece el intervalo en minutos con el que
                               # se publican las estadísticas de archivado
    nodeDataLevel: 'advanced'  # elija 1 de : none|basic|advanced
    outputFormat: 'xml' # lista separada por comas de : csv,xml,usertrace
    threadDataLevel: 'basic'      # elija 1 de : none|basic
  Recurso:
    reportingOn: true       # elija 1 de : true|false, valor predeterminado false

Nota: Si desea inhabilitar este valor, comente reportingOn: true.

Resultados

Los datos estadísticos de recursos JVM se visualizan en los siguientes widgets de grupo:

Recuento de recogidas de basura
Duración de recogida de basura
Memoria no de almacenamiento dinámico de JVM
Memoria de almacenamiento dinámico de JVM

Habilitación del rastreo de transacciones

Antes de empezar

Asegúrese de que se haya instalado el Agente de IBM Integration Bus. Se incluye una salida de usuario llamada KQIUserExit para habilitar IBM Integration Bus para el rastreo de transacciones.
Asegúrese de que el usuario que iniciará el nodo de integración (intermediario) tiene acceso al directorio de módulo de la salida de usuario de KQI. Es decir, asegúrese de añadir el ID de usuario que ha utilizado para iniciar el nodo de integración (intermediario) al grupo en el que ha instalado Agente de IBM Integration Bus.

Acerca de esta tarea

Debe desplegar la salida de usuario KQIUserExit en el nodo de integración (intermediario). De lo contrario, no habrá ningún dato disponible en el middleware ni en los paneles de instrumentos de topología incluso después de haber habilitado Agente de IBM Integration Bus para el rastreo de transacciones.

Consejo: La salida de usuario KQIUserExit incluye los nodos de IBM Integration Bus siguientes en los paneles de instrumentos de middleware y de topología como servicios no instrumentados:

Nodos de cálculo y de base de datos donde se especifica un origen de datos ODBC
Nodos TCP/IP
Nodos de archivo para servidores FTP o FTPS remotos
Nodos MQ, a no ser que ya estén instrumentados

Procedimiento

Para habilitar el rastreo de transacciones para IBM Integration Bus, complete los pasos siguientes:

Cierre los shell de intermediario que hayan cargado el entorno de MQSI.
Abra una consola de mandatos de IBM Integration Bus con uno de los métodos siguientes. Si tiene instaladas varias versiones de nodos de integración (intermediarios), asegúrese de iniciar la consola de mandatos para la versión correcta.
- Pulse Inicio > IBM Integration Bus > IBM Integration Console
- En el directorio bin del directorio de instalación del nodo de integración (intermediario), emita el mandato mqsiprofile.
Detenga el nodo de integración (intermediario) que desea configurar con el mandato mqsistop.
Habilite el rastreo de transacciones para el flujo de mensajes dentro del nodo de integración (intermediario) añadiendo la salida de usuario KQIUserExit con el mandato mqsichangebroker.
- Para habilitar el rastreo de transacciones para todos los flujos de mensajes dentro del nodo de integración (intermediario), ejecute el mandato siguiente:
```
mqsichangebroker nombre_intermediario -e "KQIUserExit"
```
- Para habilitar el rastreo de transacciones para un flujo de mensajes específico dentro del nodo de integración (intermediario), ejecute el mandato siguiente:
```
mqsichangeflowuserexits
nombre_intermediario -e nombre_grupo_ejecución -k nombre_aplicación -f
nombre_flujo_mensajes -a "KQIUserExit"
```
Como alternativa, en Ace versión 11, habilite el rastreo de transacciones para el flujo de mensajes dentro del nodo de integración (intermediario) añadiendo KQIUserExit al archivo node.conf.yaml o server.conf.yaml.
```
UserExits:
activeUserExitList: 'KQIUserExit' # Especifique el nombre
# de una salida de usuario instalada para activarla.
```
Nota: Si desea inhabilitar el rastreo de transacciones, comente activeUserExitList: 'KQIUserExit'.
Reinicie el nodo de integración (intermediario) con el mandato mqsistart.

Inhabilitación del rastreo de transacciones

Procedimiento

Para inhabilitar el rastreo de transacciones para IBM Integration Bus, complete los pasos siguientes:

Abra una consola de mandatos de IBM Integration Bus con uno de los métodos siguientes. Si tiene instaladas varias versiones de nodos de integración (intermediarios), asegúrese de iniciar la consola de mandatos para la versión correcta.
- Pulse Inicio > IBM Integration Bus > IBM Integration Console
- En el directorio bin del directorio de instalación del nodo de integración (intermediario), emita el mandato mqsiprofile.
Inhabilite el rastreo de transacciones para el flujo de mensajes dentro de un nodo de integración (intermediario) con uno de los métodos siguientes:
- Para inhabilitar el rastreo de transacciones para un flujo de mensajes específico, utilice el mandato mqsichangeflowuserexits:
```
mqsichangeflowuserexits nombre_intermediario -e nombre_grupo_ejecución 
-f nombre_flujo_mensajes -a ""
```
- Para inhabilitar el rastreo de transacciones para todos los flujos de mensajes dentro del nodo de integración (intermediario), primero detenga el nodo de integración (intermediario) con el mandato mqsistop y luego emita el mandato mqsichangebroker:
```
mqsichangebroker nombre_intermediario -e ""
```

Qué hacer a continuación

Para el rastreo de transacciones, tras habilitar el rastreo de transacciones para IBM Integration Bus, también debe habilitar el rastreo de transacciones para el agente. Si desea más instrucciones, consulte Configuración del rastreo de transacciones para el Agente de IBM Integration Bus.
Si ha habilitado la recopilación de datos de instantánea para el nodo de integración (intermediario), configure el Agente de IBM Integration Bus para no almacenar los datos de instantánea. Cloud APM no soporta los datos estadísticos y de contabilidad de instantáneas debido a la cantidad de datos y el proceso necesarios para el intervalo de instantánea establecido en 20 segundos. Para obtener instrucciones, consulte Inhabilitación de la recopilación de datos de instantánea para el agente.