Erreurs du collecteur
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
| Type | Affiché comme | Signification | Compte pour Cannot reach |
|---|---|---|---|
unreachable | Unreachable | Erreur réseau, nom non résolu, connexion refusée ou interrompue, échec de la négociation TLS | Oui |
auth | Sign-in refused | Échec de la connexion SQL, ou la connexion ne peut pas ouvrir la base de données dont elle a besoin | Oui |
timeout | Timed out | La connexion, ou la vérification entière, a pris plus de temps que permis | Oui |
query | Query failed | Le système a répondu, mais l'instruction a échoué, généralement faute d'une autorisation | Non |
query_timeout | Query timed out | Connexion établie, mais l'instruction a dépassé son délai d'expiration | Non |
config | Configuration | Un élément à corriger dans Excubius : aucun hôte, aucune information d'identification ou une information d'identification du mauvais type, un secret illisible | Non |
unsupported | Not supported | Le collecteur ne dispose d'aucun transport pour cette vérification | Non |
internal | Collector error | Un 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é comme | Cause habituelle | À vérifier |
|---|---|---|
| Credentials refused | Clé ou secret incorrect ou expiré, ou mauvaise région | Remplacez le secret, vérifiez la région ou le centre de données |
| Missing permission | Il manque un rôle ou une étendue | Test indique quelle lecture a échoué ; accordez ce que la page Autorisations indique |
| Not found | ID de compte, organisation ou abonnement incorrect | Vérifiez les ID sur la source |
| Rate limited | La plateforme limite le débit des requêtes | Augmentez les intervalles d'interrogation |
| Unreachable, Timed out | Le serveur ne peut pas joindre l'API de la plateforme | Autorisez le trafic HTTPS sortant vers la plateforme |
| Platform error | L'API de la plateforme a répondu par une erreur | Réessayez plus tard ; consultez l'état de la plateforme |
| Secrets unreadable | EXCUBIUS_DATA_KEY a changé depuis l'enregistrement des secrets | Saisissez-les de nouveau |
| No collector picked it up | Le collecteur ne s'exécute pas | Consultez la section précédente |
| Fraîcheur Stale | Aucune interrogation réussie pendant trois intervalles, soit au moins 15 minutes ; pour une source en webhook uniquement, rien reçu depuis un jour | Le collecteur s'exécute-t-il ? La plateforme envoie-t-elle des webhooks ? |
| Webhooks Rejected | La source est désactivée ou en mode Polling, ou l'en-tête secret est incorrect | Vérifiez le mode et l'en-tête que la plateforme envoie |