Topologia da Infraestrutura

A página Topologia desenha toda a infraestrutura da sua organização em uma única tela: cada servidor, cada site, o próprio painel e a malha WireGuard que liga tudo. Em vez de olhar servidores e sites em listas separadas, você vê o mapa — quem hospeda o quê, quem depende de quem e por onde o tráfego passa. É a melhor ferramenta para entender a forma da sua frota de relance e para diagnosticar dependências entre servidores. Abra em Infraestrutura → Topologia.

Mapa de topologia da infraestrutura

O que o mapa mostra

O canvas coloca o painel no centro e os servidores ao redor, cada um com os sites que hospeda pendurados nele. Entre os nós, linhas representam duas coisas diferentes:

  • A malha WireGuard — os túneis criptografados que ligam os servidores entre si.
  • As dependências de serviço — de qual servidor cada site obtém seu banco de dados, Redis, S3 e Reverb.

É a leitura conjunta dessas linhas que revela a arquitetura real. No exemplo da Empresa XPTO, o mapa deixa claro o desenho de dois servidores: o Servidor Principal (All-in-One) concentra o PostgreSQL, o Redis, o MinIO/S3 e o Reverb, enquanto o Servidor de Sites (App Server) só roda containers de sites. O site todo.babytor.com.br, hospedado no Servidor de Sites, aparece com uma linha de dependência atravessando a malha WireGuard até o Servidor Principal — porque é lá que estão o banco e o cache que ele usa. Essa dependência cross-server (entre servidores diferentes) é exatamente o que a topologia foi feita para tornar visível.

Sondas HTTP ao vivo

A cada 60 segundos, o Agent de cada servidor testa os sites que ele hospeda, fazendo uma requisição a cada domínio e registrando o código HTTP de resposta e o tempo. Esse resultado sobe para o painel e aparece na topologia: ao clicar em um servidor, abre-se um painel lateral que lista cada site com seu código HTTP ao vivo, em uma faixa colorida:

  • Sucesso (200, 301, 302) — pílula verde.
  • Aviso (4xx) — pílula âmbar.
  • Erro (5xx, ou sem sonda há mais de 5 minutos) — pílula vermelha.
  • Desconhecido (ainda sem dados de sonda) — traço cinza.

Essa é a forma mais rápida de flagrar um site que está silenciosamente retornando erro 500 antes que os seus visitantes percebam — e funciona independentemente do estado que o PrimeForge esperava para o site, já que a sonda é independente da reconciliação de containers.

Visões e filtros

A aba de Topologia oferece três visões do mesmo mapa, escolhidas pelo seletor de visualização:

  • Malha radial — um canvas radial fluido em que o painel fica no centro e os servidores orbitam ao seu redor, distribuídos de forma equilibrada. É a visão padrão e a mais legível para uma frota pequena.
  • Rack — um layout empilhado, no estilo de um rack de servidores, agrupado por tipo de servidor. Bom para pensar a frota por categoria.
  • Hierárquico — uma visão centrada no painel, esticada para que ele preencha a tela — útil para diagnosticar um problema do lado do painel.

Em telas pequenas (celular/tablet), a página troca automaticamente para uma lista empilhada de servidores, para o mapa nunca transbordar. Além das visões, há recursos para focar no que importa:

  • Somente degradados — um filtro que esconde os nós saudáveis, deixando na tela apenas o que precisa de atenção.
  • Destaque — um parâmetro de URL (?highlight={id_do_site}) contorna um site específico no mapa, prático para compartilhar um link direto num chat da equipe.

A aba Inventário

Ao lado da Topologia existe a aba Inventário — as mesmas informações, mas em tabelas planas de servidores, sites, serviços e conexões. Se você prefere linhas a diagramas, ou precisa de uma listagem "fonte da verdade" para conferir dados, é ali que encontra. As duas abas mostram a mesma frota; mudam apenas na forma de apresentar.

Próximos passos

Monitoramento, Agendador e Firewall Sites