> 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

Référence complète pour les outils de diagnostic des nœuds VergeOS, y compris les commandes IPMI, les tests SMART, les diagnostics réseau, la configuration du tissu et le dépannage matériel.

## Vue d’ensemble

L’outil de diagnostic des nœuds fournit des fonctionnalités complètes de dépannage matériel et système pour chaque nœud VergeOS. Ces commandes de diagnostic permettent aux administrateurs système d’effectuer une analyse détaillée du matériel, de surveiller les performances du système et de résoudre les problèmes propres à un nœud directement depuis l’interface VergeOS.

{% hint style="info" %}
**Ce que vous allez apprendre**

* Comment accéder aux outils de diagnostic des nœuds et les utiliser
* Comprendre chaque commande de diagnostic et le matériel auquel elle s’applique
* Bonnes pratiques pour le dépannage au niveau des nœuds
* Quand utiliser certaines commandes de diagnostic pour résoudre des problèmes matériels
  {% endhint %}

## Prérequis

* Accès à l’interface VergeOS avec des privilèges de gestion des nœuds
* Connaissances de base des composants matériels d’un serveur
* Connaissance des concepts de réseau et de stockage

{% hint style="info" %}
**Accès aux nœuds**

Les diagnostics des nœuds donnent un accès approfondi au matériel et doivent être utilisés par des administrateurs système expérimentés.
{% endhint %}

## Accéder aux diagnostics des nœuds

1. **Accédez aux diagnostics des nœuds :**
   * 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. **Utiliser les 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 **Envoyer →** pour exécuter la commande

{% hint style="success" %}
**Visibilité des commandes**

Activer **« Afficher la commande »** pour voir la commande exacte en cours d’exécution, ce qui est utile pour l’exécution via SSH ou l’automatisation de scripts.
{% endhint %}

## Référence des commandes de diagnostic

### Analyse ARP

**Objectif :** Détecte les appareils actifs sur les interfaces réseau du nœud à l’aide de paquets ARP.

**Quand l’utiliser :**

* Vérifier la connectivité réseau du point de vue du nœud
* Identifier les appareils sur les segments du réseau local du nœud
* Dépanner la configuration réseau du nœud

**Paramètres :**

* **Interface :** Interface réseau à partir de laquelle effectuer l’analyse

**Syntaxe CLI :**

```bash
nmap -sn [NETWORK_RANGE]
```

***

### Table ARP

**Objectif :** Affiche le cache ARP du nœud, avec 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 sur le réseau
* Recherche de conflits ARP affectant le nœud

**Syntaxe CLI :**

```bash
arp -a
```

***

### Adresses des ponts

**Objectif :** Affiche les tables d’adresses MAC des ponts réseau du nœud.

**Quand l’utiliser :**

* Dépannage de la configuration des ponts 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 du stockage persistant et les données temporaires du nœud.

**Quand l’utiliser :**

* Résolution des problèmes de performances liés au stockage
* Effacement des données de cache corrompues
* Préparation à la reconfiguration du stockage

{% hint style="danger" %}
**Avertissement concernant l’impact sur les données**

Cette commande peut affecter les performances du système et ne doit être utilisée que sous la supervision du support technique.
{% endhint %}

**Syntaxe CLI :**

```bash
sync && echo 3 > /proc/sys/vm/drop_caches
```

***

### Table DMI

**Objectif :** Affiche les informations de l’interface de gestion du poste de travail (DMI), notamment les détails du matériel.

**Quand l’utiliser :**

* Inventaire et identification du matériel
* Vérification des caractéristiques du système
* Dépannage des problèmes de compatibilité matérielle

**Syntaxe CLI :**

```bash
dmidecode
```

***

### Recherche DNS

**Objectif :** Teste la résolution DNS depuis le 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]
```

***

### Outil Ethernet

**Objectif :** Fournit des informations détaillées sur les interfaces Ethernet et leur configuration.

**Quand l’utiliser :**

* Diagnostic des problèmes d’interface réseau
* Vérification de la vitesse de liaison 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 du nœud.

**Quand l’utiliser :**

* Dépannage des communications entre les 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é aux commandes IP pour le diagnostic des interfaces et du routage.

**Quand l’utiliser :**

* Analyse détaillée des interfaces 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]
```

***

### Informations IPMI du BMC

**Objectif :** Affiche les informations du contrôleur de gestion de la carte mère.

**Quand l’utiliser :**

* Dépannage de la gestion du matériel
* 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
```

***

### Informations IPMI sur les FRU

**Objectif :** Affiche les informations des unités remplaçables sur site (FRU) via IPMI.

**Quand l’utiliser :**

* Gestion de l’inventaire matériel
* Identification des composants
* Informations sur la garantie et l’assistance

**Syntaxe CLI :**

```bash
ipmitool fru print
```

***

### Informations IPMI sur le réseau local

**Objectif :** Affiche les détails de la 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 du contrôleur 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
* Récupération de l’interface de gestion

{% hint style="warning" %}
**Impact sur la gestion**

Cette opération interrompra temporairement les fonctionnalités IPMI/BMC pendant la réinitialisation.
{% endhint %}

**Syntaxe CLI :**

```bash
ipmitool mc reset cold
```

***

### Référentiel des données des capteurs IPMI

**Objectif :** Affiche des informations complètes sur le référentiel des données des capteurs.

**Quand l’utiliser :**

* Surveillance détaillée du matériel
* 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 lié à l’environnement

**Syntaxe CLI :**

```bash
ipmitool sensor list
```

***

### Journaux des événements système IPMI

**Objectif :** Affiche les journaux des événements système provenant d’IPMI.

**Quand l’utiliser :**

* Analyse des erreurs matérielles
* Dépannage des événements système
* Recherche des problèmes matériels antérieurs

**Syntaxe CLI :**

```bash
ipmitool sel list
```

***

### Contrôle des voyants (lecteur)

**Objectif :** Contrôle les voyants des lecteurs de stockage pour permettre leur identification physique.

**Quand l’utiliser :**

* Identification physique des lecteurs
* Procédures de remplacement des lecteurs
* Tâches de maintenance matérielle

**Paramètres :**

* **Lecteur :** Identifiant du lecteur cible
* **Action :** Voyant allumé/éteint/clignotant

**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
* Recherche des problèmes de performances

**Syntaxe CLI :**

```bash
journalctl -n 100
dmesg
```

***

### Agrégation de liens réseau

**Objectif :** Affiche la configuration et l’état de l’agrégation de liens réseau.

**Quand l’utiliser :**

* Dépannage de la redondance réseau
* Diagnostic de l’interface d’agrégation
* Vérification de l’agrégation de liens

**Syntaxe CLI :**

```bash
cat /proc/net/bonding/[BOND_NAME]
```

***

### Vitesse d’OpenSSL

**Objectif :** Teste les performances cryptographiques du processeur du nœud.

**Quand l’utiliser :**

* Évaluation des performances
* 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 :** Adresse IP ou nom d’hôte cible
* **Nombre :** Nombre de paquets ping

**Syntaxe CLI :**

```bash
ping -c [COUNT] [DESTINATION]
```

***

### Interrogation RAS

**Objectif :** Interroge les informations de fiabilité, de disponibilité et de maintenabilité.

**Quand l’utiliser :**

* Évaluation de la fiabilité du matériel
* État de la correction des erreurs
* Diagnostics 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 :**

* Vérification préventive de l’état des disques
* Dépannage du stockage
* Maintenance préventive

**Paramètres :**

* **Disque :** Disque cible du 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, en particulier les tests longs.
{% endhint %}

***

### Informations S.M.A.R.T.

**Objectif :** Affiche les attributs SMART et les informations sur l’état de santé des disques.

**Quand l’utiliser :**

* Évaluation de l’état de santé des disques
* Analyse prédictive des défaillances
* Surveillance des performances du stockage

**Paramètres :**

* **Lecteur :** Identifiant du lecteur cible

**Syntaxe CLI :**

```bash
smartctl -a [DRIVE_PATH]
```

***

### Afficher les périphériques de blocs

**Objectif :** Répertorie tous les périphériques de 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 avec des hôtes et des 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 adresse IP cible
* **Port :** Numéro de port TCP

**Syntaxe CLI :**

```bash
telnet [HOST] [PORT]
nc -zv [HOST] [PORT]
```

***

### Capture TCP

**Objectif :** Capture les paquets réseau pour analyser le trafic en détail.

**Quand l’utiliser :**

* Dépannage réseau
* Analyse de sécurité
* Débogage des protocoles

**Paramètres :**

* **Nombre de paquets :** Nombre de paquets à capturer (de 100 à 1 000, 100 par défaut)
* **Délai d’expiration en secondes :** Durée de la capture (de 1 à 30, 15 par défaut)
* **Type d’interface :** ***Physique***, ***VXLAN***, ***Ponts***, ou ***périphériques TAP***
* **Nom :** Interface sur laquelle effectuer la capture, filtrée selon le **type d’interface**.
* **Niveau de détail de la sortie :** ***Aucun***, ***Faible***, ***Moyen***, ou ***Élevé***
* **Afficher l’en-tête de couche liaison (VLAN, MAC) :** Ajoute `-e` à la commande pour afficher les adresses MAC et l’étiquette VLAN 802.1Q de chaque paquet
* **Expression :** Expression de filtrage des paquets (par exemple, `vlan 210` ou `not vlan 1`), ajoutée à la commande telle qu’elle a été saisie

{% hint style="info" %}
**Liste des noms d’interfaces**

La **liste des interfaces physiques**  affiche les cartes réseau physiques du nœud. **Les ponts** et **les périphériques TAP** ne répertorient que les ponts et les périphériques TAP des réseaux et des machines virtuelles en cours d’exécution sur le nœud sélectionné. Lancez donc la capture sur le nœud où se trouve le réseau ou la machine virtuelle.
{% endhint %}

{% hint style="info" %}
**Afficher les étiquettes VLAN**

Par défaut, la capture n’affiche pas les en-têtes de couche liaison. Les trames balisées VLAN apparaissent donc comme du trafic IP ordinaire, sans ID VLAN. Cochez **Afficher l’en-tête de couche liaison (VLAN, MAC)** pour voir les étiquettes, par exemple `ethertype 802.1Q (0x8100) ... vlan 210, p 0`.
{% endhint %}

**Syntaxe CLI :**

Activez **Afficher la commande** pour voir la commande exacte utilisée. La commande par défaut est :

```bash
busybox timeout 15 tcpdump -lni [INTERFACE] -c 100
```

Lorsque **Afficher l’en-tête de couche liaison (VLAN, MAC)** est coché et qu’une **expression** est saisie :

```bash
busybox timeout 15 tcpdump -lni [INTERFACE] -c 100 -e [EXPRESSION]
```

{% hint style="warning" %}
**Impact sur les performances**

La capture de paquets peut affecter les performances du nœud. À utiliser avec précaution en production.
{% endhint %}

***

### Principale consommation CPU

**Objectif :** Affiche les processus qui consomment 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
```

***

### Principale utilisation du réseau

**Objectif :** Affiche les processus dont l’utilisation du réseau est la plus élevée.

**Quand l’utiliser :**

* Analyse des performances réseau
* Dépannage de l’utilisation de la bande passante
* Identification des processus fortement consommateurs du réseau

**Syntaxe CLI :**

```bash
iftop
nethogs
```

***

### Tracer la route

**Objectif :** Trace le chemin réseau entre le nœud et une destination.

**Quand l’utiliser :**

* Dépannage du routage réseau
* Analyse du chemin
* Diagnostic des problèmes de connectivité

**Paramètres :**

* **Destination :** Adresse IP ou nom d’hôte cible

**Syntaxe CLI :**

```bash
traceroute [DESTINATION]
mtr [DESTINATION]
```

***

### Quelle est mon adresse 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

### Procédure de diagnostic matériel

1. **Vue d’ensemble du système :** Commencez par la table DMI et l’état du châssis IPMI
2. **Contrôle de l’état :** Examinez les capteurs IPMI et les journaux d’é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 l’agrégation réseau et l’état des interfaces
5. **Évaluation des performances :** Surveillez l’utilisation du processeur et du réseau

### Maintenance préventive

* **Contrôles réguliers de l’état :** Surveillez les capteurs IPMI et les données SMART
* **Examen des journaux :** Vérifiez régulièrement les journaux d’événements système
* **Surveillance des performances :** Suivez les tendances d’utilisation du processeur et du réseau
* **État des disques :** Planifiez régulièrement des tests de diagnostic SMART

### Consignes de sécurité

* **Évaluation de l’impact :** Tenez compte de l’impact des commandes de diagnostic sur les systèmes de production
* **Coordination avec l’assistance :** Faites appel à l’assistance VergeOS pour les problèmes matériels complexes
* **Documentation :** Consignez les résultats des diagnostics afin d’analyser les tendances
* **Gestion des changements :** Suivez les procédures de gestion des changements lors des modifications matérielles

## Dépannage des problèmes courants des nœuds

### Problèmes matériels

1. Vérifiez les **capteurs IPMI** pour détecter les problèmes de température, de tension et de ventilateurs
2. Examinez les **journaux d’événements système IPMI** pour repérer les erreurs matérielles
3. Utilisez les **informations S.M.A.R.T.** pour évaluer l’état des disques

### Problèmes réseau

1. Vérifiez l’ **agrégation réseau** ainsi que son état et sa configuration
2. Utilisez **l’outil Ethernet** pour vérifier les paramètres de l’interface
3. Testez la connectivité avec **Ping** et **Trace Route**

### Problèmes de performances

1. Surveillez **l’utilisation maximale du processeur** pour détecter les contraintes en ressources
2. Vérifiez **l’utilisation maximale du réseau** pour évaluer l’utilisation de la bande passante
3. Consultez **les journaux** pour repérer les erreurs liées aux performances

### Problèmes de stockage

1. Utilisez **Afficher les périphériques de bloc** pour vérifier la détection des disques
2. Exécutez **les tests de diagnostic S.M.A.R.T.** pour effectuer un test complet des disques
3. Consultez **RAS Query** pour obtenir des informations sur les erreurs de mémoire et de stockage

## Étapes suivantes

Après avoir maîtrisé le diagnostic des nœuds, envisagez d’explorer les sujets suivants :

* Surveillance avancée du matériel et alertes
* Automatisation des scripts de diagnostic
* Intégration à 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 [l’assistance VergeOS](https://docs.verge.io/overview/fr/support-and-services.md) en fournissant les résultats détaillés du diagnostic et les informations sur le 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verge.io/run-the-platform/fr/administration-systeme/node-diagnostics.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
