> 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/learn-the-platform/fr/module-5-stockage/05-storage-monitoring.md).

# Supervision du stockage et dépannage

Maîtriser les diagnostics vSAN, l’intégration Fibre Channel, le dépannage NAS et les stratégies de maintenance préventive dans VergeOS.

## Pourquoi la surveillance du stockage est importante

Le stockage est la base de chaque charge de travail dans VergeOS. Un disque dégradé, un niveau saturé ou une erreur d’intégrité passée inaperçue peuvent se répercuter en cascade sur les performances des VM, provoquer l’échec des instantanés et susciter des plaintes des locataires. VergeOS fournit **des outils de diagnostic intégrés à deux niveaux** -- des diagnostics vSAN pour le moteur de stockage distribué au niveau bloc, et des diagnostics NAS pour chaque instance de service de partage de fichiers -- afin que vous puissiez détecter, diagnostiquer et résoudre les problèmes avant qu’ils n’impactent la production.

```mermaid
graph LR
    subgraph diagnostics["Diagnostics de stockage VergeOS"]
        direction TB
        VSAN["Diagnostics vSAN<br/>Système → Diagnostics vSAN<br/>(niveau racine uniquement)"]
        NAS["Diagnostics NAS<br/>NAS → Service → Diagnostics<br/>(par instance NAS)"]
        SYSDIAG["Diagnostics système<br/>Exports de diagnostic groupés<br/>pour l’escalade au support"]
    end

    subgraph areas["Domaines d’intervention du diagnostic"]
        PERF["Performance<br/>Débits du cluster, cache, IOPS"]
        CAP["Capacité<br/>Utilisation des niveaux, croissance des volumes"]
        HEALTH["Santé<br/>État des périphériques, réparations"]
        SHARES["Partage de fichiers<br/>SMB/CIFS, NFS, AD"]
    end

    VSAN --> PERF
    VSAN --> CAP
    VSAN --> HEALTH
    NAS --> SHARES

    style diagnostics fill:#e8edf4,stroke:#2d4a7a
    style areas fill:#e8f4e8,stroke:#2d7a2d
```

## Diagnostics vSAN

L’interface Diagnostics vSAN fournit un accès en temps réel à l’état interne du moteur de stockage VergeFS. Chaque diagnostic est exécuté à partir du menu déroulant **Query** dans l’interface utilisateur Diagnostics vSAN.

### Accéder aux diagnostics vSAN

1. Accédez à **Système → Diagnostics vSAN** depuis le menu supérieur
2. Autre possibilité : depuis le tableau de bord principal, cliquez sur la boîte de compteur **Niveaux vSAN** → **Diagnostics vSAN** dans le menu de gauche
3. Sélectionnez une commande dans le menu déroulant **Query** , configurez les paramètres à droite, puis cliquez sur **Envoyer →**

{% hint style="warning" %}
**Niveau racine uniquement**

Les diagnostics vSAN ne sont disponibles qu’au niveau racine/parent. Les locataires n’ont pas accès aux outils de diagnostic vSAN -- ils doivent demander les diagnostics via le fournisseur.
{% endhint %}

### Référence des commandes de diagnostic

Les diagnostics suivants sont disponibles dans le menu déroulant **Query** de l’interface Diagnostics vSAN, regroupés par domaine d’intervention.

#### Cluster et performance

| Commande                                      | Objectif                                                    |
| --------------------------------------------- | ----------------------------------------------------------- |
| **Obtenir les débits du cluster**             | Métriques de débit et d’IOPS à l’échelle du cluster         |
| **Obtenir l’utilisation du cluster**          | Utilisation globale du stockage et capacité                 |
| **Obtenir les principaux taux d’utilisation** | Identifier les principaux consommateurs d’E/S de stockage   |
| **Obtenir l’utilisation**                     | Statistiques complètes d’utilisation vSAN                   |
| **Obtenir les informations du cache**         | Rapports cache hit/miss et utilisation de la mémoire        |
| **Obtenir le read-ahead**                     | Configuration et statistiques du cache en lecture anticipée |
| **Obtenir le maître actuel**                  | Identifier le nœud maître vSAN actuel                       |

#### Périphérique et nœud

| Commande                                       | Objectif                                        |
| ---------------------------------------------- | ----------------------------------------------- |
| **Obtenir la liste des périphériques**         | Tous les périphériques de stockage du vSAN      |
| **Obtenir l’état du périphérique**             | Santé et état d’un périphérique spécifique      |
| **Obtenir l’utilisation du périphérique**      | Utilisation et données d’usure par périphérique |
| **Obtenir la liste des nœuds**                 | Tous les nœuds participant au vSAN              |
| **Obtenir les informations du nœud**           | Informations détaillées pour un nœud spécifique |
| **Obtenir la liste des périphériques du nœud** | Périphériques rattachés à un nœud spécifique    |

#### Niveau et volume

| Commande                                              | Objectif                                                   |
| ----------------------------------------------------- | ---------------------------------------------------------- |
| **Obtenir l’état du niveau**                          | Santé et capacité par niveau de stockage                   |
| **Obtenir les mappages des périphériques par niveau** | Comment les périphériques sont répartis entre les niveaux  |
| **Obtenir les mappages des nœuds par niveau**         | Comment les niveaux sont répartis entre les nœuds          |
| **Obtenir l’utilisation du volume**                   | Consommation de stockage par volume                        |
| **Résumer l’utilisation du disque**                   | Résumé de l’utilisation des disques à l’échelle du cluster |

#### Intégrité et réparation

| Commande                                          | Objectif                                                        |
| ------------------------------------------------- | --------------------------------------------------------------- |
| **Vérification d’intégrité**                      | Lancer une vérification d’intégrité complète                    |
| **Vérification d’intégrité du périphérique**      | Vérification d’intégrité sur un périphérique spécifique         |
| **Obtenir l’état de la vérification d’intégrité** | Progression/résultats des vérifications d’intégrité             |
| **Obtenir l’état de réparation**                  | Opérations actives de réparation et de reconstruction           |
| **Obtenir la liste de synchronisation**           | Connexions actives de synchronisation entre sites (réplication) |

#### Système de fichiers et configuration

| Commande                                  | Objectif                                     |
| ----------------------------------------- | -------------------------------------------- |
| **Trouver un inode**                      | Localiser un inode spécifique pour l’analyse |
| **Obtenir le chemin à partir de l’inode** | Résoudre un numéro d’inode en un chemin      |
| **Obtenir l’état du fichier**             | Réplication et intégrité d’un fichier        |
| **Obtenir les informations FUSE**         | Détails du montage et des opérations FUSE    |
| **Obtenir l’état du journal**             | État du journal en écriture anticipée        |
| **Obtenir la configuration en cours**     | Configuration vSAN actuellement active       |
| **Obtenir les clients**                   | Connexions clientes vSAN actives             |

## Flux de travail de surveillance de l’état de santé

Suivez cette approche systématique lors de l’examen de la santé du stockage -- commencez large puis analysez les composants spécifiques en détail.

```mermaid
graph TD
    A["1. Vue d’ensemble du système<br/>Utilisation du cluster + Débits du cluster"] --> B["2. Analyse des performances<br/>Principaux taux d’utilisation + Informations sur le cache"]
    B --> C["3. Évaluation de l’état de santé<br/>État des réparations + État des vérifications d’intégrité"]
    C --> D["4. Planification des capacités<br/>Résumer l’utilisation du disque + État des niveaux"]
    D --> E["5. Dépannage ciblé<br/>Commandes spécifiques aux périphériques + spécifiques aux nœuds"]

    style A fill:#e8f4e8,stroke:#2d7a2d
    style B fill:#e8edf4,stroke:#2d4a7a
    style C fill:#fce8e8,stroke:#7a2d2d
    style D fill:#f4f0e8,stroke:#7a6a2d
    style E fill:#e8e8f4,stroke:#4a2d7a
```

### Flux de travail étape par étape

1. **Vue d’ensemble du système** -- Exécutez `Obtenir l’utilisation du cluster` et `Obtenir les débits du cluster` pour comprendre la santé globale, la capacité et le débit
2. **Analyse des performances** -- Vérifiez `Obtenir les principaux taux d’utilisation` pour trouver les volumes chauds, puis `Obtenir les informations du cache` pour les taux de cache hit
3. **Évaluation de l’état de santé** -- Vérifiez `Obtenir l’état de réparation` affiche tous des zéros (aucune réparation active) et `Obtenir l’état de la vérification d’intégrité` pour les résultats récents
4. **Planification des capacités** -- Utilisez `Résumer l’utilisation du disque` pour une vue d’ensemble du cluster et `Obtenir l’état du niveau` pour la capacité par niveau
5. **Dépannage ciblé** -- Creusez dans des périphériques spécifiques (`Obtenir l’état du périphérique`) ou des nœuds (`Obtenir les informations du nœud`) en fonction des résultats

## Schémas de dépannage

### Problèmes de performance

**Symptômes :** Latence élevée des VM, opérations d’instantané lentes, plaintes des locataires concernant la vitesse du disque.

1. Vérifiez **Obtenir les débits du cluster** le débit agrégé -- les débits sont-ils inférieurs à la ligne de base ?
2. Examinez **Obtenir les informations du cache** -- de faibles taux de hit indiquent que l’ensemble de travail dépasse le cache disponible
3. Examinez **Obtenir les principaux taux d’utilisation** pour identifier quels volumes consomment le plus d’E/S
4. Vérifiez **Obtenir l’utilisation du périphérique** sur les disques individuels pour détecter une répartition inégale de la charge
5. Vérifiez **Obtenir l’état du journal** -- un journal engorgé indique une pression d’écriture soutenue

{% hint style="info" %}
**Limitation du stockage**

VergeOS applique une limitation graduée des E/S en fonction de l’utilisation de la capacité : fonctionnement normal en dessous de 91 %, légère limitation (10 ms ajoutés) entre 91 et 95 %, et limitation critique (50 ms ajoutés) au-dessus de 96 %. Vérifiez l’utilisation du niveau si les performances se dégradent soudainement.
{% endhint %}

### Problèmes de capacité

**Symptômes :** Alertes « espace faible », impossibilité de créer des instantanés, écritures lentes en raison de la limitation.

1. Exécutez **Obtenir l’utilisation du cluster** et **Résumer l’utilisation du disque** pour une analyse globale de l’espace
2. Vérifiez **Obtenir l’état du niveau** pour la capacité par niveau -- un seul niveau plein peut provoquer des problèmes même si les autres disposent d’espace
3. Utilisez **Obtenir l’utilisation du volume** sur les volumes les plus volumineux pour identifier les candidats à la croissance
4. Passez en revue les politiques de rétention des instantanés -- les anciens instantanés référant des blocs modifiés consomment beaucoup d’espace

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

**Symptômes :** Avertissements de somme de contrôle dans les journaux, corruption suspectée après des événements matériels.

1. Vérifiez **Obtenir l’état de la vérification d’intégrité** pour les résultats récents de vérification d’intégrité
2. Examinez **Obtenir l’état de réparation** pour toute reconstruction de données active
3. Utilisez **Obtenir l’état du fichier** sur des fichiers spécifiques pour vérifier leur état de réplication
4. Si nécessaire, exécutez **Vérification d’intégrité** pour lancer une analyse complète (à programmer pendant les fenêtres de maintenance)

{% hint style="warning" %}
**Impact de la vérification d’intégrité**

Les vérifications d’intégrité complètes peuvent avoir un impact significatif sur les performances du système. Programmez-les toujours pendant les fenêtres de maintenance et surveillez la charge du système pendant l’exécution.
{% endhint %}

### Problèmes de santé du cluster

**Symptômes :** Alertes de nœud hors ligne, basculement inattendu du maître, préoccupations de split-brain.

1. Vérifiez **Obtenir le maître actuel** pour confirmer quel nœud dirige le vSAN
2. Vérifiez **Obtenir la liste des nœuds** et **Obtenir les informations du nœud** pour l’état de chaque nœud
3. Examinez **Obtenir l’état de réparation** pour la re-réplication active des blocs, indiquant qu’un nœud a été temporairement déconnecté
4. Examinez **Obtenir les clients** pour des schémas de connexion inattendus

{% hint style="info" %}
**Obtenir la liste de synchronisation vs Obtenir l’état de réparation**

**Obtenir la liste de synchronisation** signale les **connexions de synchronisation entre sites** (réplication) vers des sites distants -- et non une resynchronisation intra-cluster après la déconnexion d’un nœud. Utilisez **Obtenir l’état de réparation** pour la progression de la reconstruction et de la re-réplication dans le cluster.
{% endhint %}

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

**Symptômes :** Avertissements SMART, erreurs de disque individuelles, performances inégales entre les nœuds.

1. Exécutez **Obtenir la liste des périphériques** et **Obtenir l’état du périphérique** pour identifier les périphériques dégradés ou défaillants
2. Vérifiez **Obtenir la liste des périphériques du nœud** pour l’inventaire complet des périphériques du nœud concerné
3. Exécutez **Vérification d’intégrité du périphérique** sur les disques suspectés
4. Recoupez avec les données SMART capturées dans le lot Diagnostics système (collectées par nœud par l’outil de diagnostic)

## Maintenance préventive

Une surveillance proactive évite les mauvaises surprises. Établissez une cadence régulière pour ces vérifications :

### Quotidiennement

* Examiner l’utilisation du cluster et la capacité des niveaux - Vérifier les réparations actives (doivent être à zéro en régime de croisière) - Vérifier qu’il n’y a pas d’alertes liées au stockage dans le tableau de bord

### Hebdomadairement

* Exécuter les débits du cluster pour établir des lignes de base de performance - Examiner les principaux taux d’utilisation pour les tendances de croissance - Vérifier les taux de hit du cache et ajuster si nécessaire

### Mensuellement

* Planifier les vérifications d’intégrité pendant les fenêtres de maintenance - Examiner la santé des périphériques et les données SMART - Analyser les tendances de capacité pour la planification des achats

## Intégration Fibre Channel

Le vSAN VergeOS prend en charge **les LUN Fibre Channel (FC) comme périphériques de stockage** dans son architecture par niveaux, permettant l’intégration avec l’infrastructure SAN existante.

### Principes clés

* **Les LUN FC sont traitées exactement comme des disques physiques** -- VergeOS ne fait aucune distinction une fois qu’elles sont affectées à un niveau
* **Chaque nœud doit recevoir ses propres LUN uniques** -- n’exposez pas la même LUN à plusieurs nœuds (contrairement au clustering de stockage partagé traditionnel)
* **Le niveau 0 requiert toujours des disques physiques NVMe/SSD** dans les nœuds pour le stockage des métadonnées
* **Désactivez le RAID et le tiering automatique** sur le SAN pour les LUN utilisées par VergeOS -- le vSAN gère la redondance de manière native
* **Multipath actif/passif** avec un délai de basculement de 7 secondes ; VergeOS sélectionne automatiquement le chemin optimal

### Quand utiliser la FC par rapport aux disques physiques

Verge recommande **les disques physiques directement raccordés aux nœuds** pour la plupart des déploiements. L’intégration FC convient lorsque vous disposez déjà d’investissements SAN ou d’exigences de conformité spécifiques. Les disques physiques offrent une configuration plus simple, de meilleures performances (sans surcharge SAN), moins de points de défaillance et un coût inférieur.

{% hint style="info" %}
**Bande passante réseau principale**

Le vSAN utilise le réseau principal pour la réplication des données. Si votre SAN FC prend en charge 32 Gb mais que votre réseau principal est à 25 Gb, le débit en écriture sera limité par le réseau principal. Assurez-vous que la bande passante du réseau principal est égale ou supérieure à celle du SAN pour les charges intensives en écriture.
{% endhint %}

## Diagnostics NAS

Chaque instance de service NAS possède sa propre interface de diagnostic, distincte des diagnostics vSAN. Les diagnostics NAS se concentrent sur les protocoles de partage de fichiers, la connectivité réseau et l’authentification.

### Accéder aux diagnostics NAS

1. Accédez à **NAS → Liste** depuis le menu supérieur
2. Double-cliquez sur le service NAS souhaité
3. Cliquez sur **Diagnostics** dans le menu de gauche
4. Sélectionnez une commande dans le menu déroulant **menu déroulant Diagnostics Query** et cliquez sur **Envoyer →**

### Principales commandes de diagnostic NAS

| Catégorie            | Commandes                                             | Objectif                                                               |
| -------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------- |
| **SMB/CIFS**         | `smbstatus`, `testparm`, `smbclient -L localhost`     | Connexions actives, validation de la configuration, liste des partages |
| **NFS**              | `exportfs -v`, `rpcinfo -p`, `showmount -e`           | Liste des exportations, services RPC, vérification du montage          |
| **Active Directory** | `wbinfo -t`, `wbinfo -u`, `wbinfo -g`                 | Vérification de confiance, utilisateurs du domaine, groupes du domaine |
| **Réseau**           | Ping, traceroute, balayage ARP, recherche DNS         | Connectivité, routage, découverte des voisins                          |
| **Performance**      | Top utilisation CPU, Top utilisation réseau, TCP Dump | Utilisation des ressources et analyse du trafic                        |
| **Journalisation**   | Journaux (journalctl, journaux samba)                 | Analyse des erreurs et surveillance des événements                     |

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

1. **État du service** -- Vérifiez l’état des services et des protocoles spécifiques (Samba/NFS)
2. **Connectivité réseau** -- Vérifiez avec Ping et la configuration de l’interface
3. **Authentification** -- Testez les utilisateurs, les groupes et Winbind (pour les environnements AD)
4. **Performance** -- Surveillez le top utilisation CPU et le top utilisation réseau
5. **Journaux** -- Passez en revue les journaux de service pour détecter les erreurs ou avertissements

## Problèmes NAS courants et solutions

### Windows : impossible de se connecter aux partages CIFS

**Cause :** Windows 10/11 et Server 2016+ désactivent par défaut les connexions invité non sécurisées, bloquant l’accès aux partages qui autorisent l’accès anonyme.

**Solution :** Activez les connexions invité non sécurisées via la stratégie de groupe :

1. Ouvrez `gpedit.msc` → **Configuration ordinateur → Modèles d’administration → Réseau → Lanman Workstation**
2. Définissez **Activer les connexions invité non sécurisées** sur **Activé**
3. Redémarrez l’appareil Windows

### macOS : échecs de connexion SMB

**Cause :** Les paramètres par défaut de macOS peuvent entrer en conflit avec la version du protocole SMB du serveur ou manquer d’extensions spécifiques à Apple.

**Solution (côté client) :** Forcer SMB3 dans `/etc/nsmb.conf`:

```ini
[default]
smb_neg=smb3_only
```

Videz le cache SMB (`sudo rm -rf /var/db/samba/* /var/db/smb/*`) et redémarrez.

**Solution (côté serveur) :** Ajoutez les paramètres du module Apple/Samba fruit sous **NAS → CIFS → Options de configuration avancées**:

```ini
ea support = yes
vfs objects = fruit streams_xattr
fruit:metadata = stream
fruit:model = MacSamba
fruit:veto_appledouble = no
fruit:nfs_aces = no
fruit:posix_rename = oui
fruit:zero_file_id = oui
fruit:wipe_intentionally_left_blank_rfork = oui
fruit:delete_empty_adfiles = oui
```

### Accès refusé sur les partages CIFS

**Cause :** Permissions utilisateur/groupe incorrectes ou configuration du partage incorrecte.

**Solution :**

1. Vérifiez que l'utilisateur a accès dans la liste des utilisateurs du service NAS
2. Vérifiez les paramètres du partage : assurez-vous **Navigable** est activé et que l'utilisateur figure dans la **Utilisateurs valides** liste
3. Si vous utilisez **Utilisateur forcé** ou **Groupe forcé** options, confirmez que l'identité forcée dispose des autorisations de système de fichiers correctes

### Performances CIFS lentes

**Cause :** Incompatibilité de version du protocole SMB, problèmes réseau ou configuration sous-optimale.

**Solution :**

1. Vérifiez la stabilité du réseau avec les diagnostics NAS **Ping** et **Traceroute** commandes
2. Vérifiez la version du protocole SMB sous **NAS → Volumes → Options de configuration avancées** -- assurez-vous que SMB2 ou SMB3 est utilisé
3. Surveillez avec **Utilisation réseau la plus élevée** dans les diagnostics NAS pour détecter une saturation de la bande passante
4. Contactez le support VergeOS pour des paramètres avancés de réglage de Samba si les optimisations standard sont insuffisantes

{% hint style="info" %}
**Pont VMware**

Vous venez de VMware ? VergeOS expose les mêmes données de diagnostic via l' **Système → Diagnostics vSAN** interface utilisateur sur n'importe quel nœud contrôleur -- aucun appareil de gestion séparé, plug-in ou couche de script n'est requis. Les diagnostics NAS résident dans la VM du service NAS plutôt que dans une console centralisée.
{% endhint %}

{% hint style="info" %}
**Pont Nutanix**

Vous venez de Nutanix ? VergeOS vous offre le même type de couverture de diagnostic de stockage et de vérification d'intégrité via l' **Diagnostics vSAN** interface utilisateur sur n'importe quel nœud contrôleur, avec les contrôles d'état du service NAS résidant dans la VM du service NAS elle-même plutôt que dans une console de services de fichiers séparée.
{% endhint %}

## Démarrage

### Explorez les diagnostics vSAN

Accédez à **Système → Diagnostics vSAN**, exécutez **Obtenir l’utilisation du cluster** et **Obtenir les débits du cluster** pour établir votre référence.

### Vérifiez l'état du NAS

Ouvrez la page Diagnostics de chaque service NAS. Exécutez **Samba** pour voir les connexions actives et **NFS** pour vérifier les exports. Consultez **Journaux** pour les erreurs récentes.

### Consultez le guide de diagnostic

Lisez le guide complet [Guide de diagnostics vSAN](https://docs.verge.io/run-the-platform/fr/stockage/vsan-diagnostics.md) et [Guide de diagnostics NAS](https://docs.verge.io/run-the-platform/fr/nas/nas-diagnostics.md) dans la documentation officielle.


---

# 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/learn-the-platform/fr/module-5-stockage/05-storage-monitoring.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.
