Pular para o conteúdo principal
Versão: 0.4 · atual

Arquitetura

ConceitoRevisado em 11 de outubro de 2026
Aplica-se a:Excubius 0.4Funções: Administrador de entidade, Superadministrador, Instalador (administrador do Linux)
PlanosFree · Core · Pro · EnterpriseImplantaçãoAuto-hospedado

O Excubius é executado como um pequeno conjunto de contêineres em um único servidor Linux que você controla. Um coletor somente leitura e as ferramentas de monitoramento que você já tem alimentam um único pipeline, que transforma tudo em recursos, estados e alertas, armazena tudo em um único banco de dados e entrega os dados ao aplicativo web, ao Slack, ao Jira e a uma página de status pública. Este artigo explica cada parte, como uma medição se torna um alerta, como o servidor é organizado e o que é armazenado onde.

As partes e como elas se conectam​

ParteO que faz
ColetorExecuta as verificações do catálogo nos seus sistemas: T-SQL para o SQL Server, HTTP e DNS para endpoints, certificados e domínios, as APIs do Azure e do Microsoft Graph e pesquisas no Wazuh. O Windows por WinRM e o Linux por SSH são experimentais. Ele também consulta por sondagem as ferramentas que você já tem. Ele se conecta com credenciais sem permissão de gravação e mantém os resultados em um buffer enquanto o servidor está ocupado ou reiniciando
FontesNew Relic, NinjaOne e Azure Monitor, cada uma lida por sondagem, por webhook ou das duas formas. O que elas informam entra no mesmo pipeline que os resultados do coletor, de modo que os alertas delas chegam à mesma caixa de entrada e aos mesmos canais
NormalizadorTransforma cada entrada nas mesmas três formas: um recurso, o resultado de uma verificação ou um alerta. Os recursos são correlacionados entre as fontes por identificadores como a ID do recurso do Azure, o nome do host e o FQDN, de modo que um servidor visto por três ferramentas é um único recurso
Mecanismo de alertasCompara cada resultado com os limites efetivos, abre, escala e resolve alertas, desduplica os alertas, agrupa-os sob uma causa raiz, retém as notificações durante silêncios e janelas de manutenção e calcula o estado de cada recurso
Banco de dadosO PostgreSQL 16 com TimescaleDB guarda tudo: a configuração, os recursos, as métricas, os alertas com as linhas do tempo, as descobertas e o log de auditoria
API e aplicativo webA API atende ao aplicativo web e verifica cada solicitação em relação à sua função na entidade em questão. O aplicativo web funciona em qualquer navegador atual e pode ser instalado em um celular ou tablet. A página de status pública é montada apenas com o que os administradores escolheram publicar
NotificaçõesAs mensagens do Slack saem logo depois que os resultados são armazenados, e uma varredura em segundo plano a cada 15 segundos envia o que precisou esperar. Um Slack lento ou indisponível nunca atrasa o monitoramento. Os itens do Jira são criados sob demanda e acompanhados até serem concluídos

Como uma medição se torna um alerta​

  1. O coletor executa uma verificação quando ela está prevista e envia o resultado à API pela rede interna do servidor. Uma fonte, por sua vez, informa por sondagem ou por webhook.
  2. O resultado é armazenado primeiro, para que nada se perca se uma etapa posterior falhar. Os valores dele são gravados no histórico de métricas.
  3. O mecanismo de alertas compara o valor com os limites efetivos dessa verificação nesse recurso. Quando uma condição se mantém durante toda a duração for, ele abre um alerta ou atualiza o que já está aberto para a mesma condição.
  4. O estado do recurso é recalculado, e o aplicativo web o mostra na próxima atualização.
  5. A etapa de notificação decide se a mudança justifica uma mensagem, encontra os canais pela árvore de entidades e registra cada mensagem na linha do tempo do alerta.

Alertas e notificações explica em detalhes as etapas 3 a 5, e Limites e linhas de base explica de onde vêm os limites efetivos.

Um servidor, seis contêineres​

Tudo é executado em um único servidor com Rocky Linux 9 ou 10, ou outro sistema da família Red Hat Enterprise Linux, em x86_64. O mínimo é 2 vCPUs, 4 GiB de memória e 20 GiB de disco livre. Os contêineres são executados sem root com o Podman, em uma conta de serviço (excubius por padrão), e iniciam junto com o servidor. Não há código-fonte no servidor: uma versão é um conjunto de imagens de contêiner mais um pacote de implantação, instalado e atualizado pelo instalador.

ContêinerFunção
proxyO único contêiner com portas abertas, a 80 e a 443. Ele encerra o TLS, encaminha as solicitações ao aplicativo web ou à API e limita a taxa de webhooks
frontendServe o aplicativo web
backendA API, o normalizador, o mecanismo de alertas, as notificações, o Jira e a página de status pública
collectorO coletor e a sondagem das fontes. Ele não abre nenhuma porta e recebe apenas o próprio token e as próprias configurações, nunca a senha do banco de dados nem a chave que criptografa os segredos armazenados
certsEmite e renova o certificado TLS: Let's Encrypt, autoassinado ou o seu próprio
dbPostgreSQL 16 com TimescaleDB

O coletor se comunica com a API apenas pela rede interna do servidor: o proxy recusa as rotas do coletor vindas de fora. Para saída, o servidor precisa de HTTPS até o Slack, o Jira e as APIs das suas fontes. O módulo de atualizações também lê feeds públicos de builds e avisos e, quando o servidor não consegue acessá-los, usa as cópias incluídas na versão. No Azure, atribua à identidade gerenciada do servidor funções somente leitura, como Reader e Monitoring Reader, para que o coletor leia o Azure sem um segredo armazenado.

dica

Aponte um monitor de disponibilidade externo para https://<your host>/heartbeat. Ele responde ok enquanto o servidor está em execução, então você fica sabendo quando o próprio Excubius está fora do ar.

O que é armazenado onde​

DadosOndePor quanto tempo
Entidades, recursos, verificações, limites, usuários e funçõesBanco de dadosAté você alterá-los
MétricasBanco de dados, em uma hypertable do TimescaleDB90 dias
Alertas, descobertas, as linhas do tempo, quem viu e as atribuiçõesBanco de dadosMantidos como histórico
Payloads de webhooks das fontesBanco de dados30 dias
Histórico da pontuação de segurançaBanco de dadosUm instantâneo por hora durante 14 dias e, depois, um por dia durante 400 dias
Log de auditoriaBanco de dadosMantido
Credenciais e segredos das fontesBanco de dados, criptografados com uma chave armazenada apenas no arquivo de configuração do servidorAté você substituí-los ou removê-los
Configuração do servidor: senha do banco de dados, segredo de assinatura de sessões, chave de criptografia, token do coletorO arquivo .env do diretório de instalação, /opt/excubius por padrãoGerada uma vez pelo instalador
Certificado TLSUm volume do contêiner certsRenovado automaticamente quando faltam 30 dias ou menos
Backups do banco de dadosA pasta backups do diretório de instalação: um dump por dia às 02:30, no horário do servidorOs últimos 14 dumps

Os segredos são somente gravação: depois de salvos, ninguém consegue lê-los de volta no aplicativo web nem pela API. Um dump do banco de dados sozinho não revela nenhum segredo, porque a chave não está no banco de dados; pelo mesmo motivo, guarde uma cópia do arquivo .env com os seus backups, ou os segredos armazenados de um banco de dados restaurado precisarão ser informados de novo. Copie os backups diários para fora do servidor com o backup de servidores que você já usa; Atualizar, fazer backup e restaurar explica como restaurá-los.

Somente leitura por design​

O Excubius detecta, explica e sugere; ele nunca altera um sistema monitorado.

  • Os logons de monitoramento e as credenciais de API são criados sem direitos de gravação ou de instalação. Um logon do SQL Server nunca precisa de sysadmin.
  • As descobertas de segurança e os avisos de atualização trazem uma ação sugerida em forma de texto, para uma pessoa seguir em uma janela de mudança. Nada é executado e nada é instalado.
  • Nada é gravado no New Relic, no NinjaOne, no Azure, no Microsoft Entra ID nem no Wazuh.
  • Excluir um recurso no Excubius exclui as verificações, as métricas e os alertas dele apenas no Excubius. O sistema monitorado não é tocado.

Quando algo falha​

FalhaO que o Excubius faz
A API de uma fonte está fora do arA fonte fica desatualizada e mostra o erro. Nada é resolvido a partir de uma sondagem com falha, e nenhum alerta é inventado
O coletor não consegue acessar um recursoDepois de três falhas seguidas de conexão, de entrada ou de tempo limite, o recurso passa para Crítico com um único alerta Cannot reach, e os outros alertas do recurso ficam aguardando atrás dele
A API ou o banco de dados fica indisponível por pouco tempoO coletor guarda os resultados e os envia depois. Um resultado enviado duas vezes é armazenado uma vez
O Slack está indisponívelO monitoramento continua. A mensagem que falhou é registrada no alerta e enviada de novo, em três tentativas no total
O servidor do Excubius está fora do arOs webhooks enviados nesse período se perdem. As fontes no modo híbrido os recuperam na próxima reconciliação