> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/fr/administration-systeme/node-diagnostics.md). # Guide de diagnostic des nœuds ## Vue d'ensemble L’outil de diagnostic des nœuds fournit des capacités complètes de dépannage matériel et au niveau système pour des nœuds VergeOS individuels. Ces commandes de diagnostic permettent aux administrateurs système d’effectuer des analyses matérielles détaillées, de surveiller les performances du système et de résoudre directement depuis l’interface VergeOS les problèmes spécifiques au nœud. {% hint style="info" %} **Ce que vous apprendrez** * Comment accéder et utiliser les outils de diagnostic des nœuds * Compréhension de chaque commande de diagnostic et de son domaine matériel * Bonnes pratiques pour le dépannage au niveau du nœud * Quand utiliser des commandes de diagnostic spécifiques pour les problèmes matériels {% endhint %} ## Prérequis * Accès à l’interface VergeOS avec des privilèges de gestion des nœuds * Compréhension de base des composants matériels du serveur * Connaissance des concepts de réseau et de stockage {% hint style="info" %} **Accès au nœud** Les diagnostics des nœuds offrent un accès approfondi au niveau matériel et doivent être utilisés par des administrateurs système expérimentés. {% endhint %} ## Accès aux diagnostics du nœud 1. **Accédez à Diagnostics du nœud :** * Sélectionnez **Infrastructure** > **Nœuds** dans le menu supérieur. * Sélectionnez le **nœud** dans la liste * Cliquez sur **Diagnostics** dans le menu de gauche 2. **Utilisation des commandes de diagnostic :** * Sélectionnez la commande souhaitée dans le **Requête** menu déroulant * Configurez les paramètres disponibles sur le côté droit * Cliquez sur **Envoyer →** pour exécuter la commande {% hint style="success" %} **Visibilité de la commande** Activez **« Afficher la commande »** pour afficher la commande exacte exécutée, utile pour une exécution via SSH ou l'automatisation de scripts. {% endhint %} ## Référence des commandes de diagnostic ### Analyse ARP **Objectif :** Découvre les périphériques actifs sur les interfaces réseau du nœud à l’aide de paquets ARP. **Quand l'utiliser :** * Vérification de la connectivité réseau du point de vue du nœud * Identification des périphériques sur les segments réseau locaux du nœud * Dépannage de la configuration réseau du nœud **Paramètres :** * **Interface :** Interface réseau à analyser **Syntaxe CLI :** ```bash nmap -sn [NETWORK_RANGE] ``` *** ### Table ARP **Objectif :** Affiche le cache ARP du nœud, montrant les correspondances entre adresses IP et adresses MAC. **Quand l'utiliser :** * Dépannage de la connectivité réseau du nœud * Vérification de la découverte des voisins réseau * Vérification des conflits ARP affectant le nœud **Syntaxe CLI :** ```bash arp -a ``` *** ### Adresses du pont **Objectif :** Affiche les tables d’adresses MAC pour les ponts réseau du nœud. **Quand l'utiliser :** * Dépannage de la configuration du pont réseau * Vérification de l’apprentissage des adresses MAC sur les commutateurs virtuels * Analyse de la topologie réseau **Syntaxe CLI :** ```bash brctl showmacs [BRIDGE_NAME] ``` *** ### Effacer le stockage persistant **Objectif :** Efface les caches de stockage persistant et les données temporaires sur le nœud. **Quand l'utiliser :** * Résolution des problèmes de performance liés au stockage * Suppression des données de cache corrompues * Préparation à la reconfiguration du stockage {% hint style="danger" %} **Avertissement d’impact sur les données** Cette commande peut affecter les performances du système et ne doit être utilisée que sous la guidance du support. {% endhint %} **Syntaxe CLI :** ```bash sync && echo 3 > /proc/sys/vm/drop_caches ``` *** ### Table DMI **Objectif :** Affiche les informations de l’interface Desktop Management Interface (DMI), y compris les détails matériels. **Quand l'utiliser :** * Inventaire et identification du matériel * Vérification des spécifications du système * Dépannage de la compatibilité matérielle **Syntaxe CLI :** ```bash dmidecode ``` *** ### Recherche DNS **Objectif :** Teste la résolution DNS du point de vue du nœud. **Quand l'utiliser :** * Dépannage de la configuration DNS du nœud * Vérification de la connectivité externe depuis le nœud * Test des services de résolution de noms **Paramètres :** * **Nom d'hôte :** Nom d'hôte cible à résoudre * **Serveur DNS :** Serveur DNS spécifique à interroger **Syntaxe CLI :** ```bash nslookup [HOSTNAME] dig [HOSTNAME] ``` *** ### l’outil Ethernet **Objectif :** Fournit des informations détaillées et la configuration de l’interface Ethernet. **Quand l'utiliser :** * Diagnostic des problèmes d’interface réseau * Vérification de la vitesse du lien et des paramètres duplex * Dépannage de la connectivité réseau physique **Paramètres :** * **Interface :** Interface réseau à examiner **Syntaxe CLI :** ```bash ethtool [INTERFACE] ``` *** ### Configuration de la fabric **Objectif :** Affiche la configuration du réseau fabric VergeOS pour le nœud. **Quand l'utiliser :** * Dépannage de la communication entre nœuds * Vérification de la configuration du réseau fabric * Diagnostic des problèmes de connectivité du cluster **Syntaxe CLI :** ```bash verge fabric show ``` *** ### IP **Objectif :** Accès avancé à la commande IP pour le diagnostic des interfaces et du routage. **Quand l'utiliser :** * Analyse détaillée de l’interface réseau * Examen de la table de routage * Dépannage réseau avancé **Paramètres :** * **Commande :** Options de la commande IP (route, addr, link, etc.) **Syntaxe CLI :** ```bash ip [COMMAND] [OPTIONS] ``` *** ### Infos IPMI BMC **Objectif :** Affiche les informations du contrôleur de gestion de la carte mère. **Quand l'utiliser :** * Dépannage de la gestion matérielle * Vérification de la configuration IPMI * Diagnostic de la gestion à distance **Syntaxe CLI :** ```bash ipmitool bmc info ``` *** ### État du châssis IPMI **Objectif :** Affiche l’état physique du châssis et les informations d’alimentation. **Quand l'utiliser :** * Dépannage de la gestion de l’alimentation * Vérification de l’état du matériel * Diagnostic du système physique **Syntaxe CLI :** ```bash ipmitool chassis status ``` *** ### Infos FRU IPMI **Objectif :** Affiche les informations d’unités remplaçables sur site depuis IPMI. **Quand l'utiliser :** * Gestion de l’inventaire matériel * Identification des composants * Informations de garantie et de support **Syntaxe CLI :** ```bash ipmitool fru print ``` *** ### Infos LAN IPMI **Objectif :** Affiche les détails de configuration réseau IPMI. **Quand l'utiliser :** * Dépannage du réseau IPMI * Problèmes de connectivité de la gestion à distance * Vérification de la configuration réseau du BMC **Syntaxe CLI :** ```bash ipmitool lan print ``` *** ### Réinitialisation MC IPMI **Objectif :** Réinitialise le contrôleur de gestion (BMC). **Quand l'utiliser :** * Résolution des problèmes de communication IPMI * Dépannage du BMC * Restauration de l’interface de gestion {% hint style="warning" %} **Impact sur la gestion** Cela perturbera temporairement la fonctionnalité IPMI/BMC pendant la réinitialisation. {% endhint %} **Syntaxe CLI :** ```bash ipmitool mc reset cold ``` *** ### Référentiel de données des capteurs IPMI **Objectif :** Affiche des informations complètes du référentiel de données des capteurs. **Quand l'utiliser :** * Surveillance matérielle détaillée * Vérification de la configuration des capteurs * Diagnostic et analyse du matériel **Syntaxe CLI :** ```bash ipmitool sdr list ``` *** ### Capteurs IPMI **Objectif :** Affiche les relevés actuels des capteurs (température, tension, ventilateurs, etc.). **Quand l'utiliser :** * Surveillance de l’état du matériel * Diagnostic de la température et de l’alimentation * Dépannage environnemental **Syntaxe CLI :** ```bash ipmitool sensor list ``` *** ### Journaux des événements système IPMI **Objectif :** Affiche les journaux des événements système depuis IPMI. **Quand l'utiliser :** * Analyse des erreurs matérielles * Dépannage des événements système * Investigation des problèmes matériels historiques **Syntaxe CLI :** ```bash ipmitool sel list ``` *** ### Contrôle des LED (disque) **Objectif :** Contrôle les voyants LED sur les disques de stockage pour l’identification physique. **Quand l'utiliser :** * Identification physique du disque * Procédures de remplacement des disques * Tâches de maintenance matérielle **Paramètres :** * **Disque :** Identifiant du disque cible * **Action :** LED allumée/éteinte/clignotante **Syntaxe CLI :** ```bash ledctl locate=[DRIVE_PATH] ``` *** ### Journaux **Objectif :** Affiche les journaux système et les entrées du journal du nœud. **Quand l'utiliser :** * Dépannage du système * Analyse des erreurs * Investigation des problèmes de performance **Syntaxe CLI :** ```bash journalctl -n 100 dmesg ``` *** ### Bonding réseau **Objectif :** Affiche la configuration et l’état du bonding réseau. **Quand l'utiliser :** * Dépannage de la redondance réseau * Diagnostic de l’interface bond * Vérification de l’agrégation de liens **Syntaxe CLI :** ```bash cat /proc/net/bonding/[BOND_NAME] ``` *** ### Vitesse OpenSSL **Objectif :** Teste les performances cryptographiques du processeur du nœud. **Quand l'utiliser :** * Référence de performance * Test des capacités cryptographiques * Vérification de l’accélération matérielle **Syntaxe CLI :** ```bash openssl speed ``` *** ### Ping **Objectif :** Teste la connectivité réseau depuis le nœud. **Quand l'utiliser :** * Test de connectivité de base * Vérification du chemin réseau * Mesure de la latence **Paramètres :** * **Destination :** IP ou nom d’hôte cible * **Nombre :** Nombre de paquets ping **Syntaxe CLI :** ```bash ping -c [COUNT] [DESTINATION] ``` *** ### Requête RAS **Objectif :** Interroge les informations de fiabilité, disponibilité et maintenabilité. **Quand l'utiliser :** * Évaluation de la fiabilité matérielle * État de correction d’erreurs * Diagnostic de la mémoire et du processeur **Syntaxe CLI :** ```bash ras-mc-ctl --summary ``` *** ### Test de diagnostic S.M.A.R.T. **Objectif :** Lance des tests de diagnostic SMART sur les disques de stockage. **Quand l'utiliser :** * Test préventif de l’état des disques * Dépannage du stockage * Maintenance préventive **Paramètres :** * **Disque :** Disque cible pour le test * **Type de test :** Test court, long ou de transport **Syntaxe CLI :** ```bash smartctl -t [TEST_TYPE] [DRIVE_PATH] ``` {% hint style="info" %} **Durée du test** Les tests SMART peuvent prendre beaucoup de temps, surtout les tests longs. {% endhint %} *** ### Informations S.M.A.R.T. **Objectif :** Affiche les attributs SMART et les informations de santé des disques. **Quand l'utiliser :** * Évaluation de l’état du disque * Analyse prédictive des pannes * Surveillance des performances du stockage **Paramètres :** * **Disque :** Identifiant du disque cible **Syntaxe CLI :** ```bash smartctl -a [DRIVE_PATH] ``` *** ### Afficher les périphériques blocs **Objectif :** Répertorie tous les périphériques blocs visibles par le nœud. **Quand l'utiliser :** * Inventaire des périphériques de stockage * Dépannage de la reconnaissance des disques * Vérification de la configuration du stockage **Syntaxe CLI :** ```bash lsblk fdisk -l ``` *** ### Test de connexion TCP **Objectif :** Teste la connectivité TCP vers des hôtes et ports distants. **Quand l'utiliser :** * Vérification de la connectivité des services * Test des règles de pare-feu * Dépannage réseau **Paramètres :** * **Hôte :** Nom d’hôte ou IP cible * **Port :** Numéro de port TCP **Syntaxe CLI :** ```bash telnet [HOST] [PORT] nc -zv [HOST] [PORT] ``` *** ### Tcpdump **Objectif :** Capture des paquets réseau pour une analyse détaillée du trafic. **Quand l'utiliser :** * Dépannage réseau * Analyse de sécurité * Débogage des protocoles **Paramètres :** * **Interface :** Interface réseau à surveiller * **Filtre :** Expression de filtrage des paquets **Syntaxe CLI :** ```bash tcpdump -i [INTERFACE] [FILTER] ``` {% hint style="warning" %} **Impact sur les performances** La capture de paquets peut affecter les performances du nœud. À utiliser avec prudence en production. {% endhint %} *** ### Utilisation CPU maximale **Objectif :** Affiche les processus consommant le plus de ressources CPU. **Quand l'utiliser :** * Dépannage des performances * Analyse de l'utilisation des ressources * Surveillance des processus **Syntaxe CLI :** ```bash top -o %CPU ``` *** ### Utilisation réseau maximale **Objectif :** Affiche les processus ayant la plus forte utilisation réseau. **Quand l'utiliser :** * Analyse des performances réseau * Dépannage de l'utilisation de la bande passante * Identification des processus gourmands en réseau **Syntaxe CLI :** ```bash iftop nethogs ``` *** ### Traceroute **Objectif :** Trace le chemin réseau du nœud vers une destination. **Quand l'utiliser :** * Dépannage du routage réseau * Analyse du chemin * Diagnostic des problèmes de connectivité **Paramètres :** * **Destination :** IP ou nom d’hôte cible **Syntaxe CLI :** ```bash traceroute [DESTINATION] mtr [DESTINATION] ``` *** ### Quelle est mon IP **Objectif :** Affiche l’adresse IP externe du nœud. **Quand l'utiliser :** * Vérification de la connectivité externe * Dépannage de la configuration NAT * Validation de la configuration réseau **Syntaxe CLI :** ```bash curl ifconfig.me ``` ## Bonnes pratiques ### Flux de travail de diagnostic matériel 1. **Vue d’ensemble du système :** Commencez par la table DMI et l’état du châssis IPMI 2. **Vérification de l’état :** Consultez les capteurs IPMI et les journaux des événements système 3. **Analyse du stockage :** Utilisez les informations et les tests S.M.A.R.T. 4. **Vérification du réseau :** Vérifiez le bonding réseau et l’état des interfaces 5. **Évaluation des performances :** Surveillez l’utilisation du CPU et du réseau ### Maintenance préventive * **Contrôles de santé réguliers :** Surveillez les capteurs IPMI et les données SMART * **Revue des journaux :** Vérifiez régulièrement les journaux des événements système * **Surveillance des performances :** Suivez les tendances d’utilisation du CPU et du réseau * **État des disques :** Planifiez des tests de diagnostic SMART périodiques ### Considérations de sécurité * **Évaluation de l’impact :** Tenez compte de l’impact des commandes de diagnostic sur les systèmes de production * **Coordination avec le support :** Impliquez le support VergeOS pour les problèmes matériels complexes * **Documentation :** Conservez les résultats de diagnostic pour l’analyse des tendances * **Contrôle des changements :** Suivez les procédures de gestion des changements pour les modifications matérielles ## Dépannage des problèmes courants du nœud ### Problèmes matériels 1. Vérifiez **Capteurs IPMI** pour les problèmes de température, de tension et de ventilateurs 2. Examinez **Journaux des événements système IPMI** pour les erreurs matérielles 3. Utilisez **Informations S.M.A.R.T.** pour évaluer l’état des disques ### Problèmes réseau 1. Vérifiez **Bonding réseau** état et configuration 2. Utilisez **l’outil Ethernet** pour vérifier les paramètres de l’interface 3. Tester la connectivité avec **Ping** et **Traceroute** ### Problèmes de performance 1. Surveillez **Utilisation CPU maximale** les contraintes de ressources 2. Vérifiez **Utilisation réseau maximale** l'utilisation de la bande passante 3. Examinez **Journaux** pour les erreurs liées aux performances ### Problèmes de stockage 1. Utilisez **Afficher les périphériques blocs** pour vérifier la reconnaissance des disques 2. Exécuter **Tests de diagnostic S.M.A.R.T.** pour des tests complets des disques 3. Vérifiez **Requête RAS** pour les informations sur les erreurs de mémoire et de stockage ## Étapes suivantes Après avoir maîtrisé les diagnostics des nœuds, envisagez d’explorer : * Surveillance matérielle avancée et alertes * Script de diagnostic automatisé * Intégration avec des systèmes de surveillance externes * Planification de la maintenance préventive Pour les problèmes matériels complexes ou les résultats de diagnostic inhabituels, contactez [Support VergeOS](/overview/fr/support-and-services.md) avec des résultats de diagnostic détaillés et des informations système. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/run-the-platform/fr/administration-systeme/node-diagnostics.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.