GUIDE TECHNIQUE · CENTREON
Diagnostiquer un service UNKNOWN dans Centreon
Diagnostiquer un service UNKNOWN Centreon en reproduisant la commande réelle sur le poller, en séparant erreurs de collecte, de plugin, de macros et d'authentification. UNKNOWN ne signifie pas nécessairement une panne métier.
01 · CADRAGE
Ce que vous allez mettre en place
Diagnostiquer un service UNKNOWN Centreon en reproduisant la commande réelle sur le poller, en séparant erreurs de collecte, de plugin, de macros et d'authentification. UNKNOWN ne signifie pas nécessairement une panne métier.
Pour qui : Administrateurs, équipes observabilité et exploitation
Centreon Platform et version des plugins réellement installée sur le poller. Les chemins, modes et messages de sortie dépendent du connecteur choisi.
Vérifiez la compatibilité avec votre environnement réel. Les versions ne sont jamais présumées identiques d’un tenant à l’autre.
02 · AVANT DE COMMENCER
Prérequis et points de contrôle
- Droit de lecture de Resources Status et de la configuration du service.
- Accès autorisé au poller ou relais avec compte centreon-engine.
- Possibilité de copier la commande du dernier check sans divulguer les secrets.
- Connaissance du mode de collecte (SNMPv3, SSH, agent, API) et du plugin installé.
03 · VUE D’ENSEMBLE
Comprendre l’architecture et les flux
Illustration éditoriale validée ADN Consulting, distincte d’une capture de console.
Source : ADN Consulting04 · TUTORIEL
Procédure complète, étape par étape
Chaque étape explique l’action, sa raison, le contrôle attendu et les erreurs habituelles. Adaptez les exemples aux paramètres de votre propre environnement.
ÉTAPE 1 / 5
Trouver le check en défaut
UNKNOWN correspond au code de retour 3 ; son message précis oriente la recherche.
- Dans Monitoring > Resource Status, filtrer UNKNOWN puis afficher Details.
- Relever le poller, l'heure, la commande de check et les sorties complètes.
- Distinguer absence de mesure et défaillance métier confirmée.
# Codes plugins usuels : 0=OK 1=WARNING 2=CRITICAL 3=UNKNOWN.
# Copier la vraie commande depuis les détails Centreon.À vérifier : La commande exécutée et le message UNKNOWN sont identifiés.
Point de vigilance ADN : Ne concluez pas à la panne de l'application sans mesure indépendante.
ÉTAPE 2 / 5
Distinguer cible et collecteur
La sortie d'un plugin dépend des droits et du chemin réseau du poller, pas du poste de l'administrateur.
- Ouvrir une session sur le poller concerné avec autorisation.
- Passer sous l'utilisateur d'exécution centreon-engine et rejouer la commande de check copiée.
- Conserver stdout, stderr et le code retour ; ne pas afficher de secret en clair dans une capture.
sudo -iu centreon-engine
# Dans cette session, exécuter la commande copiée des détails du service.
# Immédiatement après :
echo $?À vérifier : Le même dysfonctionnement est reproductible depuis le poller et le code retour est relevé.
Point de vigilance ADN : Les macros de mot de passe masquées dans l'interface doivent être résolues dans un environnement de test protégé.
ÉTAPE 3 / 5
Contrôler la commande de check
Un échec réseau ou DNS est différent d'une erreur d'arguments du plugin.
- Depuis le poller, comparer DNS, routage et port du protocole configuré.
- Pour SNMPv3, confirmer version, algorithmes et permissions sans consigner la clé.
- Comparer le même flux depuis un autre poller si le diagnostic le justifie.
getent hosts HOTE_CIBLE
# Exemple TCP uniquement, remplacer PORT_TCP si ce protocole s'applique :
# nc -vz HOTE_CIBLE PORT_TCP
# SNMP utilise généralement UDP ; ne pas interpréter un test TCP comme un test SNMP.À vérifier : La connectivité propre au protocole de supervision est validée ou exclue.
Point de vigilance ADN : Un ping réussi ne suffit pas à vérifier SNMP, API ou SSH.
ÉTAPE 4 / 5
Vérifier le protocole utilisé
Un paramètre ou une macro vide peut produire UNKNOWN malgré un réseau fonctionnel.
- Comparer la commande, ses arguments et macros héritées dans le service et le template.
- Vérifier l'aide du mode installé et la compatibilité du pack avec le plugin déployé.
- Vérifier aussi la whitelist des commandes, si elle est activée sur ce poller.
# Exemple : depuis le poller, exécuter le plugin concerné avec --help
# Le nom et le mode doivent correspondre à ceux du dernier check.À vérifier : L'erreur de syntaxe, de macro ou de plugin est identifiée ou exclue.
Point de vigilance ADN : Ne copiez pas une commande d'un autre plugin pack sans en vérifier le mode.
ÉTAPE 5 / 5
Corriger puis déployer
La correction ne vaut que si le poller la reçoit et qu'un nouveau check produit une sortie exploitable.
- Corriger macros, accès ou plugin sur le périmètre justifié.
- Exporter/recharger la configuration si elle a été modifiée.
- Effectuer un nouveau check et vérifier le retour 0/1/2, cohérent avec la mesure source.
# Dans Centreon : export du poller, puis forcer un check autorisé.
# Documenter la commande, son code de retour et la valeur mesurée.À vérifier : UNKNOWN disparaît avec un résultat de check cohérent et documenté.
Point de vigilance ADN : Une transition vers OK sans retour de données fiables n'est pas un diagnostic terminé.
05 · RECETTE
Comment vérifier que tout fonctionne ?
Message UNKNOWN et commande réelle enregistrés sans secret.
Check rejoué sous l'utilisateur centreon-engine du poller concerné.
DNS, flux et authentification vérifiés selon protocole réel.
Arguments, macros et plugin compatibles ; sortie/exit code interprétés.
Correction réexportée et nouvelle mesure valide obtenue.
06 · DIAGNOSTIC
Problèmes fréquents et résolution
UNKNOWN: plugin not found
Cause probable : Chemin de binaire ou paquet incorrect
Que faire : Vérifier paquet/plugin présent, permissions et path de commande.
UNKNOWN: option inconnue
Cause probable : Mauvais mode/plugin ou macro qui produit un argument invalide
Que faire : Exécuter --help sous centreon-engine et comparer.
SNMP timeout
Cause probable : UDP/161, ACL, SNMPv3 ou politique réseau
Que faire : Contrôler depuis le poller, pas depuis le poste local.
UNKNOWN intermittent
Cause probable : Timeout, latence ou saturation du poller
Que faire : Comparer temps d'exécution, retries et charge du poller.
Le conseil de l’expert ADN
Avant de généraliser cette configuration, validez-la sur un périmètre représentatif, documentez les critères de réussite et conservez une procédure de retour arrière. Une instrumentation utile se juge sur les données effectivement exploitables, pas sur la seule installation de l’outil.
07 · QUESTIONS PRATIQUES
Questions fréquentes
UNKNOWN est-il équivalent à DOWN ?
Non : UNKNOWN signifie que le contrôle ne produit pas un résultat interprétable. La santé métier doit être confirmée par d'autres sources.
Faut-il relancer tout Centreon ?
Non ; corriger puis exporter/recharger uniquement la configuration nécessaire après validation.