> 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/stockage/vsan-diagnostics.md).

# Guide de diagnostic vSAN

## Vue d'ensemble

L’outil de diagnostics vSAN fournit des capacités complètes d’analyse du système de stockage et de dépannage pour les réseaux de zone de stockage virtuels VergeOS. Ces commandes de diagnostic permettent aux administrateurs système de surveiller les performances du stockage, de résoudre les problèmes de stockage et de maintenir une santé vSAN optimale sur l’ensemble du cluster.

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

* Comment accéder aux outils de diagnostic vSAN et les utiliser
* Compréhension de chaque commande de diagnostic et de son focus sur le stockage
* Bonnes pratiques pour le dépannage et la maintenance vSAN
* Quand utiliser des commandes de diagnostic spécifiques pour les problèmes de stockage
  {% endhint %}

## Prérequis

* Accès à l’interface VergeOS avec des privilèges de gestion vSAN
* Compréhension de base des concepts de stockage distribué
* Connaissance de l’architecture vSAN de VergeOS

{% hint style="info" %}
**Accès vSAN**

Les diagnostics vSAN ne sont disponibles qu’au niveau racine/parent. Les locataires n’ont pas accès aux outils de diagnostic vSAN.
{% endhint %}

## Accéder aux diagnostics vSAN

1. **Accédez à Diagnostics vSAN :**
   * Sélectionnez **Système** → **Diagnostics vSAN** dans le menu supérieur.
   * Ou bien : depuis le tableau de bord principal, cliquez sur le **niveaux vSAN** boîte de comptage → **Diagnostics vSAN** 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

### Trouver l’inode

**Objectif :** Localise des inodes spécifiques dans le système de fichiers vSAN pour une analyse détaillée.

**Quand l'utiliser :**

* Dépannage de la corruption du système de fichiers
* Localisation de blocs de données spécifiques
* Dépannage avancé du stockage

**Paramètres :**

* **Numéro d’inode :** Identifiant d’inode spécifique à localiser

**Syntaxe CLI :**

```bash
vcmd find --inode=[NUMERO_INODE]
```

***

### Obtenir les informations du cache

**Objectif :** Affiche des informations et statistiques complètes sur le système de cache.

**Quand l'utiliser :**

* Optimisation des performances
* Analyse du ratio cache hit/miss
* Évaluation de l’utilisation de la mémoire
* Dépannage des performances de stockage

**Syntaxe CLI :**

```bash
vcmd cache info
```

***

### Obtenir les clients

**Objectif :** Affiche les clients vSAN actifs et leurs détails de connexion.

**Quand l'utiliser :**

* Dépannage de connexion
* Analyse des performances des clients
* Vérification de la connectivité réseau
* Évaluation de la répartition de la charge

**Syntaxe CLI :**

```bash
vcmd clients list
```

***

### Obtenir les taux du cluster

**Objectif :** Affiche les métriques de performance et les taux de débit à l’échelle du cluster.

**Quand l'utiliser :**

* Surveillance des performances du cluster
* Analyse du débit
* Établissement d’une base de référence des performances
* Planification de capacité

**Syntaxe CLI :**

```bash
vcmd cluster rates
```

***

### Obtenir l’utilisation du cluster

**Objectif :** Affiche des statistiques complètes d’utilisation du stockage du cluster.

**Quand l'utiliser :**

* Planification de capacité
* Surveillance de l’utilisation du stockage
* Analyse de l’allocation de l’espace
* Évaluation de la tendance de croissance

**Syntaxe CLI :**

```bash
vcmd cluster usage
```

***

### Obtenir le maître actuel

**Objectif :** Identifie le nœud maître vSAN actuel dans le cluster.

**Quand l'utiliser :**

* Dépannage du leadership du cluster
* Analyse du basculement du maître
* Problèmes de coordination du cluster
* Optimisation des performances

**Syntaxe CLI :**

```bash
vcmd master current
```

***

### Obtenir la liste des périphériques

**Objectif :** Répertorie tous les périphériques de stockage participant au vSAN.

**Quand l'utiliser :**

* Gestion de l’inventaire des périphériques
* Vérification de la configuration du stockage
* Surveillance de l’état des périphériques
* Évaluation de la capacité

**Syntaxe CLI :**

```bash
vcmd devices list
```

***

### Obtenir l’état du périphérique

**Objectif :** Affiche des informations détaillées sur l’état des périphériques de stockage vSAN.

**Quand l'utiliser :**

* Surveillance de l’état de santé des périphériques
* Détection des pannes
* Analyse des performances
* Planification de la maintenance

**Paramètres :**

* **ID du périphérique :** Périphérique spécifique à interroger

**Syntaxe CLI :**

```bash
vcmd device status [DEVICE_ID]
```

***

### Obtenir l’utilisation du périphérique

**Objectif :** Affiche les statistiques d’utilisation pour des périphériques de stockage individuels.

**Quand l'utiliser :**

* Surveillance de l’utilisation du périphérique
* Analyse de l’équilibrage de charge
* Optimisation des performances
* Évaluation de l’usure uniforme

**Paramètres :**

* **ID du périphérique :** Périphérique cible pour l’analyse

**Syntaxe CLI :**

```bash
vcmd device usage [DEVICE_ID]
```

***

### Obtenir l’état du fichier

**Objectif :** Récupère des informations détaillées sur l’état de fichiers spécifiques dans vSAN.

**Quand l'utiliser :**

* Vérification de l’intégrité des fichiers
* Vérification de l’état de réplication
* Suivi de l’emplacement des données
* Enquête sur la corruption

**Paramètres :**

* **Chemin du fichier :** Fichier cible pour l’analyse

**Syntaxe CLI :**

```bash
vcmd file status [FILE_PATH]
```

***

### Obtenir les informations FUSE

**Objectif :** Affiche les informations de montage et d’opération FUSE (Filesystem in Userspace).

**Quand l'utiliser :**

* Dépannage du montage du système de fichiers
* Analyse des performances FUSE
* Vérification du point de montage
* Diagnostic des problèmes d’accès

**Syntaxe CLI :**

```bash
vcmd fuse info
```

***

### Obtenir l’état de la vérification d’intégrité

**Objectif :** Affiche l’état des opérations de vérification d’intégrité en cours ou terminées.

**Quand l'utiliser :**

* Surveillance de l’intégrité des données
* Suivi du processus de vérification
* Détection de corruption
* Vérification de l’état de maintenance

**Syntaxe CLI :**

```bash
vcmd integcheck status
```

***

### Obtenir l’état du journal

**Objectif :** Affiche l’état du journal vSAN et les informations d’opération.

**Quand l'utiliser :**

* Dépannage des performances d’écriture
* Surveillance de l’espace du journal
* Analyse de la journalisation des transactions
* Optimisation des performances

**Syntaxe CLI :**

```bash
vcmd journal status
```

***

### Obtenir la liste des périphériques du nœud

**Objectif :** Répertorie les périphériques de stockage pour des nœuds spécifiques du cluster.

**Quand l'utiliser :**

* Inventaire des périphériques spécifique au nœud
* Planification de capacité par nœud
* Analyse de la répartition des périphériques
* Préparation à la maintenance du nœud

**Paramètres :**

* **ID du nœud :** Nœud cible pour le listage des périphériques

**Syntaxe CLI :**

```bash
vcmd node devices [NODE_ID]
```

***

### Obtenir les informations du nœud

**Objectif :** Affiche des informations complètes sur des nœuds vSAN spécifiques.

**Quand l'utiliser :**

* Évaluation de l’état du nœud
* Vérification de la configuration
* Analyse des performances
* Dépannage des problèmes de nœud

**Paramètres :**

* **ID du nœud :** Identifiant du nœud cible

**Syntaxe CLI :**

```bash
vcmd node info [NODE_ID]
```

***

### Obtenir la liste des nœuds

**Objectif :** Répertorie tous les nœuds participant au cluster vSAN.

**Quand l'utiliser :**

* Vérification de l’appartenance au cluster
* Gestion de l’inventaire des nœuds
* Analyse de la topologie du cluster
* Vue d’ensemble de l’état de santé

**Syntaxe CLI :**

```bash
vcmd nodes list
```

***

### Obtenir le chemin à partir de l’inode

**Objectif :** Résout les chemins du système de fichiers à partir des numéros d’inode.

**Quand l'utiliser :**

* Navigation dans le système de fichiers
* Correspondance inode-vers-chemin
* Analyse de la corruption
* Dépannage avancé

**Paramètres :**

* **Numéro d’inode :** Inode source pour la résolution du chemin

**Syntaxe CLI :**

```bash
vcmd path from-inode [INODE_NUMBER]
```

***

### Obtenir le read-ahead

**Objectif :** Affiche la configuration et les statistiques du cache read-ahead.

**Quand l'utiliser :**

* Optimisation des performances de lecture
* Réglage du cache
* Analyse de l’accès séquentiel
* Dépannage des performances

**Syntaxe CLI :**

```bash
vcmd readahead status
```

***

### Obtenir l’état de réparation

**Objectif :** Affiche l’état des opérations de réparation en cours et de reconstruction des données.

**Quand l'utiliser :**

* Surveillance de la réparation des données
* Suivi du processus de récupération
* Évaluation de la récupération après panne
* Vérification de l’état de maintenance

**Syntaxe CLI :**

```bash
vcmd repair status
```

***

### Obtenir la configuration en cours d’exécution

**Objectif :** Affiche la configuration en cours d’exécution actuelle du système vSAN.

**Quand l'utiliser :**

* Vérification de la configuration
* Dépannage des problèmes de configuration
* Référence de configuration de sauvegarde
* Gestion des changements

**Syntaxe CLI :**

```bash
vcmd config show
```

***

### Obtenir la liste de synchronisation

**Objectif :** Répertorie les opérations de synchronisation et leur état.

**Quand l'utiliser :**

* Surveillance de la synchronisation des données
* Suivi de l’état de la réplication
* Vérification de la cohérence
* Analyse des performances

**Syntaxe CLI :**

```bash
vcmd sync list
```

***

### Obtenir les cartes des périphériques des niveaux

**Objectif :** Affiche la cartographie des périphériques à travers différents niveaux de stockage.

**Quand l'utiliser :**

* Vérification de la configuration des niveaux
* Analyse du placement des périphériques
* Optimisation des performances
* Planification de capacité

**Syntaxe CLI :**

```bash
vcmd tier device-maps
```

***

### Obtenir les cartes des nœuds des niveaux

**Objectif :** Affiche la manière dont les niveaux de stockage sont répartis entre les nœuds du cluster.

**Quand l'utiliser :**

* Analyse de la distribution des niveaux
* Vérification de l’équilibrage de charge
* Optimisation des performances
* Planification de capacité

**Syntaxe CLI :**

```bash
vcmd tier node-maps
```

***

### Obtenir l’état des niveaux

**Objectif :** Affiche des informations d’état complètes sur les niveaux de stockage.

**Quand l'utiliser :**

* Surveillance de l’état des niveaux
* Analyse des performances
* Suivi de l’utilisation de la capacité
* Optimisation des niveaux

**Syntaxe CLI :**

```bash
vcmd tier status
```

***

### Obtenir les principaux taux d’utilisation

**Objectif :** Identifie les plus gros consommateurs de ressources de stockage et de performances.

**Quand l'utiliser :**

* Identification des goulots d’étranglement des performances
* Analyse de l'utilisation des ressources
* Planification de capacité
* Optimisation de l’utilisation

**Syntaxe CLI :**

```bash
vcmd usage top-rates
```

***

### Obtenir l’utilisation

**Objectif :** Affiche des statistiques et métriques complètes d’utilisation vSAN.

**Quand l'utiliser :**

* Surveillance de l’utilisation globale du système
* Planification de capacité
* Établissement d’une base de référence des performances
* Analyse de l’allocation des ressources

**Syntaxe CLI :**

```bash
vcmd usage show
```

***

### Obtenir l’utilisation du volume

**Objectif :** Affiche les statistiques d’utilisation pour des volumes individuels dans vSAN.

**Quand l'utiliser :**

* Surveillance de la capacité spécifique au volume
* Analyse des performances
* Vérification de l’allocation de l’espace
* Suivi de la croissance

**Paramètres :**

* **ID du volume :** Volume cible pour l’analyse

**Syntaxe CLI :**

```bash
vcmd volume usage [VOLUME_ID]
```

***

### Vérification d’intégrité

**Objectif :** Lance une vérification complète de l’intégrité des données sur l’ensemble du vSAN.

**Quand l'utiliser :**

* Maintenance planifiée
* Enquête sur la corruption des données
* Vérifications préventives de l’état de santé
* Vérification après panne

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

Les vérifications d’intégrité peuvent avoir un impact important sur les performances du système et doivent être planifiées pendant les fenêtres de maintenance.
{% endhint %}

**Syntaxe CLI :**

```bash
vcmd integcheck start
```

***

### Vérification d’intégrité du périphérique

**Objectif :** Effectue une vérification d’intégrité sur des périphériques de stockage spécifiques.

**Quand l'utiliser :**

* Vérification d’intégrité spécifique au périphérique
* Dépannage ciblé
* Vérification après réparation
* Maintenance sélective

**Paramètres :**

* **ID du périphérique :** Périphérique cible pour la vérification d’intégrité

**Syntaxe CLI :**

```bash
vcmd integcheck device [DEVICE_ID]
```

***

### Résumer l’utilisation du disque

**Objectif :** Fournit un résumé complet de l’utilisation du disque sur l’ensemble du vSAN.

**Quand l'utiliser :**

* Rapports sur la capacité
* Analyse des tendances d’utilisation
* Planification de l’optimisation du stockage
* Rapport de direction

**Syntaxe CLI :**

```bash
vcmd usage summarize
```

## Bonnes pratiques

### Flux de travail de surveillance de la santé vSAN

1. **Vue d’ensemble du système :** Commencez avec Obtenir l’utilisation du cluster et Obtenir les taux du cluster
2. **Analyse des performances :** Examinez Obtenir les principaux taux d’utilisation et les métriques spécifiques aux périphériques
3. **Évaluation de l’état de santé :** Vérifiez Obtenir l’état de réparation et Obtenir l’état de la vérification d’intégrité
4. **Planification de capacité :** Utilisez Résumer l’utilisation du disque et les informations sur les niveaux
5. **Dépannage :** Employez les commandes spécifiques aux périphériques et aux nœuds selon les besoins

### Maintenance préventive

* **Contrôles de santé réguliers :** Surveillez l’utilisation du cluster, l’état de réparation et la santé des périphériques
* **Surveillance des performances :** Suivez les taux du cluster et les principaux schémas d’utilisation
* **Vérification de l’intégrité :** Programmez des vérifications d’intégrité périodiques pendant les fenêtres de maintenance
* **Planification de capacité :** Examinez régulièrement les tendances d’utilisation et les schémas de croissance

### Optimisation des performances

* **Analyse du cache :** Surveillez les informations du cache et les ratios hit pour repérer les opportunités d’optimisation
* **Gestion des niveaux :** Examinez les cartes des périphériques et les cartes des nœuds des niveaux pour une répartition équilibrée
* **Équilibrage de charge :** Utilisez les informations sur les clients et l’utilisation pour optimiser la répartition des charges de travail
* **Optimisation de la lecture :** Ajustez les paramètres de read-ahead en fonction des modèles d’accès

## Dépannage des problèmes vSAN courants

### Problèmes de performances

1. Vérifiez **Obtenir les taux du cluster** et **Obtenir les principaux taux d’utilisation** pour les goulots d’étranglement
2. Examinez **Obtenir les informations du cache** pour l’efficacité du cache
3. Analysez **Obtenir l’utilisation du périphérique** pour les performances d’un périphérique individuel

### Problèmes de capacité

1. Utilisez **Obtenir l’utilisation du cluster** et **Résumer l’utilisation du disque** pour l’analyse de l’espace
2. Examinez **Obtenir l’état des niveaux** pour la capacité spécifique à un niveau
3. Vérifiez **Obtenir l’utilisation du volume** pour la consommation d’un volume individuel

### Préoccupations liées à l’intégrité des données

1. Examinez **Obtenir l’état de la vérification d’intégrité** pour les vérifications d’intégrité récentes
2. Vérifiez **Obtenir l’état de réparation** pour les réparations en cours
3. Utilisez **Obtenir l’état du fichier** pour la vérification de l’intégrité d’un fichier spécifique

### Problèmes de santé du cluster

1. Vérifiez **Obtenir le maître actuel** pour l’état du leadership
2. Vérifiez **Obtenir la liste des nœuds** et **Obtenir les informations du nœud** pour la santé du nœud
3. Examinez **Obtenir la liste de synchronisation** pour les problèmes de synchronisation

### Problèmes de périphérique

1. Utilisez **Obtenir la liste des périphériques** et **Obtenir l’état du périphérique** pour l’état du périphérique
2. Vérifiez **Obtenir la liste des périphériques du nœud** pour les problèmes de périphériques spécifiques au nœud
3. Exécuter **Vérification d’intégrité du périphérique** pour des problèmes de périphérique suspectés

## Diagnostics avancés

### Analyse du système de fichiers

* Utilisez **Trouver l’inode** et **Obtenir le chemin à partir de l’inode** pour l’investigation du système de fichiers
* Utilisez **Obtenir l’état du fichier** pour une analyse détaillée des fichiers
* Vérifiez **Obtenir les informations FUSE** pour les problèmes liés au montage

### Gestion de la configuration

* Examinez **Obtenir la configuration en cours d’exécution** pour la configuration actuelle
* Vérifiez les correspondances des niveaux et des périphériques avec les commandes de cartographie
* Recoupez les informations des nœuds et des périphériques pour vérifier la cohérence

### Optimisation des performances

* Analysez les statistiques du cache et du read-ahead pour l’optimisation
* Surveillez les connexions clients et les schémas d’utilisation
* Examinez l’état du journal pour optimiser les performances d’écriture

## Étapes suivantes

Après avoir maîtrisé les diagnostics vSAN, envisagez d’explorer :

* Techniques avancées de réglage des performances vSAN
* Systèmes de surveillance et d’alerte automatisés
* Intégration avec des outils externes de gestion du stockage
* Stratégies de reprise après sinistre et de sauvegarde

Pour les problèmes vSAN complexes ou des conseils d’optimisation des performances, contactez [Support VergeOS](/overview/fr/support-and-services.md) avec une sortie de diagnostic détaillée et des informations de configuration du 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/stockage/vsan-diagnostics.md?ask=<question>&goal=<endgoal>
```

`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.
