ncc health_checks run_all produit des centaines de lignes puis un tableau. Ce qui compte tient dans quelques blocs, à condition de savoir où regarder et quoi faire de chaque statut.
NCC (Nutanix Cluster Check) est le script de santé qui tourne sur les CVM. La Nutanix Bible le présente comme « a great first step when troubleshooting any cluster issues », et la page Health de Prism Element en affiche l’état. Avant une mise à jour, c’est aussi l’étape qui précède AOS dans la séquence LCM (voir ce billet).
Lancer
Connecté à n’importe quelle CVM :
ncc --version
ncc health_checks run_allLe rapport complet est écrit dans un fichier, à lire après coup :
less /home/nutanix/data/logs/ncc-output-latest.logLe tableau final d’abord
La sortie se termine par un comptage par statut. Exemple publié sur la communauté Nutanix :
+-----------------------+
| State | Count |
+-----------------------+
| Pass | 110 |
| Info | 1 |
| Warning | 5 |
| Fail | 5 |
| Error | 3 |
| Total Plugins | 124 |
+-----------------------+Chaque contrôle apparaît aussi sur une ligne avec son chemin et son verdict, par exemple /health_checks/hypervisor_checks/host_cpu_contention [ WARN ].
Cinq statuts
Définitions de PASS, INFO, WARN et FAIL reprises par Mastering Nutanix :
- PASS : l’aspect testé est sain, aucune action.
- INFO : valeur attendue, mais qui ne s’évalue pas en PASS ou FAIL. Exemple publié sur Qiita en 2017 :
INFO: Only one name server is configured. - WARN : valeur inattendue, à investiguer. Investiguer n’est pas forcément corriger : une licence qui approche de l’expiration sort en WARN.
- FAIL : l’aspect testé n’est pas sain et doit être traité.
- ERR : dans l’exemple publié sur la communauté, le message associé se limite à
ERR : NgtRpcError. Relancez le contrôle seul avant de conclure.
Lire un bloc
Dans le rapport, chaque contrôle non PASS a son bloc. Format relevé sur un fil de la communauté (extrait, IP remplacée, détail des licences omis) :
Detailed information for weekly_pre_expiry:
Node <cvm_ip>:
WARN: The setup has license(s) that are about to expire. Detailed license info:
[...]
Refer to KB 2469 (http://portal.nutanix.com/kb/2469) for details on weekly_pre_expiry
or Recheck with: ncc health_checks system_checks weekly_pre_expiryQuatre informations utiles : le nœud concerné, le message, le KB à lire et la commande pour relancer ce contrôle seul. Un employé Nutanix le résume ainsi : chaque plugin en WARN, INFO, ERR ou FAIL renvoie vers un KB.
Le message peut porter la valeur mesurée et le seuil, ce qui dit tout de suite si l’on est juste au-dessus ou très loin :
WARN: High host CPU utilization on host <host_ip>: 86 (Threshold: 75).Relancer sans tout refaire
Un contrôle, éventuellement sur une seule CVM :
ncc health_checks system_checks weekly_pre_expiry
ncc health_checks network_checks check_ntp --cvm_list=<cvm_ip>Plusieurs contrôles d’un même module :
ncc health_checks system_checks --plugin_list=cluster_version_check,cvm_reboot_checkAprès les corrections, seulement ce qui a échoué au dernier passage :
ncc --rerun_failing_plugins=TrueS’il n’y a plus rien, la réponse est There are no failed plugins in the last NCC run.
NCC se met à jour comme le reste de la pile : la page produit LCM le liste parmi les composants pris en charge, et la séquence de Julien Dumur le met à jour avant AOS.
Ce qu’il faut retenir
ncc health_checks run_alldepuis une CVM ; le rapport est dans/home/nutanix/data/logs/ncc-output-latest.log.- Lisez le tableau final, puis les blocs
Detailed information for: nœud, message, KB, commande de relance. - WARN appelle une analyse, FAIL une correction ; ERR se relance avant d’être interprété.
Recheck withrelance un contrôle,--rerun_failing_plugins=Truetous ceux en échec.
In English
One command, hundreds of checks, five statuses. Where to find the report, how to read a WARN or FAIL block, rerun a single check and confirm a fix took effect. ncc health_checks run_all runs from a CVM and writes its full report to ncc-output-latest.log, and ncc –rerun_failing_plugins=True reruns only the checks that failed last time.
Sources & vérification
Relevé sur : Documentation publique (Nutanix Bible, next.nutanix.com) et blogs cités, relevé 2026-10
- Nutanix Bible, AOS Administration nutanixbible.com
- Nutanix Bible, Prism Navigation nutanixbible.com
- Nutanix Community, Cluster management-useful commands (2021) next.nutanix.com
- Nutanix Community, Prism Central showing disconnected on Prism Elements (2026) next.nutanix.com
- Nutanix Community, Nutanix Guest Tools dead. Restarting. (2024) next.nutanix.com
- vInception, Run the NCC health check and collect the output (2020) vinception.fr
- Mastering Nutanix, How to Verify Nutanix cluster health status (2020) masteringnutanix.com
- Kiran Surya, NCC Health Checks (2018) kirands-nutanixhyperconvergence.blogspot.com
- Qiita, NCCについて (2017) qiita.com
- Julien Dumur, Nutanix AHV – master your updates with LCM (2024) juliendumur.fr
- Nutanix, Life Cycle Manager (LCM) nutanix.com