Topologia e Observatório

O Guara Cloud constrói um mapa ao vivo de todos os serviços de um projeto e do tráfego entre eles, além de um painel de centro de controle do projeto como um todo.

Mapa do projeto

O mapa do projeto mostra cada serviço como um node e cada interação entre serviços como uma aresta. As arestas vêm de duas fontes complementares:

• Pareada (paired): gerada pelo processor de service-graph do Tempo, pareando spans de cliente e servidor dentro do mesmo trace. Funciona para chamadas HTTP entre serviços e carrega percentis completos de latência, taxa de erro e taxa de requisições.
• Fluxo L4 (l4_flow): gerada a partir das métricas de fluxo TCP do Beyla no nível do kernel. Funciona para qualquer protocolo TCP — incluindo Redis, NATS, Postgres e MongoDB — que o Tempo não consegue parear entre traces. Latência e taxa de erro não podem ser derivadas de fluxos L4, então o dashboard desenha essas arestas com estilo tracejado e um rótulo de bytes por segundo, em vez de inventar valores zero.

Os dois tipos convivem no mesmo mapa, então você vê o tráfego HTTP com métricas completas lado a lado com o tráfego de serviços de apoio que de outra forma ficaria invisível.

Cron workers no mapa

Cron workers aparecem no mesmo canvas dos serviços. São renderizados como nodes com ícone de relógio e borda tracejada, para serem distinguíveis dos serviços de relance. Uma aresta cron_trigger conecta cada worker ao seu destino, desenhada como linha tracejada na cor secundária da marca e sem a animação usada para o tráfego ao vivo — cron é agendado, não contínuo.

As arestas de cron são propositalmente excluídas das agregações de taxa de requisições e taxa de erros na topologia, então um worker barulhento não distorce as métricas de tráfego do serviço destino. Clique em um node de cron worker para ir direto à página de detalhe.

Observatório

O Observatório é a visão de centro de controle por projeto: saúde agregada (serviços saudáveis, requisições por minuto, taxa de erro, latência média e p99), um feed corrido de eventos (erros, deploys, alertas) e uma linha do tempo ao vivo de traces. É a forma mais rápida de saber se um projeto está saudável agora e onde olhar primeiro quando não está.

Paridade na CLI

Os dois dashboards têm equivalentes diretos na CLI, que renderizam os mesmos dados no terminal:

• guara projects map — renderiza a topologia como uma tabela de nodes e outra de edges por padrão; use --graph para um grafo ASCII em camadas (com fallback automático para a tabela de edges em terminais estreitos). As arestas mantêm a mesma distinção entre paired e l4_flow que o dashboard usa.
• guara projects observatory — mostra a barra de saúde, o feed de eventos e os traces ao vivo, redesenhando no lugar. Use --no-watch para um snapshot único, ideal para scripts e checks em CI.