Agentes de Jitterbit

Descripción general

Los agentes Harmony de Jitterbit procesan las operaciones de tus proyectos de integración y envían y reciben datos de los puntos finales. Hay dos tipos de agentes, en la nube y privados:

• En la nube: Jitterbit gestiona agentes en la nube en su propia infraestructura en la nube. No necesitas configurar nada.

• Privados: Debes configurar, gestionar y administrar agentes privados en tu propia infraestructura en la nube o física.

Todos los agentes son miembros de un grupo. Los grupos de agentes son grupos de agentes del mismo tipo (no puedes mezclar agentes privados y en la nube en un grupo). Los agentes en un grupo de agentes procesan las operaciones de tu proyecto de Integration Studio o Design Studio. Los grupos ofrecen los siguientes beneficios:

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

  Este servicio de enrutamiento analiza los requisitos del trabajo y los compara con las capacidades individuales de los agentes (lo que incluye sus conectores, versiones y sistemas operativos). Desde el grupo de agentes capaces, una estrategia de balanceo de carga distribuye la carga de trabajo, previniendo cuellos de botella. Si un agente designado está ocupado o fuera de línea, el trabajo se redirige 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 despacha el trabajo tan pronto como un agente apropiado se vuelve disponible.

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

• Alta disponibilidad: Si un agente o su host se vuelve no disponible, y es el único agente en un grupo, cualquier proyecto de integración que use ese grupo se agotará y eventualmente fallará. Con múltiples agentes en un grupo, tus proyectos pueden seguir ejecutándose incluso cuando un agente está inactivo, ya sea que esto sea planeado (como en el caso de actualizaciones de software) o imprevisto. El nivel de resiliencia ante fallos aumenta proporcionalmente con el número de agentes en un grupo.

• Escalabilidad: A medida que mejoras tu conocimiento sobre las características dinámicas de tus proyectos, puedes agregar o quitar agentes de grupos, o crear nuevos grupos y entornos dedicados a patrones operativos 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. Están configurados para adaptarse automáticamente a las cargas de trabajo de su proyecto. No es necesario instalar, configurar, actualizar, iniciar o detener los 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. Están incluidos 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 liberada, completamente probada y lista para producción.

• Grupo de Agentes en la Nube de Sandbox: Un grupo de agentes en la próxima versión 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 Consola de Administración.

Agentes privados

A diferencia de los agentes en la nube, que son gestionados por Jitterbit, debe instalar y configurar agentes privados (en Windows, Linux), o en hosts de Docker que cumplan con los requisitos del sistema, y gestionar tanto los agentes como los grupos utilizando la página Consola de Administración > Agentes.

Puede monitorear los agentes privados con las métricas de observabilidad nativas de Jitterbit, y con cualquiera de las plataformas de observabilidad de terceros compatibles.

Grupos de agentes privados

Antes de poder instalar y ejecutar un agente privado, se necesita al menos un grupo de agentes privados. (Los grupos de agentes privados son una adición licenciable a su suscripción de Harmony). No se proporcionan grupos de agentes privados por defecto. Debe crearlos y asignarlos a entornos. Un grupo de agentes privados debe tener al menos un agente privado en él, 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 operación completas, incluidos los hijos. Esto tiene las siguientes consecuencias:

• No hay forma de predecir en qué agente se ejecutará una cadena de operación. Los proyectos con puntos finales 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 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 espera y se podrían perder datos.

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

Cronograma de lanzamientos y notas de lanzamiento

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

• Los grupos de agentes en la nube se actualizan automáticamente en los cronogramas de actualización del grupo de agentes en la nube Sandbox y cronogramas de 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 de Descargas al concluir el lanzamiento del grupo de agentes en la nube de producción.

• La imagen Docker del agente privado estará disponible en Docker Hub al concluir el lanzamiento 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 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 enumeran bajo el encabezado Agentes, con cualquier aplicabilidad relevante a ciertos tipos de agentes incluida dentro de las notas de la versión.

También están disponibles las compilaciones de notas de la versión para los 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 que se han identificado con versiones recientes de agentes privados. Para problemas conocidos que se han identificado con otras aplicaciones de Jitterbit Harmony, consulte Problemas conocidos.

Múltiples versiones de agentes privados

Agentes privados de Linux 11.31.1 y todas las versiones anteriores

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

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

  • Información adicional: El servicio Scheduler del agente de 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 de Linux a la versión 11.31.2 o posterior para evitar que este problema ocurra y, en los casos en que ya esté ocurriendo, para recuperarse de él.

    Alternativamente, si está utilizando una versión anterior del agente, puede aplicar los siguientes pasos de solución alternativa o recuperación para agentes que no son de Docker:

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

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

Todas las versiones recientes

Estos problemas se aplican a todas las versiones recientes:

• La instalación del agente privado de 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 dice "Windows protegió su PC" con una nota de que Microsoft Defender SmartScreen impidió que una aplicación no reconocida se iniciara.

  • Solución alternativa: Dentro del cuadro de diálogo del mensaje de advertencia, haga clic en Más información para mostrar la opción Ejecutar de todos modos. Luego haga clic en Ejecutar de todos modos 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: Desactive temporalmente TFA e instale el agente privado de Windows de 64 bits. Después de la instalación, active TFA.

• Las conexiones ODBC no manejan correctamente los caracteres extendidos

  • Resumen: Al conectarse a una base de datos utilizando un controlador ODBC, algunos caracteres extendidos, como un guion largo, no son manejados correctamente por las operaciones que actualizan o insertan datos.

  • Información Adicional: Las operaciones de Upsert pueden fallar o tener consecuencias no deseadas al afectar los datos incorrectos. Tenga en cuenta que las operaciones de Insertar y Actualizar no se ven afectadas por este problema.

  • Solución Alternativa: Utilice un controlador JDBC para la conexión a la base de datos (consulte las instrucciones para Design Studio o Integration Studio).

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

  • Resumen: Al escribir en SFTP como un objetivo utilizando Design Studio o Integration 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 ser creado.

  • Solución Alternativa: Confirme que el directorio ha sido creado antes de su uso en producción.

• SetSalesforceSession la función no funciona

  • Resumen: La función de script de Jitterbit SetSalesforceSession no funciona correctamente y no debe ser utilizada en Design Studio o Integration Studio.

  • Información Adicional: Si se utiliza, el script puede o no generar un error. Incluso si el script no genera un error, la función no funcionará correctamente. Como la función no funciona, se utilizará el manejo de sesión incorporado del conector de Salesforce.

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

  • Resumen: Los agentes privados tienen diferentes y específicos requisitos del sistema y problemas conocidos, dependiendo del sistema operativo que se esté utilizando.

  • Solución Alternativa: Consulte 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: Utilice una contraseña sin un signo más (+). Cuando la instalación esté completa, la contraseña se puede cambiar a cualquier contraseña aceptable para su uso con PostgreSQL.

11.26 agentes privados

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

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

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

10.87 / 11.25 y versiones anteriores de agentes privados

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

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

  • Solución Alternativa: Se recomienda una actualización a la versión del agente 11.26 o posterior. Como alternativa, este problema se puede resolver en la versión del agente 10.87 / 11.25 o anterior agregando la siguiente configuración 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 y agentes privados anteriores

• Se omitió el horario diario una vez durante el cambio de horario de verano

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

    • Cuando se establece un horario diario una vez 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 se establece un horario diario una vez 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: Actualizar a la versión del agente 10.85 / 11.23 o posterior o establecer la zona horaria del agente a UTC utilizando la Política de Horario de Agente de Sobrescritura política de organización y seleccionando Etc/UTC.

10.45 y 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 Integration Studio construidos con el SDK de Conectores de Integration Studio.

  • Mitigación: Un mantenimiento de emergencia abordó las vulnerabilidades. Después del mantenimiento, los agentes privados necesitaban ser reiniciados y se debía ejecutar una operación para cada conector afectado para que la actualización fuera efectiva. Para obtener información detallada e instrucciones, consulte Mitigar la vulnerabilidad de Apache Log4j2 JNDI.

10.38 Agentes privados de Linux

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

  • Antecedentes: Al actualizar un agente privado de Linux de una versión anterior a la 10.37 a una versión que sea 10.37 o posterior, la base de datos PostgreSQL se reinicializará al actualizarse a la versión 9.6. Esta actualización recreará la base de datos en su agente privado y sus datos se recuperarán durante este proceso de actualización. Después de la actualización, cualquier copia de seguridad creada utilizando 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 con su grupo de agentes privados. Cualquier trabajo pendiente se colocará en una cola de espera para ser ejecutado después de que se complete la actualización. Esta actualización no involucra 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 la 10.38, la base de datos PostgreSQL se reinicializa.

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

10.0 agentes privados

• El conector Cherwell de Integration Studio no funciona

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

  • Solución alternativa: Si está utilizando el conector Cherwell, actualice a agentes 10.1 o superiores.

9.8 agentes privados

• Los complementos no se están ejecutando

  • Resumen: Un problema con los complementos que no se ejecutan resultó en que la descarga del agente privado 9.8 se retirara poco después del lanzamiento.

  • Solución alternativa: Si aún tiene un agente privado 9.8, actualice a una versión posterior.