Status e Saúde dos Serviços

O recurso de Status e Saúde dos Serviços fornece a visão em tempo real sobre a disponibilidade, integridade e capacidade operacional dos microsserviços e suas respectivas dependências no ecossistema.

A arquitetura de monitoramento de saúde é centralizada e gerenciada através do Console, permitindo que operadores, equipes de SRE e balanceadores de carga inspecionem a topologia do ambiente sem impactar o barramento de execução da Engine.

Arquitetura de Monitoramento via Cache de Identidade

Em vez de realizar chamadas diretas aos nodes da Engine ou aos runners para cada verificação visual, a plataforma utiliza um modelo desacoplado via Cache de Identidade:

┌────────────────────────────────────────────────────────────────────────┐
│                        TELA DO CONSOLE WEB                             │
│       (Painel de Saúde, Visão Geral de Nós e Status do Ambiente)       │
└───────────────────────────────────┬────────────────────────────────────┘
                                    │ 1. Chamada HTTP
                                    ▼
┌────────────────────────────────────────────────────────────────────────┐
│                            CONSOLE API                                 │
│  - Recebe as solicitações de inspeção de saúde                         │
│  - Consulta o estado consolidado dos serviços no Cache                 │
└───────────────────────────────────┬────────────────────────────────────┘
                                    │ 2. Leitura
                                    ▼
┌────────────────────────────────────────────────────────────────────────┐
│                        CACHE DE IDENTIDADE                             │
│  - Armazena os registros de heartbeats e status de dependências        │
│  - Mapeia se Engines, Runners e Bancos/Caches estão ONLINE/OFFLINE     │
└───────────────────────────────────▲────────────────────────────────────┘
                                    │ 3. Heartbeats Periódicos
                        ┌───────────┴───────────┐
                        │                       │
             ┌─────────────────────┐ ┌─────────────────────┐
             │   ENGINE DE EXEC.   │ │   RUNNERS / PLUGINS │
             └─────────────────────┘ └─────────────────────┘

Fluxo de Verificação e Atualização

1. Envio de Heartbeat e Registro

Cada serviço do ambiente (Engine e instâncias de Runners) publica periodicamente no Cache de Identidade o seu estado atual de saúde, incluindo a conectividade com suas dependências diretas (bancos JDBC, clusters Redis, conectores de mensageria).

2. Centralização na `console-api`

A console-api é a única interface responsável por consultar o Cache de Identidade, processar a topologia e determinar se um serviço ou dependência específica está no estado ONLINE, DEGRADED ou OFFLINE.

3. Exibição na Interface (`console-web`)

A tela de saúde do console-web consome a console-api e renderiza o status visual detalhado de toda a malha de serviços, oferecendo:

Status Geral da Malha

Indicadores visuais rápidos sobre a saúde global do ambiente.

Saúde das Dependências

Mapeamento de problemas específicos em conexões com bancos de dados, chaves de autenticação ou infraestrutura de cache.

Isolamento de Carga

Zero impacto nas threads de execução dos fluxos, já que a leitura é realizada inteiramente na memória do Cache de Identidade.

Benefícios da Centralização

Baixa Latência no Console

As requisições de atualização da tela no console-web respondem em milissegundos, pois leem dados já consolidados no cache.
Resiliência a Storms de Healthcheck

Impede que múltiplas ferramentas de monitoramento sobrecarreguem as CPUs das Engines com checagens síncronas de conectividade.
Inspecção de Dependências Ocultas

A console-api expõe a saúde não apenas do processo, mas do caminho completo necessário para que aquele nó processe requisições.