Solución de problemas: Falla de comunicación del Agente

Introducción Este documento describe el proceso de solución de problemas para fallas de comunicación del Agente, cuando el agente instalado no se comunica con Skyone Studio, muestra el estado “Offline” o falla al ejecutar integraciones locales, incluso cuando el servicio está en ejecución.

Se abordan las causas más comunes, los requisitos de red necesarios y un paso a paso para el diagnóstico y la corrección, finalizando con una lista de verificación para validar que el problema haya sido resuelto.

Qué encontrarás

• Problema

• Causas más comunes

• Requisitos de red

• Paso a paso

• Lista de verificación

---

Problema

El Agente instalado no se comunica con Skyone Studio, muestra el estado “Offline” o falla al intentar ejecutar integraciones locales, incluso cuando el servicio está en ejecución.

Causas más comunes

• Bloqueo del firewall (puertos o direcciones no permitidas).

• El Agente no está instalado en la infraestructura local del cliente (error de arquitectura).

• Configuración incorrecta de IP (enrutamiento externo en lugar de interno).

Requisitos de red (Firewall)

Para un funcionamiento correcto, es obligatorio permitir tráfico de salida hacia los destinos que se indican a continuación.

Direcciones (Dominios/Hosts)

La regla del firewall debe permitir acceso a las siguientes direcciones de Skyone:

• app-v2.integrasky.cloud

• api-v2.integrasky.cloud

• agent-proxy.integrasky.cloud

• amqp.integra.skyone.tools

Puertos (TCP)

• 443 – HTTPS (comunicación API/Web)

• 5671 – AMQPS (mensajería segura)

---

Paso a paso para la resolución

Siga el orden a continuación para diagnosticar y corregir el problema.

Paso 1: Prueba de conectividad (validación del firewall)

Antes de verificar la instalación, valide que el servidor pueda comunicarse con las direcciones de Skyone. Ejecute las siguientes pruebas en la máquina del Agente.

Prueba del puerto 443 (HTTPS):

telnet agent-proxy.integrasky.cloud 443

(Si se conecta, la pantalla quedará en negro o el cursor parpadeará. Si falla, el firewall está bloqueando la conexión).

Prueba del puerto 5671 (AMQP):

telnet amqp.integra.skyone.tools 5671

Opción vía PowerShell (Windows):

Test-NetConnection -ComputerName agent-proxy.integrasky.cloud -Port 443
Test-NetConnection -ComputerName amqp.integra.skyone.tools -Port 5671

Busque el resultado:

TcpTestSucceeded : True

Paso 2: Validar la ubicación de instalación (arquitectura)

El Agente debe estar instalado en un servidor dentro de la infraestructura on-premise a la que se necesita acceder.

Error común: Instalar el agente en una máquina en la nube (AWS/Azure) intentando acceder a la base de datos/servidor del cliente mediante una IP pública. Esto no funcionará correctamente para este escenario.

Solución: Mover la instalación a un servidor dentro de la misma red local de la aplicación.

Paso 3: Configuración del host en el Agente

En el archivo de configuración, confirme que el campo del terminal esté completado con el agente instalado y verifique el apuntamiento hacia el sistema del cliente.

El Agente debe apuntar a una IP local (red interna).

• Correcto: 10.10.x.x o hostname interno

• Incorrecto: IPs públicas, DNS externos o rutas a través de internet

---

Lista de verificación final

El problema se considera resuelto cuando:

• El comando telnet o Test-NetConnection devuelve éxito en los puertos 443 y 5671.

• El Agente está instalado física o virtualmente en la infraestructura local.

• El Agente accede al servidor de la aplicación mediante una IP local.

• El estado en Skyone Studio aparece como “Online”.

---

Conclusión

Las fallas de comunicación del Agente generalmente están relacionadas con configuraciones de red, la ubicación de la instalación o el direccionamiento IP. Siguiendo el paso a paso y validando los elementos de la lista de verificación, es posible garantizar que el Agente se comunique correctamente con Skyone Studio y muestre el estado “Online”.