Agentes de Jitterbit

Descripción general

Los agentes de Harmony de Jitterbit procesan las operaciones de tus proyectos de integración, y envían y reciben datos de endpoints. Hay dos tipos de agentes, cloud y privados:

• Cloud: Jitterbit gestiona los agentes cloud en su propia infraestructura cloud. No necesitas configurar nada.

• Privados: Debes configurar y gestionar los agentes privados en tu propia infraestructura cloud o física.

Todos los agentes son miembros de un grupo. Los grupos de agentes son conjuntos de agentes del mismo tipo (no se pueden mezclar agentes privados y cloud en un grupo). Los agentes en un grupo de agentes procesan las operaciones de tu proyecto de Studio o Design Studio. Los grupos proporcionan los siguientes beneficios:

• Enrutamiento inteligente: Para mejorar el rendimiento y la confiabilidad, las operaciones de un proyecto se envían para procesarse por un grupo de agentes en lugar de por agentes individuales. (Qué grupo de agentes utiliza un proyecto depende del entorno en el que se implemente el proyecto. La relación entre un entorno y su grupo de agentes se denomina asociación.) A menos que haya solo un agente en el grupo, no tienes control sobre qué agente procesará una operación; el sistema de enrutamiento inteligente decide qué agente usar.

  Este servicio de enrutamiento analiza los requisitos de los trabajos y los compara con las capacidades de los agentes individuales (que incluyen sus conectores, versiones y sistemas operativos). Del conjunto de agentes capaces, una estrategia de balanceo de carga distribuye la carga de trabajo, evitando cuellos de botella. Si un agente designado está ocupado o desconectado, el trabajo se enruta sin problemas a otro agente disponible en el grupo. Los trabajos se envían solo a agentes que están en línea y comunicándose activamente con Harmony. Si no hay agentes adecuados disponibles de inmediato, los trabajos se colocan automáticamente en una cola. El servicio luego envía el trabajo tan pronto como un agente apropiado esté disponible.

  Dado que estos mecanismos de balanceo de carga consideran las capacidades y recursos de los hosts al compartir trabajo, puedes aprovisionar hosts para que coincidan más estrechamente con las cargas características de los proyectos o entornos, evitando la tendencia a sobreaprovisionar y gastar en exceso en recursos.

• Alta disponibilidad: Si por alguna razón el estado de un agente se convierte en Detenido, el sistema cancela cualquier operación programada asignada a él y vuelve a ejecutar nuevas instancias de operación cuando el agente vuelve a estar activo. Si el agente es el único en un grupo, las operaciones de integración que usan ese grupo eventualmente agotan el tiempo de espera y fallan. Con múltiples agentes en un grupo, las operaciones programadas que se ejecutan en un agente Detenido se cancelan e inmediatamente se recrean en un agente activo. Esto asegura que tus proyectos continúen ejecutándose incluso cuando un agente se cae, ya sea un evento planeado (como en el caso de actualizaciones de software) o uno imprevisto. El nivel de resistencia al fallo aumenta proporcionalmente con la cantidad de agentes en un grupo.

• Escalabilidad: A medida que mejores tu conocimiento de las características dinámicas de tus proyectos, puedes agregar o quitar agentes de grupos, o crear nuevos grupos y entornos dedicados a patrones operacionales particulares.

La siguiente tabla compara los dos tipos de agentes:

Agentes en la nube

Los agentes en la nube son servicios en la nube gestionados por Jitterbit. Se configuran para adaptarse automáticamente a las cargas de trabajo del proyecto. No es necesario instalar, configurar, actualizar, iniciar ni detener agentes en la nube.

Grupos de agentes en la nube

Los grupos de agentes en la nube son grupos de agentes en la nube que ejecutan la misma versión. Se incluyen en todas las suscripciones de Harmony. Jitterbit proporciona dos grupos de agentes en la nube para cada región:

• Grupo de Agentes en la Nube de Producción: Un grupo de agentes en la versión actualmente lanzada, totalmente probado y listo para producción.

• Grupo de Agentes en la Nube de Sandbox: Un grupo de agentes en la próxima versión actualmente propuesta, adecuado para evaluación y pruebas.

Los grupos de agentes en la nube no requieren configuración ni gestión. A diferencia de los agentes privados, los agentes en la nube individuales no son visibles en la Management Console.

Agentes privados

A diferencia de los agentes en la nube, que son gestionados por Jitterbit, debes instalar y configurar agentes privados (en hosts Windows, Linux o Docker que cumplan con los requisitos del sistema), y gestionar tanto los agentes como los grupos mediante la página Management Console > Agents.

Puedes monitorear agentes privados con las métricas de observabilidad nativa de Jitterbit y con cualquiera de las plataformas de observabilidad de terceros compatibles.

Grupos de agentes privados

Antes de instalar y ejecutar un agente privado, necesitas al menos un grupo de agentes privados. (Los grupos de agentes privados son una adición con licencia a la suscripción de Harmony.) No se proporcionan grupos de agentes privados de forma predeterminada. Debes crearlos y asignarlos a entornos. Un grupo de agentes privados debe tener al menos un agente privado, y un agente solo puede estar en un grupo a la vez.

Cuando hay dos o más agentes en un grupo, los agentes se turnan para procesar cadenas de operaciones completas, incluyendo las secundarias. Esto tiene las siguientes consecuencias:

• No hay forma de predecir en qué agente se ejecutará una cadena de operaciones. Los proyectos con extremos que requieren acceso a archivos locales deben ejecutarse en un entorno donde todos los agentes del grupo tengan acceso a un sistema de archivos común o a una unidad compartida.

• La carga de trabajo promedio de los hosts de agentes individuales puede variar significativamente.

• Si un agente falla, las operaciones pueden quedar en suspenso y es posible que se pierdan datos.

Para conectores compatibles y un número mínimo de agentes activos, puedes habilitar el servicio de escucha para agentes en un grupo. El servicio de escucha permite que los conectores de Studio compatibles escuchen eventos de API. También designa uno de los agentes como líder. El agente líder distribuye tareas de operaciones a los agentes según su estado y carga. Si un agente falla, se pueden recuperar datos.

Cronograma de lanzamientos y notas de lanzamiento

El cronograma de lanzamientos para agentes varía según el tipo de agente:

• Los grupos de agentes en la nube se actualizan automáticamente según los cronogramas de actualización del Grupo de Agentes en la Nube de Sandbox y actualización del Grupo de Agentes en la Nube de Producción.

• Los instaladores de agentes privados actualizados están disponibles en la página Downloads al concluir el lanzamiento del Grupo de Agentes en la Nube de Producción.

• La imagen Docker del agente privado está disponible en Docker Hub al término de la versión del Grupo de Agentes en la Nube de Producción de la región de América del Norte (NA).

En las notas de la versión de Harmony, cada tipo de agente se incluye como un elemento de línea separado en la tabla de fechas de lanzamiento en la parte superior de cada página de notas de la versión. Las notas de la versión individuales se encuentran bajo el encabezado Agents, con cualquier aplicabilidad relevante a ciertos tipos de agentes incluida dentro de las notas de la versión.

También hay disponibles compilaciones de notas de la versión para Grupos de Agentes en la Nube de Producción, Grupos de Agentes en la Nube de Sandbox y agentes privados.

Problemas conocidos

Esta sección enumera los problemas conocidos identificados con versiones recientes de agentes privados. Para los problemas conocidos identificados con otras aplicaciones de Jitterbit Harmony, consulta Problemas conocidos.

Múltiples versiones de agentes privados

Agentes privados Windows 12.3

• Se removió el instalador del agente privado Windows 12.3 debido a un problema conocido

  • Resumen: Un problema conocido con la versión 12.3 del agente privado Windows causó que el instalador se removiera poco después del lanzamiento.

  • Solución alternativa: Si ya instalaste la versión 12.3 del agente en Windows, actualiza a la versión 12.4 del agente o posterior.

Agentes privados Linux 11.31.1 y todas las versiones anteriores

• Las operaciones programadas no se ejecutan después de reiniciar un agente privado Linux

  • Resumen: Después de reiniciar un agente privado Linux, el servicio Scheduler del agente no se inicia, lo que impide que las operaciones programadas se ejecuten como se espera. Este problema no ocurre con agentes privados Windows.

  • Información adicional: El servicio Scheduler del agente Linux utiliza una biblioteca que descarga los archivos de datos de zona horaria más recientes. A partir del 4 de septiembre de 2024, el proveedor de esta biblioteca introdujo un error de sintaxis que impide que el servicio Scheduler se inicie.

  • Recomendación: Este problema se resuelve con la versión 11.31.2, que ya no descarga automáticamente la biblioteca que causa el problema. Se recomienda actualizar los agentes privados Linux a la versión 11.31.2 o posterior para prevenir que este problema ocurra y, en los casos donde ya esté ocurriendo, para recuperarse del mismo.

    Como alternativa, si utilizas una versión anterior del agente, puedes aplicar los siguientes pasos de solución alternativa o recuperación a agentes que no usan Docker:

    • Solución alternativa: Si un agente privado Linux aún no se ha reiniciado, para prevenir que este problema ocurra, edita el archivo version en /opt/jitterbit/TimeZoneDB/version y cambia su valor a 2024b. Esto evitará que se descargue la versión de la biblioteca de fechas con el problema.

    • Recuperación: Si un agente privado Linux ya está experimentando este problema, para solucionarlo, edita el archivo northamerica en /opt/jitterbit/TimeZoneDB/northamerica para reemplazar el valor April con Apr en cualquier ocurrencia. Luego reinicia el agente.

Agentes privados Windows 11.44 a 11.58

• La actualización puede remover el servicio PostgreSQL

  • Resumen: Cuando actualices un agente privado Windows de una versión anterior a 11.44 a una versión entre 11.44 y 11.58, si ingresas una contraseña de cuenta de servicio PostgreSQL incorrecta en la solicitud del instalador, la actualización puede fallar sin revertirse correctamente, resultando en tiempo de inactividad del agente.

  • Información adicional: Este problema se resuelve en el agente privado 11.59 / 12.3 y posterior, donde se valida una contraseña incorrecta antes de que comience la actualización, se muestra un error de validación en el mismo cuadro de diálogo, y cancelar el instalador deja el agente existente intacto.

  • Solución alternativa: Si ya experimentaste este problema, consulta Servicio PostgreSQL removido después de una actualización fallida en Windows para obtener pasos de recuperación. Para evitar el problema antes de actualizar, asegúrate de conocer la contraseña de la cuenta de servicio PostgreSQL. Si es desconocida, consulta Restablecer la contraseña de administrador de PostgreSQL antes de actualizar.

Todas las versiones recientes

Estos problemas aplican a todas las versiones recientes:

• La instalación de agentes privados sin permisos de root en RHEL 9.7 y posteriores muestra un error de OpenSSL

  • Resumen: Los agentes privados sin permisos de root en Red Hat Enterprise Linux (RHEL) 9.7 y posteriores no logran iniciar debido a OpenSSL versión 3.5.

  • Información adicional: Se muestra el error ImportError: /opt/jitterbit/lib/libcrypto.so.3: version 'OPENSSL_3.4.0' not found (required by /usr/lib64/python3.9/lib-dynload/_hashlib.cpython-39-x86_64-linux-gnu.so). Este problema no ocurre en RHEL 9.6 y anteriores, donde OpenSSL es la versión 3.0.14.

  • Solución alternativa para agentes privados 12.x: Cambia el nombre de las bibliotecas OpenSSL incluidas para que se utilicen las bibliotecas OpenSSL 3.5 proporcionadas por el sistema RHEL:

    cd /opt/jitterbit/lib
    sudo mv libcrypto.so.3 libcrypto.so.3.bak
    sudo mv libssl.so.3 libssl.so.3.bak
    

  • Solución alternativa para agentes privados 11.x: Desactiva LD_LIBRARY_PATH y reinicia el agente con JITTERBIT_HOME establecido explícitamente:

    unset LD_LIBRARY_PATH
    export JITTERBIT_HOME=/opt/jitterbit
    sudo JITTERBIT_HOME=/opt/jitterbit env -u LD_LIBRARY_PATH jitterbit restart
    

• La instalación de agentes privados en Windows muestra una advertencia de Microsoft Defender SmartScreen

  • Resumen: Al instalar un agente privado 10.69 o posterior (para agentes 10.x) o 11.8 o posterior (para agentes 11.x) en Windows 2019 o Windows 10, puede aparecer un mensaje de advertencia.

  • Información adicional: El mensaje de advertencia indica "Windows protegió tu PC" con una nota de que Microsoft Defender SmartScreen impidió que iniciara una aplicación no reconocida.

  • Solución alternativa: Dentro del cuadro de diálogo de advertencia, haz clic en Más información para mostrar la opción Ejecutar de todas formas. Luego haz clic en Ejecutar de todas formas para continuar con la instalación del agente.

• Agentes privados de Windows: No se puede instalar el agente de 64 bits con autenticación de dos factores (TFA)

  • Resumen: La instalación de un agente privado de Windows de 64 bits falla si TFA está activo.

  • Información adicional: El instalador muestra un cuadro de diálogo de error.

  • Solución alternativa: Desactiva temporalmente TFA e instala el agente privado de Windows de 64 bits. Después de la instalación, activa TFA.

• Las conexiones ODBC no manejan correctamente los caracteres extendidos

  • Resumen: Al conectarse a una base de datos mediante un controlador ODBC, algunos caracteres extendidos, como un guión largo, no los manejan correctamente las operaciones que realizan upsert de datos.

  • Información adicional: Las operaciones de upsert pueden fallar o tener éxito con consecuencias no deseadas al afectar datos incorrectos. Ten en cuenta que las operaciones Insert y Update no se ven afectadas por este problema.

  • Solución alternativa: Utiliza un controlador JDBC para la conexión de base de datos (consulta las instrucciones para Design Studio o Studio).

• Los directorios SFTP a veces no se crean automáticamente

  • Resumen: Al escribir en SFTP como destino mediante Design Studio o Studio, la creación automática de directorios funciona de manera inconsistente.

  • Información adicional: Dependiendo del servidor FTP particular involucrado, el directorio puede no crearse.

  • Solución alternativa: Confirma que el directorio se haya creado antes del uso en producción.

• La función SetSalesforceSession no funciona

  • Resumen: La función de Jitterbit Script SetSalesforceSession no funciona correctamente y no debe utilizarse en Design Studio o Studio.

  • Información adicional: Si se utiliza, el script puede o no generar un error. Aunque el script no genere un error, la función no funcionará correctamente. Como la función no funciona, se utilizará el manejo de sesiones integrado del conector Salesforce.

• Los agentes privados tienen requisitos del sistema específicos y problemas conocidos

• Resumen: Los agentes privados tienen requisitos del sistema diferentes y específicos, así como problemas conocidos que varían según el sistema operativo utilizado.

  • Solución alternativa: Consulta los Requisitos del sistema para agentes privados para más detalles.

• La instalación del agente falla debido a que la contraseña de PostgreSQL incluye un signo más (+)

  • Resumen: La instalación del agente privado falla si la contraseña de PostgreSQL contiene un signo más (+). No se muestra ningún mensaje de error.

  • Información adicional: Este es un problema con el instalador del agente privado, no con PostgreSQL.

  • Solución alternativa: Utiliza una contraseña sin signo más (+). Una vez completada la instalación, se puede cambiar la contraseña a cualquier contraseña aceptable para usar con PostgreSQL.

11.26 agentes privados

• El parámetro claims de la función VerifyJwtClaims no toma el valor predeterminado correcto cuando se deja vacío

  • Resumen: Al usar la versión 11.26 del agente, dejar vacío el parámetro opcional claims con la función de Jitterbit Script VerifyJwtClaims genera un error.

  • Solución alternativa: Actualiza a la versión 11.27 del agente o posterior o ingresa "{}" para claims. Por ejemplo, VerifyJwtClaims("AxE9qm4aTZiXvA2G8sblAxjeL...", "RS256", "Secret", "{}");.

10.87 / 11.25 agentes privados anteriores

• Entradas de registro excesivas para el conector Microsoft Azure Service Bus

  • Resumen: Al usar el conector Microsoft Azure Service Bus con la versión 10.87 / 11.25 del agente o anterior, se genera un número excesivo de registros INFO en un corto período de tiempo, lo que causa problemas de espacio en disco debido al tamaño del archivo catalina.out.

  • Solución alternativa: Se recomienda actualizar a la versión 11.26 del agente o posterior. Como alternativa, este problema se puede resolver en la versión 10.87 / 11.25 del agente o anterior agregando los siguientes parámetros al archivo logback.xml ubicado en C:\Program Files\Jitterbit Agent\tomcat\shared\lib (Windows) o /opt/jitterbit/tomcat/shared/lib (Linux):

    <logger name="com.azure.core.amqp" level="ERROR"/>
    <logger name="com.azure.messaging.servicebus" level="ERROR"/>
    <logger name="com.azure.core.implementation" level="ERROR"/>
    

10.84 / 11.22 agentes privados anteriores

• Programación diaria omitida durante el cambio de horario de verano

  • Resumen: Al usar la versión 10.84 / 11.22 del agente o anterior, y el agente utiliza una zona horaria que observa el horario de verano, estos problemas conocidos ocurren durante un cambio de horario de verano:

    • Cuando una programación diaria se establece entre la 1 y las 2 AM, la operación programada no se ejecutará el primer domingo de noviembre debido al horario de verano.

    • Cuando una programación diaria se establece entre las 2 y las 3 AM, la operación programada no se ejecutará el segundo domingo de marzo debido al horario de verano.

  • Solución alternativa: Actualiza a la versión 10.85 / 11.23 del agente o posterior o establece la zona horaria del agente a UTC utilizando la política de la organización Anular zona horaria del agente de programación y selecciona Etc/UTC.

10.45 agentes privados anteriores

• Las vulnerabilidades de Apache Log4j2 JNDI afectan a los agentes privados

  • Resumen: Las vulnerabilidades de Apache Log4j2 CVE-2021-44228 y CVE-2021-45046 afectan a los agentes privados que utilizan conectores de Studio compilados con el SDK de conector de Studio.

• Mitigación: Un mantenimiento de emergencia abordó las vulnerabilidades. Después del mantenimiento, fue necesario reiniciar los agentes privados y ejecutar una operación para cada conector afectado para que la actualización fuera efectiva. Para obtener información detallada e instrucciones, consulta Mitigar la vulnerabilidad JNDI de Apache Log4j2.

10.38 Agentes privados de Linux

• La base de datos PostgreSQL se reinicializa al actualizar de la versión 10.37 a 10.38

  • Antecedentes: Al actualizar un agente privado de Linux de una versión anterior a 10.37 a una versión 10.37 o posterior, la base de datos PostgreSQL se reinicializará al actualizar a la versión 9.6. Esta actualización recreará la base de datos en tu agente privado y tus datos se recuperarán durante este proceso de actualización. Después de la actualización, cualquier copia de seguridad creada con una versión anterior de PostgreSQL no será compatible. El proceso de actualización puede tardar más de 30 minutos dependiendo del número de proyectos y del tamaño de los entornos asociados a tu grupo de agentes privados. Los trabajos pendientes se pondrán en una cola de espera para ejecutarse después de que se complete la actualización. Esta actualización no afecta al agente privado de Windows.

  • Problema conocido: Es un problema conocido que al actualizar un agente privado de Linux de la versión 10.37 a 10.38, la base de datos PostgreSQL se reinicializa.

  • Solución alternativa: Actualiza a un agente privado de Linux que sea versión 10.39 o posterior.

10.0 Agentes privados

• El conector Cherwell de Studio no funciona

  • Resumen: A partir de la versión 10.1 de Harmony, un cambio realizado en el conector Cherwell en Studio significa que ya no es compatible con agentes 10.0.

  • Solución alternativa: Si utilizas el conector Cherwell, actualiza a agentes 10.1 o superior.