Errores de Conexión, Websocket y E/S en Máquinas Virtuales de Azure¶

Descripción General¶

Esta página proporciona instrucciones sobre cómo solucionar problemas de un agente privado de Linux o Windows instalado en una máquina virtual (VM) de Microsoft Azure. (Consulte Ajuste del rendimiento del agente privado para obtener información general sobre cómo ajustar el rendimiento).

Solucionar Problemas de Conexiones Perdidas¶

Al utilizar un agente privado instalado en una máquina virtual de Microsoft Azure, es posible que se pierdan las conexiones. Azure establece el tiempo de espera de inactividad de WebSocket en 4 minutos, mientras que el agente privado predeterminado para hacer ping a Harmony está establecido en 5 minutos. Para resolver este problema, reduzca el intervalo del latido del agente:

1. Abra el jitterbit-agent-config.properties archivo en un editor de texto. Este archivo se puede encontrar en estos directorios:

   • Linux: <JITTERBIT_HOME>/Resources/

   • Windows: C:\Program Files\Jitterbit Agent\Resources

2. Encuentra el agent.heart.beat.interval Configuración:

   #Agent heart beat interval (IN MINUTES)
   agent.heart.beat.interval=5
   

3. Cambie la configuración a agent.heart.beat.interval=3.

4. Guarde los cambios y reinicie el agente.

Solucionar Errores de E/S y de Websocket¶

Los errores relacionados con WebSocket y E/S se pueden resolver con actualizaciones de los valores de tiempo de espera inactivo de IP asociado a la máquina virtual, tiempo de espera inactivo de TCP de la puerta de enlace de traducción de direcciones de red (NAT) y tiempo de espera de flujo de red virtual (VNET).

Los valores de tiempo de espera inactivo de IP, tiempo de espera inactivo de TCP de la puerta de enlace de NAT y tiempo de espera de flujo de VNET deben establecerse en 15 minutos.

Identificar Errores Relevantes¶

Los errores de WebSocket y E/S se pueden identificar consultando los registros de operación y el jitterbit-agent.log archivo. Este archivo de registro se puede encontrar en una de las siguientes ubicaciones:

• Para Windows: C:\Program Files (x86)\Jitterbit Agent\log\jitterbit-agent.log.

• Para Linux: /opt/jitterbit/log/jitterbit-agent.log.

Errores del Registro de Operaciones¶

Si está presente, cualquiera de los siguientes mensajes en los detalles del registro de operación para una operación con un estado de Error puede ser indicativo de un error de WebSocket o de E/S:

The operation "Example Operation" completed successfully.

No message found while removing message in cache for: Message Info: AgentId: 000001 AgentGroupId: 000001 MessageId: XXX Message Version (Agent): XXXX Message Version (Harmony): XXX Counter (Harmony): 1 Submitted Timestamp (Harmony):2024-01-20 11:55:00.700, message will be retried later OperationInstanceGUID: XXX

Run message could not reach the agent.

Errores del Archivo de Registro del Agente¶

Si está presente alguno de los siguientes mensajes en el jitterbit-agent.log el archivo puede ser indicativo de un error de WebSocket o de E/S:

2024-01-20 12:00:00 request handler thread #10642  INFO org.jitterbit.integration.server.api.util.AgentRetryExecutor:53 - Agent Message Receipt (OperationInstanceGUID: XXX) failed. Retrying....
2024-01-20 12:00:00 request handler thread #10642 ERROR org.jitterbit.integration.server.api.util.AgentRetryExecutor:55 - org.springframework.web.client.ResourceAccessException: I/O error on PUT request for "https://na-east.jitterbit.com/jitterbit-cloud-restful-service/agent/ackmsgreceipt": Read timed out; nested exception is java.net.SocketTimeoutException: Read timed out

E:2024-01-20 12:00:00 request handler thread #884 ERROR org.jitterbit.integration.server.messaging.agent.listener.AgentMessageListener:231 - No message found while removing message in cache for: Message Info: AgentId: 000001 AgentGroupId: 000001 MessageId: XXX Message Version (Agent): XXXX Message Version (Harmony): XXX Counter (Harmony): 1 Submitted Timestamp (Harmony):2024-01-20 11:55:00.700, message will be retried later OperationInstanceGUID: XXX

Detener el Drenaje del Agente¶

Detención del drenaje el agente antes de actualizar cualquier configuración de tiempo de espera. Si tiene más de un agente en el grupo de agentes afectado, haga lo mismo para todos ellos.

Aislar Recursos de Agente¶

Se recomienda que la máquina virtual del agente y sus recursos asociados estén separados en su propio grupo de recursos en Azure. Esto incluye su VNET, IP, puerta de enlace NAT, interfaz de red (NIC) y grupo de seguridad de red (NSG), si está presente.

Actualizar el Tiempo de Espera Inactivo de la IP¶

1. En Azure Portal, navegue hasta el grupo de recursos asociado con la máquina virtual del agente.

2. Identifique y haga clic en el elemento IP asociado con la VM:

   

3. Haga clic en Configuración y cambie el valor de Tiempo de espera de inactividad (minutos) a 15 minutos:

   

Actualizar el Tiempo de Espera Inactivo de TCP de la Puerta de Enlace NAT¶

1. En Azure Portal, navegue hasta el grupo de recursos asociado con la máquina virtual del agente.

2. Identifique y haga clic en el elemento de puerta de enlace NAT asociado con la VM y la IP, si está presente. Una puerta de enlace NAT asociada también aparecerá en la Descripción general del elemento IP junto al campo Asociado a.

3. Haga clic en Configuración y cambie el valor de Tiempo de espera de inactividad de TCP (minutos) a 15 minutos.

Actualizar el Tiempo de Espera del Flujo de VNET¶

1. En Azure Portal, navegue hasta el grupo de recursos asociado con la máquina virtual del agente.

2. Identifique y haga clic en el elemento VNET asociado con la VM:

   

3. En Descripción general, haga clic en Configurar junto a Tiempo de espera de flujo:

   

4. En el panel Tiempo de espera de flujo, habilite la configuración Habilitar tiempo de espera de flujo y cambie el valor de Tiempo de espera de flujo (minutos) a 15 minutos:

   

5. Haga clic en Guardar.

Reiniciar el Agente¶

1. En Azure Portal, reinicie la máquina virtual del agente.

2. Reinicie el agente detenido. Consulte Reiniciar un agente de Windows o Reiniciar un agente de Linux para obtener información detallada.