Aller au contenu principal
Version : 0.4 · actuelle

Fonctionnement du collecteur

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

Le collecteur est la partie d'Excubius qui atteint vos systèmes. Il exécute les vérifications du catalogue sur des connexions en lecture seule, lit les sources que vous ajoutez et envoie les résultats bruts à l'API, qui les évalue, déclenche les alertes et envoie les notifications. Cet article explique son fonctionnement, les transports qu'il utilise, ce dont chaque module a besoin, les chemins réseau à ouvrir et ce qu'il ne fait jamais.

Comment une vérification s'exécute​

  1. Toutes les 30 secondes, le collecteur demande à l'API ce qu'il doit exécuter : les définitions des vérifications du catalogue, les ressources qu'elles ciblent et les informations d'identification qu'elles utilisent. Lorsque rien n'a changé, la réponse est vide et ne coûte presque rien.
  2. Il exécute chaque vérification selon son intervalle, sur le transport indiqué par le catalogue, comme T-SQL pour une instance SQL Server ou HTTP pour un point de terminaison web.
  3. Il envoie les résultats bruts à l'API par lots. L'API les compare aux seuils effectifs, ouvre et résout les alertes et prévient les bons canaux.
  4. Toutes les 10 secondes, il récupère les tâches ponctuelles, comme Test connection, Discover, ainsi que Test et Sync now d'une source. Toutes les 60 secondes, il signale une pulsation, que la zone Sources du tableau de bord Overview affiche.

Le collecteur s'exécute dans le serveur Excubius, à côté de l'API. Il ne reçoit que son propre jeton et ses propres paramètres ; il ne voit jamais le mot de passe de la base de données ni la clé qui chiffre les secrets stockés. Les informations d'identification lui parviennent par le réseau interne, restent en mémoire et ne sont jamais journalisées.

Transports​

Un transport est la façon dont le collecteur communique avec un type de système. Chacun ne fait que lire.

TransportAtteintPortType d'informations d'identificationÉtat
T-SQL (Microsoft ODBC Driver 18)Les instances SQL Server, les groupes de disponibilité, les serveurs liés, le journal d'exécution de Reporting Services1433 ou le port de l'instance ; UDP 1434 pour les instances nommées sans port fixeConnexion SQLPris en charge
HTTP(S)Les points de terminaison web, les portails Reporting Services, les certificats TLS, l'expiration des domaines (RDAP)443, 80Aucune, compte Windows (NTLM), utilisateur et mot de passe HTTP, jeton du porteurPris en charge
DNSLa résolution de noms des points de terminaison et des écouteurs de groupes de disponibilité, avec le résolveur du serveur53AucunePris en charge
Azure Resource GraphLes vérifications de posture cloud, les évaluations de Defender for Cloud, Azure Update Manager, Service Health443L'identité managée du serveur ou un principal de service AzurePris en charge
Microsoft GraphLes vérifications d'identité Entra ID443L'identité managée du serveur ou un principal de service AzurePris en charge
WazuhL'indexeur Wazuh et, facultativement, l'API du gestionnaireLes URL que vous définissezUtilisateur et mot de passe HTTPPris en charge lorsque Wazuh est activé
WinRMLes vérifications d'hôtes Windows, les vérifications Active Directory5986 (HTTPS)Compte WindowsExpérimental
SSHLes vérifications d'hôtes Linux22, ou le ssh_port de l'hôteClé SSH, mot de passe SSHExpérimental
PostgreSQLLes vérifications du module PostgreSQL5432Connexion SQLPas encore disponible : les vérifications sont ajoutées mais restent à l'état Inconnu
attention

Les transports WinRM et SSH existent et leurs vérifications sont ajoutées aux hôtes Windows et Linux, mais ils n'ont pas encore été validés sur des hôtes réels. Pour ces hôtes, utilisez NinjaOne, New Relic ou Azure Monitor comme source jusqu'à ce qu'une version les indique comme pris en charge.

Le collecteur lit aussi les sources, via HTTPS (443), chacune avec son propre adaptateur : New Relic via NerdGraph, NinjaOne via son API publique, et Azure Monitor via Azure Resource Manager, Resource Graph, Azure Monitor, Data Factory, Key Vault et Microsoft Graph. Consultez Sources.

Par défaut, le collecteur propose tous les transports dont les bibliothèques sont présentes dans son image. EXCUBIUS_COLLECTOR_TRANSPORTS restreint cette liste ; consultez Variables d'environnement.

Ce dont chaque module a besoin​

ModuleCollecté viaCe que vous fournissez
SQL Server, groupes de disponibilité, sécurité SQL ServerT-SQLUne connexion SQL en lecture seule sur chaque instance et chaque réplica
WindowsWinRM (expérimental), ou New Relic et NinjaOneUn compte Windows membre de trois groupes locaux de lecture, ou une source
LinuxSSH (expérimental), ou New Relic et NinjaOneUn utilisateur non root avec une clé, ou une source
PostgreSQLPas encore disponible en natif ; serveurs flexibles Azure via Azure MonitorUn rôle avec pg_monitor, prêt pour l'arrivée de la collecte
Azure, Azure Data FactoryLa source Azure MonitorReader et Monitoring Reader, plus un rôle Data Factory en lecture seule
Tests synthétiquesHTTP, DNS, T-SQLDes informations d'identification uniquement pour les points de terminaison protégés et les serveurs de rapports
ExpirationsAzure Monitor, HTTP (RDAP), T-SQL, WinRMDes autorisations de lecture Key Vault et Microsoft Graph
Mises à jourLes flux des éditeurs lus par l'API, plus des vérifications d'inventaireUn accès HTTPS sortant du serveur vers les flux
Sécurité des identitésMicrosoft Graph, WinRMDes autorisations d'application Graph en lecture seule
Sécurité du cloudResource Graph, Defender for Cloud, WazuhReader et Security Reader ; un utilisateur Wazuh en lecture seule
New Relic, NinjaOneLeur sourceUne clé ou un client d'API en lecture seule

Toutes les autorisations au même endroit : Autorisations.

Chemins réseau​

Chaque connexion part du serveur Excubius. Rien ne se connecte au collecteur.

VersPortPour
Chaque instance SQL Server, réplica, nom d'écouteur et adresse IP d'écouteurLe port SQL, 1433 par défautLes modules SQL Server, les groupes de disponibilité, les allers-retours SQL synthétiques
Les instances nommées sans port fixeUDP 1434SQL Server Browser
Les points de terminaison web et les portails Reporting Services443, 80Les tests synthétiques, les certificats TLS
Le résolveur DNS du serveur53Les vérifications de résolution de noms
data.iana.org et les serveurs RDAP des registres443L'expiration des domaines
Les hôtes Windows5986WinRM (expérimental)
Les hôtes Linux22SSH (expérimental)
management.azure.com, graph.microsoft.com, vos coffres de clés (*.vault.azure.net) et login.microsoftonline.com lorsque vous utilisez un principal de service443La source Azure Monitor, les vérifications de posture et d'identité Azure
api.newrelic.com ou api.eu.newrelic.com443La source New Relic
app.ninjarmm.com, ou eu., oc. ou ca.ninjarmm.com443La source NinjaOne
L'indexeur et le gestionnaire WazuhLeurs portsWazuh

C'est l'API, et non le collecteur, qui récupère les flux de mises à jour et communique avec Slack et Jira ; consultez Variables d'environnement. Les webhooks des sources arrivent sur l'adresse publique du serveur, sur le port 443, et sont transmis à l'API, jamais au collecteur.

Limites et délais d'expiration​

LimiteValeur
Vérifications exécutées simultanément32 au total ; par transport : T-SQL 8, HTTP et DNS 16, SSH 8, WinRM 4, Resource Graph 4, Defender, Microsoft Graph et Wazuh 2
Délai de connexion SQL Server · délai de requête10 s · 30 s (paramètres de catalogue timeout_seconds, query_timeout_seconds)
Lignes lues par requête1 000
Durée maximale d'exécution d'une vérification120 s
Résultats conservés tant que l'API est inaccessible10 000 ; les plus anciens sont supprimés en premier

Les sessions SQL Server portent le nom d'application monitoring-collector ; les administrateurs de bases de données peuvent ainsi les reconnaître dans sys.dm_exec_sessions.

Ce que le collecteur ne fait jamais​

Le collecteur est en lecture seule par son provisionnement et par son code. Il n'installe, ne met à jour, ne redémarre et n'arrête jamais rien, n'écrit jamais de données, de registre ni de configuration, ne met jamais fin à une session et n'exécute jamais de correction. Une vérification qui nécessiterait une écriture est rejetée lors de son examen pour le catalogue.

Voici ce qu'il envoie :

  • SQL Server : des SELECT sur les vues de gestion dynamique, les vues de catalogue, les tables de sauvegarde et de travaux de msdb et la table ExecutionLog3 du serveur de rapports ; sys.sp_readerrorlog dans une variable de table ; sp_testlinkedserver pour les serveurs liés.
  • HTTP : uniquement GET et HEAD.
  • Azure et Wazuh : des lectures, plus les quelques requêtes POST qui sont des requêtes de consultation, comme une requête Resource Graph, une requête sur les exécutions de Data Factory ou un _search Wazuh. Tout le reste est refusé dans le code.
  • WinRM et SSH : les commandes PowerShell et shell écrites dans le catalogue, qui ne font que lire.

La requête exacte de chaque vérification se trouve dans le catalogue et dans l'API, à l'adresse GET /api/v1/catalog/checks/{id}.

Agents des sources facultatives​

Excubius n'installe rien sur les systèmes qu'il surveille. Les agents des sources facultatives, comme Wazuh, sont déployés par vos propres outils, par exemple NinjaOne ou votre outil de gestion de la configuration.

Étapes suivantes​