Troubleshooting: Falha de comunicação do Agente

Introdução

Este documento descreve o troubleshooting para falha de comunicação do Agente, quando o agente instalado não se comunica com o Skyone Studio, apresenta status “Offline” ou falha na execução de integrações locais, mesmo com o serviço em execução.

São abordadas as causas mais comuns, os requisitos de rede necessários e um passo a passo para diagnóstico e correção, finalizando com um checklist para validação da resolução do problema.

O que vamos encontrar

• Problema

• Causas mais comuns

• Requisitos de rede

• Passo a passo

• Checklist

---

Problema

O Agente instalado não se comunica com o Skyone Studio, apresenta status "Offline" ou falha ao tentar executar integrações locais, mesmo com o serviço rodando.

Causas Mais Comuns

• Bloqueio de Firewall (Portas ou Endereços não liberados).

• O Agente não está instalado na infraestrutura local do cliente (Erro de Arquitetura).

• Configuração incorreta de IP (Apontamento externo ao invés de interno).

Requisitos de Rede (Firewall)

Para o correto funcionamento, é mandatório que a rede permita tráfego de saída para os destinos abaixo:

Endereços (Domains/Hosts)

A regra de firewall deve permitir acesso aos seguintes endereços da Skyone:

• app-v2.integrasky.cloud

• api-v2.integrasky.cloud

• agent-proxy.integrasky.cloud

• amqp.integra.skyone.tools

Portas (TCP)

• 443 - HTTPS (Comunicação API/Web)

• 5671 - AMQPS (Mensageria Segura)

---

Passo a Passo para Resolução

Siga a ordem abaixo para diagnosticar e corrigir:

Passo 1: Teste de Conectividade (Validação do Firewall)

Antes de verificar a instalação, valide se o servidor consegue chegar nos endereços da Skyone. Execute os testes abaixo na máquina do Agente:

Teste Porta 443 (HTTPS):

telnet agent-proxy.integrasky.cloud 443

(Se conectar, a tela ficará preta ou o cursor piscará. Se der erro, o firewall está bloqueando).

Teste Porta 5671 (AMQP):

telnet amqp.integra.skyone.tools 5671

Opção via PowerShell (Windows):

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

Busque pelo resultado:

TcpTestSucceeded : True

---

Passo 2: Validar Local de Instalação (Arquitetura)

O Agente deve estar instalado em um servidor dentro da infraestrutura On-Premise que devemos acessar.

Erro comum:

Instalar o agente em uma máquina na nuvem (AWS/Azure) tentando acessar o banco/servidor do cliente via IP Público. Isso não funcionará corretamente para este cenário.

Solução:

Mover a instalação para um servidor na mesma rede local da aplicação.

---

Passo 3: Configuração do Host no Agente

No arquivo de configuração, confirme se o terminal está preenchido com o agente instalado e verifique o apontamento para o sistema do cliente.

O Agente deve apontar para o IP Local (Rede Interna).

• Correto: 10.10.x.x ou hostname-interno

• Incorreto: IPs Públicos, DNS Externos ou rotas via internet

---

Checklist de Finalização

O problema é considerado resolvido quando:

• O comando telnet ou Test-NetConnection retorna sucesso nas portas 443 e 5671.

• O Agente está instalado fisicamente/virtualmente na infraestrutura local

• Acessa o IP Local do servidor da aplicação.

• O Status no Studio consta como “Online”.

---

Conclusão

A falha de comunicação do Agente geralmente está relacionada a configurações de rede, local de instalação ou ao endereçamento de IP. Seguindo o passo a passo e validando os itens do checklist, é possível garantir que o agente se comunique corretamente com o Skyone Studio e apresente status “Online”.