Información general

Con este check se monitoriza IBM ACE a través del Datadog Agent.

Configuración

Sigue las instrucciones siguientes para instalar y configurar este check para un Agent que se ejecute en un host. Para entornos en contenedores, 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étricas de IBM ACE.

IBM ACE

1. Asegúrate de que esté instalada al menos la versión 12.0.2.0.
2. Aplica una política de MQEndpoint con el siguiente nombre de archivo <MQ_POLICY_NAME>.policyxml que tendrá 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. Configura 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 de tu directorio de configuración del Agent para comenzar a recopilar tus datos de rendimiento de ibm_ace. Consulta el ejemplo de ibm_ace.d/conf.yaml para conocer todas las opciones de configuración disponibles.

2. Reinicia el Agent.

Validación

[Ejecuta el subcomando de estado del Agent(https://docs.datadoghq.com/agent/guide/agent-commands/#agent-status-and-information) 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

ibm_ace.mq.subscription

Devuelve CRITICAL si la suscripción encuentra un error, WARNING si no hay mensajes disponibles o OK en caso contrario.

Estados: ok, advertencia, crítico

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 de configuración disponibles.

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con asistencia técnica de Datadog.