Guide d’état du tissu central

Comment lire, interpréter et dépanner l’état du tissu central dans VergeOS, y compris les valeurs de score, des exemples de tissu sain ou dégradé, et la vérification préalable à la maintenance.

Prérequis

Accès à l’interface VergeOS avec des privilèges de gestion des nœuds
Compréhension de base de l’architecture du réseau central VergeOS
Accès à la console physique ou à IPMI des nœuds (pour le dépannage)
Connaissance de vos affectations VLAN principales (Core 1 et Core 2) et de la vitesse de liaison NIC attendue

Qu’est-ce que la fabric principale ?

La fabric constitue l’épine dorsale de votre système VergeOS, en utilisant le réseau principal pour gérer toutes les communications de nœud à nœud, y compris le trafic vSAN, la découverte des pairs, les opérations de gestion, le trafic réseau inter-nœuds, les migrations de VM et de réseau, ainsi que d’autres fonctions.

Un déploiement VergeOS typique utilise deux réseaux principaux physiques indépendants (« Core 1 Switch », « Core 2 Switch ») pour la redondance. Chaque nœud doit disposer de deux chemins physiques indépendants vers chaque autre nœud du cluster.

Aucun saut de commutateur requis

Tous les nœuds doivent être connectés à la même fabric de commutation avec zéro saut de commutateur entre eux. La latence cible entre les nœuds sur les réseaux de la fabric principale est inférieure à 0,05 ms. L’ajout de sauts de commutateur introduit une latence qui dégrade les scores de la fabric et les performances du cluster.

Cette redondance de la fabric principale est essentielle pour maintenir la résilience du système et son fonctionnement ininterrompu, même en cas de panne d’un nœud ou d’un disque, et permet d’effectuer des opérations de maintenance sans interruption.

Exigences MTU de la fabric principale :

Composant

MTU

Port de commutateur physique

>= 9216

NIC physique

9192 (typique)

superposition VXLAN

MTU de la NIC moins 50 octets d’en-tête

Comment fonctionne la redondance de la fabric principale

La fabric principale gère la redondance à bas niveau, en créant un maillage où chaque nœud maintient des chemins redondants vers chaque autre nœud du système. En raison de cette redondance intégrée, le LAG physique ou l’agrégation de ports ne devrait pas pas être utilisé sur les réseaux de la fabric principale — cela interférerait avec les mécanismes propres à la fabric.

La fabric principale VergeOS offre une détection et une résilience plus complètes que l’agrégation de liens traditionnelle. Le LAG ne détecte et ne protège que contre les défaillances au niveau du lien, tandis que la fabric VergeOS fonctionne au niveau applicatif et détecte un éventail beaucoup plus large de problèmes, notamment les paquets perdus, les incohérences de MTU, les blocages de NIC et les micrologiciels défectueux — en plus des simples liens déconnectés.

Accès à l’état de la fabric (interface utilisateur)

L’état de la fabric est disponible dans l’interface utilisateur VergeOS à plusieurs niveaux de détail.

Méthode

Niveau de détail

Cas d’usage

Alarmes

Résumé

Surveillance quotidienne — alertes lorsque des chemins sont dégradés ou perdus

Liste des NIC des nœuds

Par NIC

Vérification rapide de l’état de toutes les NIC des nœuds

Tableau de bord du nœud

Par NIC (nœud sélectionné)

Vérification rapide de l’état des NIC individuelles et de leurs connexions aux autres nœuds

Diagnostics des nœuds

Rapport JSON complet

Dépannage avancé — détails complets des chemins, des scores et des pairs

Alarmes

Au quotidien, la surveillance de l’état de la fabric peut être gérée via le même système d’alarmes que celui utilisé pour le reste de votre environnement VergeOS. Une alerte d’avertissement est déclenchée lorsque la communication bidirectionnelle n’est pas disponible sur un chemin du réseau principal.

En cliquant sur une alarme dans la liste, vous accédez directement au tableau de bord du nœud affecté, où des détails supplémentaires sont disponibles.

Pour plus d’informations sur la consultation et la gestion des alarmes, consultez le Guide des alarmes.

Traitez immédiatement les alarmes du réseau principal

Les alarmes du réseau principal indiquent que votre système ne dispose peut-être pas de la redondance complète de la fabric. Résolvez-les rapidement afin de garantir que votre cluster puisse tolérer une panne sans interruption. Les déclencheurs d’événements peuvent être configurés pour envoyer des notifications par e-mail, par SMS via des systèmes d’alerte, via des canaux Slack surveillés, et plus encore, afin que les administrateurs soient avertis immédiatement. Consultez le Guide produit du moteur de tâches pour plus d’informations sur la création de tâches automatisées ; cet Exemple d’automatisation article de la base de connaissances fournit un exemple de configuration de notifications déclenchées par événement.

Liste des NIC des nœuds

C’est un moyen rapide de consulter l’état de la fabric sur toutes les NIC du réseau principal depuis une seule page.

Accédez à Infrastructure > Nœuds.
Cliquez sur NICs dans le menu de gauche.
Une liste de toutes les NIC de tous les nœuds est affichée. Le État du fabric colonne affiche l’état des NIC du réseau principal (par ex. « Confirmed », « No Path », « Degraded »). Un État du fabric de « None » est affiché pour les NIC qui ne participent pas à la fabric principale (par ex. réseaux externes).

Tableaux de bord des nœuds

Les informations d’état sont disponibles par NIC dans chaque tableau de bord de nœud.

Accédez à Infrastructure > Nœuds.
Double-cliquez sur le nœud dans la liste.
Faites défiler jusqu’à la section NICs section du tableau de bord du nœud. Chaque NIC de la fabric principale affiche soit un Confirmé indicateur d’état, soit un message d’état de problème (par ex. No Path, Degraded).
Pour plus de détails, cliquez sur l’icône du globe à droite. Une fenêtre contextuelle s’affiche avec les détails de la NIC :
- Fabricant, modèle, interface et pilote
- Confirmé / Aucun chemin / Dégradé état pour chaque connexion vers chaque autre nœud du système
- Score par connexion vers chaque autre nœud (voir Valeurs du score ci-dessous)
Chaque chemin doit afficher Confirmé l’état. Tout chemin affichant Aucun chemin ou Dégradé indique un problème de connectivité qui doit être étudié et résolu.

Diagnostics des nœuds

Des détails plus complets sur l’état de la fabric (utiles pour le dépannage avancé) sont disponibles via les diagnostics du nœud. Cela renvoie un rapport JSON complet de l’état de la fabric tel qu’il est vu par le nœud sélectionné, y compris tous les pairs découverts, leurs chemins, scores et état de confirmation.

Accédez à Infrastructure > Nœuds.
Sélectionnez le nœud dans la liste.
Cliquez sur Diagnostics dans le menu de gauche.
Sélectionnez Configuration de la fabric dans la Requête menu déroulant.
Cliquez sur Envoyer pour l’exécuter.
Examinez la sortie. Champs clés à vérifier en premier : paths[].confirmed et paths[].score pour chaque nœud pair.

Référence des champs

Les champs suivants apparaissent dans la sortie JSON de l’état de la fabric.

Champ

Description

$sysid

Hachage SHA-1 identifiant ce système VergeOS (provenant de /.system_id)

$last_update

Horodatage de la dernière actualisation de l’état de la fabric

syncing_time

Champ de niveau supérieur indiquant si le nœud synchronise actuellement son horloge avec le cluster. Cela doit être faux avant que le nœud ne rejoigne complètement le cluster. Lors de la jonction initiale d’un nœud, il est normal que la valeur soit true.

paths

Tableau des chemins réseau vers ce nœud pair

paths[].ip

Adresse IP du nœud distant sur le réseau principal

paths[].iface

Interface réseau locale utilisée pour atteindre ce chemin

paths[].score

Score numérique de qualité de connectivité (plus le score est élevé, mieux c’est). Le maximum dépend de la vitesse de liaison de la NIC — voir Valeurs du score ci-dessous.

paths[].confirmed

Si ce chemin a été vérifié comme actif et joignable (true / faux)

vxlans

Points de terminaison de tunnel VXLAN programmés pour ce pair. Ce sont les tunnels de superposition utilisés pour le trafic des réseaux virtuels inter-nœuds.

État de confirmation

Valeur

Signification

true

Le chemin a été vérifié — la communication bidirectionnelle fonctionne

faux

Le chemin n’a pas pu être vérifié — la connectivité est perdue ou n’a jamais été établie

Valeurs du score

Le score le champ représente la qualité de la connexion à un nœud pair via un chemin spécifique. Le score maximal correspond à la vitesse de liaison de la NIC principale — un score plus élevé indique une connexion plus rapide et plus saine.

Vitesse de liaison NIC

Score maximum

100 Gbit/s

200

50 Gbit/s

100

25 Gbit/s

10 Gbit/s

Interprétation des scores

Un score « parfait » signifie que la valeur correspond au maximum attendu pour la vitesse de votre NIC. Par exemple, un score de 50 sur une NIC 25 Gbit/s est sain, tandis qu’un score de 50 sur une NIC 100 Gbit/s indique une dégradation. Comparez toujours le score au maximum de votre vitesse de liaison.

Un score nettement inférieur à le maximum attendu indique une dégradation — les causes possibles incluent la latence réseau, la perte de paquets ou un routage sous-optimal. Un score de 0 indique une perte complète de la communication bidirectionnelle.

Confirmé vs score

confirmé indique si le chemin est joignable, tandis que score reflète la qualité de ce chemin.

Exemples de fabric saine et non saine

Fabric saine (système à 2 nœuds)

Tous les nœuds sont visibles, deux chemins chacun, scores au maximum pour la vitesse de la NIC, tous confirmés :

{
    "$sysid": "68e1925057aa7c6afaf9a255dcfc623794a6398e",
    "$last_update": "03/24/2026 13:31:46",
    "syncing_time": false,
    "node2": {
        "paths": [
            { "ip": "172.16.1.2", "iface": "enp148s0f0np0", "score": 200, "confirmed": true },
            { "ip": "172.16.2.2", "iface": "enp148s0f1np1", "score": 200, "confirmed": true }
        ],
        "vxlans": ["vx2 via 172.16.1.2", "vx1 via 172.16.2.2"]
    },
    "node1": {
        "paths": [
            { "ip": "172.16.1.1", "iface": "enp148s0f0np0", "score": 200, "confirmed": true },
            { "ip": "172.16.2.1", "iface": "enp148s0f1np1", "score": 200, "confirmed": true }
        ],
        "vxlans": ["vx2 via 172.16.1.1", "vx1 via 172.16.2.1"]
    }
}

Ce qu’il faut rechercher

Chaque nœud du cluster apparaît dans la sortie (dans un cluster à 4 nœuds, vous devez voir les 4 entrées de nœud)
Chaque nœud a deux chemins (un par réseau principal)
Tous les chemins affichent "confirmed": true
"syncing_time": false au niveau supérieur
Les scores correspondent au maximum attendu pour la vitesse de votre NIC (par ex. 200 pour 100 Gbit/s, 50 pour 25 Gbit/s)

Fabric dégradée — redondance perdue

Un chemin manquant pour un nœud (panne d’un seul réseau principal) :

{
    "node2": {
        "paths": [
            { "ip": "172.16.1.2", "score": 200, "confirmed": true }
        ]
    }
}

Impact

Le nœud n’est joignable que par un seul réseau principal. Si le chemin restant tombe en panne, le nœud perdra totalement la connectivité au cluster. À investiguer immédiatement.

Fabric dégradée — score faible

Les deux chemins sont présents mais l’un affiche une qualité réduite :

{
    "node2": {
        "paths": [
            { "ip": "172.16.1.2", "score": 200, "confirmed": true },
            { "ip": "172.16.2.2", "score": 120, "confirmed": true }
        ]
    }
}

Impact

Un score inférieur au maximum attendu pour la vitesse de votre NIC indique une dégradation du réseau sur ce chemin. Les performances vSAN peuvent être affectées. Vérifiez la latence, la perte de paquets ou les problèmes de commutateur sur le réseau principal concerné.

Fabric critique — chemin non confirmé

Un chemin existe mais ne peut pas être vérifié :

{
    "node2": {
        "paths": [
            { "ip": "172.16.1.2", "score": 200, "confirmed": true },
            { "ip": "172.16.2.2", "score": 0, "confirmed": false }
        ]
    }
}

Impact

Le nœud a perdu la communication sur un réseau principal. Si les deux chemins affichent "confirmed": false, le nœud est isolé du cluster, ce qui provoquera une perturbation de vSAN et des charges de travail.

Fabric critique — nœud manquant

Un nœud qui devrait se trouver dans le cluster n’apparaît pas du tout dans la sortie de la fabric.

Impact

Le nœud manquant est totalement injoignable. Il peut être hors tension, avoir ses deux NIC principales hors service, ou se trouver sur un VLAN différent. Vérifiez immédiatement la connectivité physique et l’état d’alimentation du nœud.

Vérification de la fabric avant maintenance

Les opérations de maintenance VergeOS — y compris les mises à jour du système, les montées en charge vSAN, et les extensions horizontales — nécessitent une fabric saine comme prérequis. N’engagez pas de maintenance si la fabric n’est pas saine. Résolvez d’abord tout problème à l’aide de la Dépannage section ci-dessous.

Une fabric saine signifie :

Tous les nœuds pairs sont visibles dans la sortie
Chaque pair a deux chemins (un par réseau principal)
Tous les chemins affichent "confirmed": true
Les scores correspondent au maximum attendu pour la vitesse de liaison de votre NIC
"syncing_time": false au niveau supérieur

Vérification rapide

Depuis n’importe quel nœud, exécutez Diagnostics des nœuds > Configuration de la fabric et confirmez que chaque pair répond aux critères ci-dessus avant de poursuivre la maintenance.