Información general

Este check monitoriza IBM ACE a través del Datadog Agent.

Configuración

Sigue las instrucciones a continuación para instalar y configurar este check para un Agent que se ejecuta en un host. Para entornos contenedorizados, consulta las plantillas de integración de Autodiscovery para obtener orientación sobre la aplicación de estas instrucciones.

IBM MQ

Se necesita un servidor IBM MQ para consumir mensajes de métrica de IBM ACE.

IBM ACE

1. Asegúrate de que está instalada al menos la versión 12.0.2.0.
2. Aplica un archivo de política MQEndpoint cuyo nombre sea <MQ_POLICY_NAME>.policyxml y que tenga el siguiente aspecto:

   <?xml version="1.0" encoding="UTF-8"?>
   <policies>
       <policy policyType="MQEndpoint" policyName="<MQ_POLICY_NAME>" policyTemplate="MQEndpoint">
           <connection>CLIENT</connection>
           <destinationQueueManagerName>...</destinationQueueManagerName>
           <queueManagerHostname>...</queueManagerHostname>
           <listenerPortNumber>1414</listenerPortNumber>
           <channelName>...</channelName>
           <securityIdentity><MQ_SECURITY_IDENTITY></securityIdentity>
       </policy>
   </policies>
   

3. Establece las credenciales ejecutando: mqsisetdbparms -n mq::<MQ_SECURITY_IDENTITY> -u <user> -p <password>
4. Actualiza tu archivo server.conf.yaml con la siguiente configuración:

   remoteDefaultQueueManager: '{DefaultPolicies}:<MQ_POLICY_NAME>'
   Events:
     OperationalEvents:
       MQ:
         enabled: true
     BusinessEvents:
       MQ:
         enabled: true
         outputFormat: json
   Statistics:
     Resource:
       reportingOn: true
     Snapshot:
       publicationOn: active
       outputFormat: json
       accountingOrigin: basic
       nodeDataLevel: advanced
       threadDataLevel: basic
   Monitoring:
     MessageFlow:
       publicationOn: active
       eventFormat: MonitoringEventV2
   AdminLog:
     enabled: true
     fileLog: true
     consoleLog: true
     consoleLogFormat: ibmjson
   

5. Reinicia IBM ACE.

Instalación

El check de IBM ACE está incluido en el paquete del Datadog Agent. No es necesaria ninguna instalación adicional en tu servidor.

Configuración

1. Edita el archivo ibm_ace.d/conf.yaml, en la carpeta conf.d/ en la raíz del directorio de configuración de tu Agent para comenzar a recopilar tus datos de rendimiento ibm_ace. Consulta el ibm_ace.d/conf.yaml de ejemplo para ver todas las opciones disponibles de configuración.

2. Reinicia el Agent.

Validación

Ejecuta el subcomando de estado del Agent y busca ibm_ace en la sección Checks.

Datos recopilados

Métricas

Eventos

La integración de IBM ACE no incluye ningún evento.

Checks de servicio

Recopilación de logs

1. La recopilación de logs está desactivada por defecto en el Datadog Agent. Actívala en tu archivo datadog.yaml:

   logs_enabled: true
   

2. Para empezar a recopilar tus logs de IBM ACE, añade este bloque de configuración a tu archivo ibm_ace.d/conf.yaml:

   logs:
     - type: file
       path: /home/aceuser/ace-server/log/integration_server.txt
       source: ibm_ace
   

   Cambia el valor del parámetro path en función de tu entorno. Consulta el archivo de ejemplo ibm_ace.d/conf.yaml para ver todas las opciones disponibles de configuración.

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con el soporte de Datadog.