Aller au contenu principal
Version : 0.4 · actuelle

Architecture

ConceptRévisé le 11 octobre 2026
S'applique à :Excubius 0.4Rôles : Administrateur d'entité, Super-administrateur, Installateur (administrateur Linux)
PlansFree · Core · Pro · EnterpriseDéploiementAuto-hébergé

Excubius s'exécute sous la forme d'un petit ensemble de conteneurs sur un seul serveur Linux que vous contrôlez. Un collecteur en lecture seule et les outils de surveillance dont vous disposez déjà alimentent un pipeline unique, qui transforme tout en ressources, états et alertes, le stocke dans une seule base de données et le met à disposition de l'application web, de Slack, de Jira et d'une page d'état publique. Cet article explique chaque composant, comment une mesure devient une alerte, comment le serveur est organisé et ce qui est stocké à quel endroit.

Les composants et leurs liens​

ComposantRôle
CollecteurExécute les vérifications du catalogue sur vos systèmes : T-SQL pour SQL Server, HTTP et DNS pour les points de terminaison, les certificats et les domaines, les API Azure et Microsoft Graph, et des recherches Wazuh. Windows via WinRM et Linux via SSH sont expérimentaux. Il interroge aussi les outils dont vous disposez. Il se connecte avec des informations d'identification sans autorisation d'écriture et conserve ses résultats dans une mémoire tampon lorsque le serveur est occupé ou redémarre
SourcesNew Relic, NinjaOne et Azure Monitor, chacun lu par interrogation, par webhook ou les deux. Ce qu'ils signalent rejoint le même pipeline que les résultats du collecteur, si bien que leurs alertes arrivent dans la même boîte de réception et sur les mêmes canaux
NormaliseurTransforme chaque entrée en l'une des trois mêmes formes : une ressource, un résultat de vérification ou une alerte. Les ressources sont rapprochées entre les sources par des identifiants comme l'ID de ressource Azure, le nom d'hôte et le nom de domaine complet (FQDN) : un serveur vu par trois outils forme une seule ressource
Moteur d'alertesCompare chaque résultat à ses seuils effectifs, ouvre, fait monter en gravité et résout les alertes, les déduplique, les regroupe sous une cause racine, retient les notifications pendant les mises en sourdine et les fenêtres de maintenance, et détermine l'état de chaque ressource
Base de donnéesPostgreSQL 16 avec TimescaleDB contient tout : la configuration, les ressources, les métriques, les alertes avec leur chronologie, les constats et le journal d'audit
API et application webL'API sert l'application web et vérifie chaque requête au regard de votre rôle sur l'entité concernée. L'application web fonctionne dans tout navigateur récent et s'installe sur un téléphone ou une tablette. La page d'état publique est construite uniquement à partir de ce que les administrateurs ont choisi de publier
NotificationsLes messages Slack partent juste après l'enregistrement des résultats, et un balayage en arrière-plan toutes les 15 secondes envoie ce qui a dû attendre. Un Slack lent ou indisponible ne retarde jamais la surveillance. Les tickets Jira sont créés à la demande et suivis jusqu'à leur clôture

Comment une mesure devient une alerte​

  1. Le collecteur exécute une vérification à son échéance et publie le résultat sur l'API par le réseau interne du serveur. Une source, elle, transmet ses données par une interrogation ou un webhook.
  2. Le résultat est d'abord enregistré, si bien que rien n'est perdu si une étape ultérieure échoue. Ses valeurs sont écrites dans l'historique des métriques.
  3. Le moteur d'alertes compare la valeur aux seuils effectifs de cette vérification sur cette ressource. Lorsqu'une condition se maintient pendant toute sa durée for, il ouvre une alerte, ou met à jour celle qui est déjà ouverte pour la même condition.
  4. L'état de la ressource est recalculé, et l'application web l'affiche à son prochain rafraîchissement.
  5. L'étape de notification décide si le changement justifie un message, trouve les canaux en parcourant l'arborescence des entités et enregistre chaque message dans la chronologie de l'alerte.

Alertes et notifications détaille les étapes 3 à 5, et Seuils et bases de référence explique d'où viennent les seuils effectifs.

Un serveur, six conteneurs​

Tout s'exécute sur un seul serveur sous Rocky Linux 9 ou 10, ou sous un autre système de la famille Red Hat Enterprise Linux, en x86_64. Le minimum est de 2 processeurs virtuels, 4 Gio de mémoire et 20 Gio d'espace disque libre. Les conteneurs s'exécutent sans privilèges root avec Podman, sous un compte de service (excubius par défaut), et démarrent avec le serveur. Aucun code source ne se trouve sur le serveur : une version est un ensemble d'images de conteneur et un lot de déploiement, installés et mis à niveau par le programme d'installation.

ConteneurRôle
proxyLe seul conteneur dont des ports sont ouverts, 80 et 443. Il termine TLS, envoie les requêtes à l'application web ou à l'API, et limite le débit des webhooks
frontendSert l'application web
backendL'API, le normaliseur, le moteur d'alertes, les notifications, Jira et la page d'état publique
collectorLe collecteur et l'interrogation des sources. Il n'ouvre aucun port et ne reçoit que son propre jeton et ses paramètres, jamais le mot de passe de la base de données ni la clé qui chiffre les secrets stockés
certsÉmet et renouvelle le certificat TLS : Let's Encrypt, auto-signé ou le vôtre
dbPostgreSQL 16 avec TimescaleDB

Le collecteur communique avec l'API uniquement par le réseau interne du serveur : le proxy refuse les routes du collecteur depuis l'extérieur. En sortie, le serveur a besoin d'un accès HTTPS à Slack, à Jira et aux API de vos sources. Le module des mises à jour lit aussi des flux publics de builds et d'avis, et se rabat sur les copies fournies avec la version lorsque le serveur ne peut pas les atteindre. Dans Azure, attribuez à l'identité managée du serveur des rôles en lecture seule, comme Reader et Monitoring Reader, afin que le collecteur lise Azure sans secret stocké.

astuce

Pointez un outil externe de surveillance de la disponibilité vers https://<your host>/heartbeat. Il répond ok tant que le serveur fonctionne : vous êtes ainsi averti lorsque Excubius lui-même est arrêté.

Ce qui est stocké et où​

DonnéesEmplacementDurée de conservation
Entités, ressources, vérifications, seuils, utilisateurs et rôlesBase de donnéesJusqu'à ce que vous les modifiiez
MétriquesBase de données, dans une hypertable TimescaleDB90 jours
Alertes, constats, leur chronologie, les consultations et les attributionsBase de donnéesConservés comme historique
Charges utiles des webhooks des sourcesBase de données30 jours
Historique du score de sécuritéBase de donnéesUn instantané par heure pendant 14 jours, puis un par jour pendant 400 jours
Journal d'auditBase de donnéesConservé
Informations d'identification et secrets des sourcesBase de données, chiffrés avec une clé stockée uniquement dans le fichier de configuration du serveurJusqu'à ce que vous les remplaciez ou les supprimiez
Configuration du serveur : mot de passe de la base de données, secret de signature des sessions, clé de chiffrement, jeton du collecteurLe fichier .env du répertoire d'installation, /opt/excubius par défautGénérée une seule fois par le programme d'installation
Certificat TLSUn volume du conteneur certsRenouvelé automatiquement lorsqu'il reste 30 jours ou moins
Sauvegardes de la base de donnéesLe dossier backups du répertoire d'installation : une sauvegarde complète (dump) chaque jour à 02:30, heure du serveurLes 14 dernières sauvegardes

Les secrets sont en écriture seule : une fois enregistrés, personne ne peut les relire dans l'application web ni via l'API. Une sauvegarde de la base de données ne révèle à elle seule aucun secret, car la clé ne se trouve pas dans la base. Pour la même raison, conservez une copie du fichier .env avec vos sauvegardes ; sinon, les secrets stockés d'une base restaurée doivent être saisis de nouveau. Copiez les sauvegardes quotidiennes hors du serveur avec votre sauvegarde de serveur habituelle ; Mettre à niveau, sauvegarder et restaurer explique comment les restaurer.

En lecture seule par conception​

Excubius détecte, explique et suggère ; il ne modifie jamais un système surveillé.

  • Les connexions de surveillance et les informations d'identification d'API sont créées sans droit d'écriture ni d'installation. Une connexion SQL Server n'a jamais besoin de sysadmin.
  • Les constats de sécurité et les avis de mise à jour comportent une action suggérée, sous forme de texte, qu'une personne applique pendant une fenêtre de changement. Rien n'est exécuté et rien n'est installé.
  • Rien n'est écrit dans New Relic, NinjaOne, Azure, Microsoft Entra ID ou Wazuh.
  • Supprimer une ressource dans Excubius supprime ses vérifications, ses métriques et ses alertes dans Excubius uniquement. Le système surveillé n'est pas touché.

En cas de défaillance​

DéfaillanceCe que fait Excubius
L'API d'une source est arrêtéeLa source devient obsolète et affiche l'erreur. Rien n'est résolu à partir d'une interrogation en échec, et aucune alerte n'est inventée
Le collecteur ne peut pas atteindre une ressourceAprès trois échecs consécutifs de connexion, d'authentification ou de délai d'attente, la ressource passe à l'état Critique avec une seule alerte Cannot reach, et les autres alertes de la ressource attendent derrière elle
L'API ou la base de données est brièvement indisponibleLe collecteur conserve ses résultats et les envoie plus tard. Un résultat envoyé deux fois n'est enregistré qu'une fois
Slack est indisponibleLa surveillance continue. L'échec du message est enregistré sur l'alerte et le message est renvoyé, trois tentatives au total
Le serveur Excubius est arrêtéLes webhooks envoyés pendant ce temps sont perdus. Les sources en mode hybride les récupèrent lors du rapprochement suivant