Fonctionnement du collecteur
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
- 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.
- 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.
- 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.
- 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.
| Transport | Atteint | Port | Type 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 Services | 1433 ou le port de l'instance ; UDP 1434 pour les instances nommées sans port fixe | Connexion SQL | Pris en charge |
| HTTP(S) | Les points de terminaison web, les portails Reporting Services, les certificats TLS, l'expiration des domaines (RDAP) | 443, 80 | Aucune, compte Windows (NTLM), utilisateur et mot de passe HTTP, jeton du porteur | Pris en charge |
| DNS | La résolution de noms des points de terminaison et des écouteurs de groupes de disponibilité, avec le résolveur du serveur | 53 | Aucune | Pris en charge |
| Azure Resource Graph | Les vérifications de posture cloud, les évaluations de Defender for Cloud, Azure Update Manager, Service Health | 443 | L'identité managée du serveur ou un principal de service Azure | Pris en charge |
| Microsoft Graph | Les vérifications d'identité Entra ID | 443 | L'identité managée du serveur ou un principal de service Azure | Pris en charge |
| Wazuh | L'indexeur Wazuh et, facultativement, l'API du gestionnaire | Les URL que vous définissez | Utilisateur et mot de passe HTTP | Pris en charge lorsque Wazuh est activé |
| WinRM | Les vérifications d'hôtes Windows, les vérifications Active Directory | 5986 (HTTPS) | Compte Windows | Expérimental |
| SSH | Les vérifications d'hôtes Linux | 22, ou le ssh_port de l'hôte | Clé SSH, mot de passe SSH | Expérimental |
| PostgreSQL | Les vérifications du module PostgreSQL | 5432 | Connexion SQL | Pas encore disponible : les vérifications sont ajoutées mais restent à l'état Inconnu |
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
| Module | Collecté via | Ce que vous fournissez |
|---|---|---|
| SQL Server, groupes de disponibilité, sécurité SQL Server | T-SQL | Une connexion SQL en lecture seule sur chaque instance et chaque réplica |
| Windows | WinRM (expérimental), ou New Relic et NinjaOne | Un compte Windows membre de trois groupes locaux de lecture, ou une source |
| Linux | SSH (expérimental), ou New Relic et NinjaOne | Un utilisateur non root avec une clé, ou une source |
| PostgreSQL | Pas encore disponible en natif ; serveurs flexibles Azure via Azure Monitor | Un rôle avec pg_monitor, prêt pour l'arrivée de la collecte |
| Azure, Azure Data Factory | La source Azure Monitor | Reader et Monitoring Reader, plus un rôle Data Factory en lecture seule |
| Tests synthétiques | HTTP, DNS, T-SQL | Des informations d'identification uniquement pour les points de terminaison protégés et les serveurs de rapports |
| Expirations | Azure Monitor, HTTP (RDAP), T-SQL, WinRM | Des autorisations de lecture Key Vault et Microsoft Graph |
| Mises à jour | Les flux des éditeurs lus par l'API, plus des vérifications d'inventaire | Un accès HTTPS sortant du serveur vers les flux |
| Sécurité des identités | Microsoft Graph, WinRM | Des autorisations d'application Graph en lecture seule |
| Sécurité du cloud | Resource Graph, Defender for Cloud, Wazuh | Reader et Security Reader ; un utilisateur Wazuh en lecture seule |
| New Relic, NinjaOne | Leur source | Une 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.
| Vers | Port | Pour |
|---|---|---|
| Chaque instance SQL Server, réplica, nom d'écouteur et adresse IP d'écouteur | Le port SQL, 1433 par défaut | Les modules SQL Server, les groupes de disponibilité, les allers-retours SQL synthétiques |
| Les instances nommées sans port fixe | UDP 1434 | SQL Server Browser |
| Les points de terminaison web et les portails Reporting Services | 443, 80 | Les tests synthétiques, les certificats TLS |
| Le résolveur DNS du serveur | 53 | Les vérifications de résolution de noms |
data.iana.org et les serveurs RDAP des registres | 443 | L'expiration des domaines |
| Les hôtes Windows | 5986 | WinRM (expérimental) |
| Les hôtes Linux | 22 | SSH (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 service | 443 | La source Azure Monitor, les vérifications de posture et d'identité Azure |
api.newrelic.com ou api.eu.newrelic.com | 443 | La source New Relic |
app.ninjarmm.com, ou eu., oc. ou ca.ninjarmm.com | 443 | La source NinjaOne |
| L'indexeur et le gestionnaire Wazuh | Leurs ports | Wazuh |
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
| Limite | Valeur |
|---|---|
| Vérifications exécutées simultanément | 32 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ête | 10 s · 30 s (paramètres de catalogue timeout_seconds, query_timeout_seconds) |
| Lignes lues par requête | 1 000 |
| Durée maximale d'exécution d'une vérification | 120 s |
| Résultats conservés tant que l'API est inaccessible | 10 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
SELECTsur les vues de gestion dynamique, les vues de catalogue, les tables de sauvegarde et de travaux demsdbet la tableExecutionLog3du serveur de rapports ;sys.sp_readerrorlogdans une variable de table ;sp_testlinkedserverpour les serveurs liés. - HTTP : uniquement
GETetHEAD. - Azure et Wazuh : des lectures, plus les quelques requêtes
POSTqui sont des requêtes de consultation, comme une requête Resource Graph, une requête sur les exécutions de Data Factory ou un_searchWazuh. 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.