Architecture
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
| Composant | Rôle |
|---|---|
| Collecteur | Exé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 |
| Sources | New 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 |
| Normaliseur | Transforme 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'alertes | Compare 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ées | PostgreSQL 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 web | L'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 |
| Notifications | Les 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
- 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.
- 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.
- 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. - L'état de la ressource est recalculé, et l'application web l'affiche à son prochain rafraîchissement.
- 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.
| Conteneur | Rôle |
|---|---|
proxy | Le 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 |
frontend | Sert l'application web |
backend | L'API, le normaliseur, le moteur d'alertes, les notifications, Jira et la page d'état publique |
collector | Le 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 |
db | PostgreSQL 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é.
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ées | Emplacement | Durée de conservation |
|---|---|---|
| Entités, ressources, vérifications, seuils, utilisateurs et rôles | Base de données | Jusqu'à ce que vous les modifiiez |
| Métriques | Base de données, dans une hypertable TimescaleDB | 90 jours |
| Alertes, constats, leur chronologie, les consultations et les attributions | Base de données | Conservés comme historique |
| Charges utiles des webhooks des sources | Base de données | 30 jours |
| Historique du score de sécurité | Base de données | Un instantané par heure pendant 14 jours, puis un par jour pendant 400 jours |
| Journal d'audit | Base de données | Conservé |
| Informations d'identification et secrets des sources | Base de données, chiffrés avec une clé stockée uniquement dans le fichier de configuration du serveur | Jusqu'à 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 collecteur | Le fichier .env du répertoire d'installation, /opt/excubius par défaut | Générée une seule fois par le programme d'installation |
| Certificat TLS | Un volume du conteneur certs | Renouvelé automatiquement lorsqu'il reste 30 jours ou moins |
| Sauvegardes de la base de données | Le dossier backups du répertoire d'installation : une sauvegarde complète (dump) chaque jour à 02:30, heure du serveur | Les 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éfaillance | Ce que fait Excubius |
|---|---|
| L'API d'une source est arrêtée | La 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 ressource | Aprè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 indisponible | Le collecteur conserve ses résultats et les envoie plus tard. Un résultat envoyé deux fois n'est enregistré qu'une fois |
| Slack est indisponible | La 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 |