Aller au contenu principal
Version : 0.4 · actuelle

Erreurs du collecteur

Résolution des problèmesRévisé le 11 octobre 2026
S'applique à :Excubius 0.4Rôles : Administrateur d'entité, Éditeur, Opérateur
PlansFree · Core · Pro · EnterpriseDéploiementAuto-hébergé

Lorsqu'une vérification ne peut pas s'exécuter, elle signale un type d'erreur au lieu d'une valeur. Le type s'affiche sur la vérification, dans la chronologie de la ressource et dans le résultat de Test connection (tester la connexion), et il permet de cerner la cause. Cet article répertorie chaque type, explique l'alerte Cannot reach et indique ce qu'il faut vérifier pour chaque symptôme, pour les vérifications comme pour les sources.

Types d'erreur​

TypeAffiché commeSignificationCompte pour Cannot reach
unreachableUnreachableErreur réseau, nom non résolu, connexion refusée ou interrompue, échec de la négociation TLSOui
authSign-in refusedÉchec de la connexion SQL, ou la connexion ne peut pas ouvrir la base de données dont elle a besoinOui
timeoutTimed outLa connexion, ou la vérification entière, a pris plus de temps que permisOui
queryQuery failedLe système a répondu, mais l'instruction a échoué, généralement faute d'une autorisationNon
query_timeoutQuery timed outConnexion établie, mais l'instruction a dépassé son délai d'expirationNon
configConfigurationUn élément à corriger dans Excubius : aucun hôte, aucune information d'identification ou une information d'identification du mauvais type, un secret illisibleNon
unsupportedNot supportedLe collecteur ne dispose d'aucun transport pour cette vérificationNon
internalCollector errorUn bogue dans le collecteur ; le message indique oùNon

Une ressource affiche une seule alerte « Cannot reach »​

Symptôme. Une seule alerte critique Cannot reach apparaît sur une ressource, et les autres alertes de la ressource l'indiquent comme cause racine.

Cause. Par défaut, 3 exécutions consécutives d'une vérification de cette ressource ont échoué avec unreachable, auth ou timeout. Au lieu d'une alerte par vérification en échec, Excubius ouvre une seule alerte et retient les notifications des autres alertes de la ressource tant qu'elle reste ouverte. Le nombre d'échecs correspond à EXCUBIUS_UNREACHABLE_AFTER.

Résolution. Corrigez la connexion, puis sélectionnez Test connection sur la ressource pour confirmer. L'alerte se résout d'elle-même dès que les vérifications en échec réussissent de nouveau ; d'ici là, les notifications des autres alertes de la ressource restent en attente.

Les vérifications échouent avec auth​

Cause. Le mot de passe est incorrect ou a expiré, la connexion SQL est désactivée, l'instance n'accepte pas les connexions SQL, ou la connexion n'a pas d'utilisateur dans une base de données qu'une vérification ouvre. Sur un groupe de disponibilité, la connexion peut avoir un SID différent sur le nouveau principal après un basculement.

Résolution. Vérifiez les informations d'identification et que l'instance fonctionne en mode mixte. Sur les groupes de disponibilité, créez la connexion avec le même SID sur chaque réplica ; consultez Prérequis pour les groupes de disponibilité.

Les vérifications échouent avec unreachable ou timeout​

Cause. Le nom d'hôte n'est pas résolu depuis le serveur Excubius, un pare-feu bloque le port, le service est arrêté ou le chemin réseau est lent.

Résolution. Vérifiez le DNS et le pare-feu entre le serveur Excubius et le système, sur le bon port : le port SQL (et UDP 1434 pour les instances nommées sans port fixe), 443 ou 80 pour les points de terminaison web, 5986 pour WinRM, 22 pour SSH. Pour les écouteurs multi-sous-réseaux, autorisez chaque adresse IP de l'écouteur. Consultez Chemins réseau.

Les vérifications échouent avec query​

Cause. Le système a répondu, mais l'instruction a été refusée, presque toujours parce qu'il manque une autorisation à la connexion. Une vérification qui a besoin de msdb ou de CONNECT ANY DATABASE échoue de cette façon tandis que les autres fonctionnent.

Résolution. Sélectionnez Test connection : sur SQL Server, le test répertorie les autorisations de la connexion et ce qui manque. Accordez ce que la page Autorisations indique, et rien de plus.

Les vérifications échouent avec query_timeout​

Cause. L'instruction s'est exécutée plus longtemps que son délai d'expiration, 30 secondes par défaut sur SQL Server, généralement sur une instance fortement chargée.

Résolution. Réessayez plus tard. Si le problème persiste sur une instance chargée, augmentez le paramètre query_timeout_seconds de la vérification pour cette ressource.

Les vérifications échouent avec config​

Cause. Un élément est incomplet dans Excubius : la ressource n'a pas d'hôte, aucune information d'identification ne l'atteint, l'information d'identification est d'un type que la vérification ne peut pas utiliser, ou le secret enregistré ne peut pas être déchiffré parce que EXCUBIUS_DATA_KEY a changé.

Résolution. Modifiez la ressource ou l'information d'identification. Une vérification placée sous un serveur de rapports qui détient un compte Windows a besoin d'une connexion SQL pour ses vérifications T-SQL ; consultez Quelles informations d'identification une ressource utilise. Si les secrets sont illisibles, saisissez-les de nouveau.

Les vérifications échouent avec unsupported ou restent à l'état Inconnu​

Cause. Aucun collecteur ne propose le transport dont la vérification a besoin. EXCUBIUS_COLLECTOR_TRANSPORTS peut l'exclure, ou le transport n'existe pas encore : les vérifications PostgreSQL restent à l'état Inconnu dans cette version.

Résolution. Retirez le transport de la restriction, ou désactivez la vérification sur cette ressource. Consultez Compatibilité.

Un travail se termine par « No collector picked it up »​

Symptôme. Test connection, Discover ou le Test d'une source reste sur waiting for the collector, puis se termine par No collector picked it up.

Cause. Aucun collecteur n'a pris en charge le travail dans les 10 minutes. Le collecteur ne s'exécute pas, n'a pas de jeton (EXCUBIUS_COLLECTOR_TOKEN est vide, et il reste alors inactif) ou ne propose pas le transport. Un travail qu'un collecteur a pris en charge mais dont il n'a pas renvoyé le résultat dans les 15 minutes échoue avec timeout.

Résolution. Vérifiez la dernière pulsation du collecteur dans la zone Sources du tableau de bord Overview. Sur le serveur, avec le compte de service, exécutez <dir>/current/scripts/compose.sh ps et <dir>/current/scripts/compose.sh logs collector.

Erreurs des sources​

Une source affiche sa dernière erreur avec l'un de ces types :

Affiché commeCause habituelleÀ vérifier
Credentials refusedClé ou secret incorrect ou expiré, ou mauvaise régionRemplacez le secret, vérifiez la région ou le centre de données
Missing permissionIl manque un rôle ou une étendueTest indique quelle lecture a échoué ; accordez ce que la page Autorisations indique
Not foundID de compte, organisation ou abonnement incorrectVérifiez les ID sur la source
Rate limitedLa plateforme limite le débit des requêtesAugmentez les intervalles d'interrogation
Unreachable, Timed outLe serveur ne peut pas joindre l'API de la plateformeAutorisez le trafic HTTPS sortant vers la plateforme
Platform errorL'API de la plateforme a répondu par une erreurRéessayez plus tard ; consultez l'état de la plateforme
Secrets unreadableEXCUBIUS_DATA_KEY a changé depuis l'enregistrement des secretsSaisissez-les de nouveau
No collector picked it upLe collecteur ne s'exécute pasConsultez la section précédente
Fraîcheur StaleAucune interrogation réussie pendant trois intervalles, soit au moins 15 minutes ; pour une source en webhook uniquement, rien reçu depuis un jourLe collecteur s'exécute-t-il ? La plateforme envoie-t-elle des webhooks ?
Webhooks RejectedLa source est désactivée ou en mode Polling, ou l'en-tête secret est incorrectVérifiez le mode et l'en-tête que la plateforme envoie