> 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/de/speicher/vsan-diagnostics.md). # Leitfaden zur vSAN-Diagnose ## Übersicht Das vSAN-Diagnosetool bietet umfassende Analyse- und Fehlerbehebungsfunktionen für Speichersysteme in den virtuellen Storage Area Networks von VergeOS. Diese Diagnosebefehle ermöglichen es Systemadministratoren, die Speicherleistung zu überwachen, Speicherprobleme zu beheben und die optimale vSAN-Gesundheit im gesamten Cluster aufrechtzuerhalten. {% hint style="info" %} **Was Sie lernen werden** * So greifen Sie auf vSAN-Diagnosetools zu und verwenden sie * Verständnis der einzelnen Diagnosebefehle und ihres Speicherfokus * Bewährte Verfahren für vSAN-Fehlerbehebung und Wartung * Wann bestimmte Diagnosebefehle bei Speicherproblemen verwendet werden sollten {% endhint %} ## Voraussetzungen * Zugriff auf die VergeOS-Oberfläche mit vSAN-Verwaltungsberechtigungen * Grundlegendes Verständnis verteilter Speicherkonzepte * Kenntnisse über die vSAN-Architektur von VergeOS {% hint style="info" %} **vSAN-Zugriff** vSAN-Diagnosen sind nur auf Root-/übergeordneter Ebene verfügbar. Mandanten haben keinen Zugriff auf vSAN-Diagnosetools. {% endhint %} ## Auf vSAN-Diagnosen zugreifen 1. **Navigieren Sie zu vSAN-Diagnosen:** * Wählen Sie **System** → **vSAN-Diagnose** im oberen Menü aus. * Oder alternativ: Klicken Sie im Haupt-Dashboard auf das **vSAN Tiers** Zählerfeld → **vSAN-Diagnose** im linken Menü. 2. **Diagnosebefehle verwenden:** * Wählen Sie den gewünschten Befehl aus dem **Abfrage** Dropdown-Menü * Konfigurieren Sie die verfügbaren Parameter auf der rechten Seite * Klicken Sie **Senden →** um den Befehl auszuführen {% hint style="success" %} **Sichtbarkeit der Befehle** Aktivieren Sie **„Befehl anzeigen“** um den exakt ausgeführten Befehl anzuzeigen; nützlich für die Ausführung per SSH oder die Skriptautomatisierung. {% endhint %} ## Referenz der Diagnosebefehle ### Inode suchen **Zweck:** Lokalisert bestimmte Inodes innerhalb des vSAN-Dateisystems für eine detaillierte Analyse. **Wann verwenden:** * Fehlerbehebung bei Beschädigungen des Dateisystems * Auffinden bestimmter Datenblöcke * Erweiterte Speicher-Fehlerbehebung **Parameter:** * **Inode-Nummer:** Spezifische Inode-Kennung zum Lokalisieren **CLI-Syntax:** ```bash vcmd find --inode=[INODE_NUMBER] ``` *** ### Cache-Info abrufen **Zweck:** Zeigt umfassende Informationen und Statistiken zum Cachesystem an. **Wann verwenden:** * Leistungsoptimierung * Analyse des Verhältnisses von Cache-Treffern und -Fehlzugriffen * Bewertung der Speichernutzung * Fehlerbehebung bei Speicherleistungsproblemen **CLI-Syntax:** ```bash vcmd cache info ``` *** ### Clients abrufen **Zweck:** Zeigt aktive vSAN-Clients und deren Verbindungsdetails an. **Wann verwenden:** * Fehlerbehebung bei Verbindungen * Analyse der Client-Performance * Überprüfung der Netzwerkkonnektivität * Bewertung der Lastverteilung **CLI-Syntax:** ```bash vcmd clients list ``` *** ### Cluster-Raten abrufen **Zweck:** Zeigt clusterweite Leistungskennzahlen und Durchsatzraten an. **Wann verwenden:** * Überwachung der Clusterleistung * Durchsatzanalyse * Festlegung einer Leistungs-Basislinie * Kapazitätsplanung **CLI-Syntax:** ```bash vcmd cluster rates ``` *** ### Cluster-Auslastung abrufen **Zweck:** Zeigt umfassende Statistiken zur Speichernutzung des Clusters an. **Wann verwenden:** * Kapazitätsplanung * Überwachung der Speicherauslastung * Analyse der Speicherzuweisung * Bewertung des Wachstumstrends **CLI-Syntax:** ```bash vcmd cluster usage ``` *** ### Aktuellen Master abrufen **Zweck:** Identifiziert den aktuellen vSAN-Masternode im Cluster. **Wann verwenden:** * Fehlerbehebung bei der Cluster-Führung * Analyse des Master-Failovers * Probleme bei der Cluster-Koordination * Leistungsoptimierung **CLI-Syntax:** ```bash vcmd master current ``` *** ### Geräteliste abrufen **Zweck:** Listet alle Speichergeräte auf, die an vSAN teilnehmen. **Wann verwenden:** * Verwaltung des Geräteinventars * Überprüfung der Speicherkonfiguration * Überwachung des Gerätestatus * Kapazitätsbewertung **CLI-Syntax:** ```bash vcmd devices list ``` *** ### Gerätestatus abrufen **Zweck:** Zeigt detaillierte Statusinformationen für vSAN-Speichergeräte an. **Wann verwenden:** * Überwachung des Gesundheitszustands von Geräten * Fehlererkennung * Leistungsanalyse * Wartungsplanung **Parameter:** * **Geräte-ID:** Spezifisches Gerät, das abgefragt werden soll **CLI-Syntax:** ```bash vcmd device status [DEVICE_ID] ``` *** ### Gerätenutzung abrufen **Zweck:** Zeigt Nutzungsstatistiken für einzelne Speichergeräte an. **Wann verwenden:** * Überwachung der Gerätenutzung * Analyse der Lastverteilung * Leistungsoptimierung * Bewertung des Wear-Levelings **Parameter:** * **Geräte-ID:** Zielgerät für die Analyse **CLI-Syntax:** ```bash vcmd device usage [DEVICE_ID] ``` *** ### Dateistatus abrufen **Zweck:** Ruft detaillierte Statusinformationen für bestimmte Dateien in vSAN ab. **Wann verwenden:** * Überprüfung der Dateiintegrität * Prüfung des Replikationsstatus * Nachverfolgung des Speicherorts von Daten * Untersuchung von Beschädigungen **Parameter:** * **Dateipfad:** Zieldatei für die Analyse **CLI-Syntax:** ```bash vcmd file status [FILE_PATH] ``` *** ### FUSE-Info abrufen **Zweck:** Zeigt Informationen zum FUSE-Mount und zum Betrieb an (Filesystem in Userspace). **Wann verwenden:** * Fehlerbehebung bei der Einbindung des Dateisystems * FUSE-Leistungsanalyse * Überprüfung des Mountpunkts * Diagnose von Zugriffsproblemen **CLI-Syntax:** ```bash vcmd fuse info ``` *** ### Status der Integritätsprüfung abrufen **Zweck:** Zeigt den Status laufender oder abgeschlossener Integritätsprüfungen an. **Wann verwenden:** * Überwachung der Datenintegrität * Nachverfolgung des Prüfprozesses * Erkennung von Beschädigungen * Überprüfung des Wartungsstatus **CLI-Syntax:** ```bash vcmd integcheck status ``` *** ### Journal-Status abrufen **Zweck:** Zeigt den vSAN-Journalstatus und Betriebsinformationen an. **Wann verwenden:** * Fehlerbehebung bei der Schreibleistung * Überwachung des Journal-Speichers * Analyse der Transaktionsprotokollierung * Leistungsoptimierung **CLI-Syntax:** ```bash vcmd journal status ``` *** ### Geräteliste des Knotens abrufen **Zweck:** Listet Speichergeräte für bestimmte Knoten im Cluster auf. **Wann verwenden:** * Knotenspezifisches Geräteinventar * Kapazitätsplanung pro Knoten * Analyse der Geräteverteilung * Vorbereitung der Knotenwartung **Parameter:** * **Knoten-ID:** Zielknoten für die Geräteauflistung **CLI-Syntax:** ```bash vcmd node devices [NODE_ID] ``` *** ### Knoteninfo abrufen **Zweck:** Zeigt umfassende Informationen über bestimmte vSAN-Knoten an. **Wann verwenden:** * Bewertung des Knotenzustands * Überprüfung der Konfiguration * Leistungsanalyse * Fehlerbehebung bei Knotenproblemen **Parameter:** * **Knoten-ID:** Zielknoten-Kennung **CLI-Syntax:** ```bash vcmd node info [NODE_ID] ``` *** ### Knotenliste abrufen **Zweck:** Listet alle Knoten auf, die am vSAN-Cluster teilnehmen. **Wann verwenden:** * Überprüfung der Cluster-Mitgliedschaft * Verwaltung des Knoteninventars * Analyse der Cluster-Topologie * Übersicht über den Gesundheitsstatus **CLI-Syntax:** ```bash vcmd nodes list ``` *** ### Pfad aus Inode abrufen **Zweck:** Löst Dateisystempfade aus Inode-Nummern auf. **Wann verwenden:** * Navigation im Dateisystem * Zuordnung von Inode zu Pfad * Analyse von Beschädigungen * Erweiterte Fehlerbehebung **Parameter:** * **Inode-Nummer:** Quell-Inode für die Pfadauflösung **CLI-Syntax:** ```bash vcmd path from-inode [INODE_NUMBER] ``` *** ### Read-Ahead abrufen **Zweck:** Zeigt die Konfiguration und Statistiken des Read-Ahead-Cache an. **Wann verwenden:** * Optimierung der Lesegeschwindigkeit * Cache-Tuning * Analyse des sequentiellen Zugriffs * Fehlerbehebung bei der Leistung **CLI-Syntax:** ```bash vcmd readahead status ``` *** ### Reparaturstatus abrufen **Zweck:** Zeigt den Status laufender Reparaturvorgänge und der Datenrekonstruktion an. **Wann verwenden:** * Überwachung der Datenreparatur * Nachverfolgung des Wiederherstellungsprozesses * Bewertung der Fehlerwiederherstellung * Überprüfung des Wartungsstatus **CLI-Syntax:** ```bash vcmd repair status ``` *** ### Laufende Konfiguration abrufen **Zweck:** Zeigt die aktuelle laufende Konfiguration des vSAN-Systems an. **Wann verwenden:** * Überprüfung der Konfiguration * Fehlerbehebung bei Konfigurationsproblemen * Referenz für die Backup-Konfiguration * Änderungsmanagement **CLI-Syntax:** ```bash vcmd config show ``` *** ### Synchronisierungsliste abrufen **Zweck:** Listet Synchronisierungsvorgänge und deren Status auf. **Wann verwenden:** * Überwachung der Datensynchronisation * Nachverfolgung des Replikationsstatus * Überprüfung der Konsistenz * Leistungsanalyse **CLI-Syntax:** ```bash vcmd sync list ``` *** ### Tier-Gerätezuordnungen abrufen **Zweck:** Zeigt die Gerätezuordnung über verschiedene Speicher-Tiers hinweg an. **Wann verwenden:** * Überprüfung der Tier-Konfiguration * Analyse der Geräteplatzierung * Leistungsoptimierung * Kapazitätsplanung **CLI-Syntax:** ```bash vcmd tier device-maps ``` *** ### Tier-Knoten-Zuordnungen abrufen **Zweck:** Zeigt an, wie sich die Speicher-Tiers über die Clusterknoten verteilen. **Wann verwenden:** * Analyse der Tier-Verteilung * Überprüfung der Lastverteilung * Leistungsoptimierung * Kapazitätsplanung **CLI-Syntax:** ```bash vcmd tier node-maps ``` *** ### Tier-Status abrufen **Zweck:** Zeigt umfassende Statusinformationen für Speicher-Tiers an. **Wann verwenden:** * Überwachung des Tier-Gesundheitszustands * Leistungsanalyse * Nachverfolgung der Kapazitätsauslastung * Tier-Optimierung **CLI-Syntax:** ```bash vcmd tier status ``` *** ### Top-Auslastungsraten abrufen **Zweck:** Identifiziert die größten Verbraucher von Speicherressourcen und Leistung. **Wann verwenden:** * Identifizierung von Leistungsengpässen * Analyse der Ressourcenauslastung * Kapazitätsplanung * Optimierung der Nutzung **CLI-Syntax:** ```bash vcmd usage top-rates ``` *** ### Nutzung abrufen **Zweck:** Zeigt umfassende vSAN-Nutzungsstatistiken und -Kennzahlen an. **Wann verwenden:** * Überwachung der gesamten Systemauslastung * Kapazitätsplanung * Festlegung einer Leistungs-Basislinie * Analyse der Ressourcenverteilung **CLI-Syntax:** ```bash vcmd usage show ``` *** ### Volume-Nutzung abrufen **Zweck:** Zeigt Nutzungsstatistiken für einzelne Volumes innerhalb von vSAN an. **Wann verwenden:** * Kapazitätsüberwachung pro Volume * Leistungsanalyse * Überprüfung der Speicherplatzzuweisung * Verfolgung des Wachstums **Parameter:** * **Volume-ID:** Ziel-Volume für die Analyse **CLI-Syntax:** ```bash vcmd volume usage [VOLUME_ID] ``` *** ### Integritätsprüfung **Zweck:** Startet eine umfassende Prüfung der Datenintegrität im gesamten vSAN. **Wann verwenden:** * Geplante Wartung * Untersuchung von Datenbeschädigungen * Vorsorgliche Gesundheitsprüfungen * Überprüfung nach einem Ausfall {% hint style="warning" %} **Auswirkungen auf die Leistung** Integritätsprüfungen können die Systemleistung erheblich beeinträchtigen und sollten während Wartungsfenstern geplant werden. {% endhint %} **CLI-Syntax:** ```bash vcmd integcheck start ``` *** ### Integritätsprüfung für Gerät **Zweck:** Führt Integritätsprüfungen an bestimmten Speichergeräten durch. **Wann verwenden:** * Gerätespezifische Integritätsprüfung * Gezielte Fehlerbehebung * Überprüfung nach Reparatur * Selektive Wartung **Parameter:** * **Geräte-ID:** Zielgerät für die Integritätsprüfung **CLI-Syntax:** ```bash vcmd integcheck device [DEVICE_ID] ``` *** ### Festplattennutzung zusammenfassen **Zweck:** Bietet eine umfassende Zusammenfassung der Festplattennutzung im gesamten vSAN. **Wann verwenden:** * Kapazitätsbericht * Analyse von Nutzungstrends * Planung der Speicheroptimierung * Berichterstattung für Führungskräfte **CLI-Syntax:** ```bash vcmd usage summarize ``` ## Bewährte Vorgehensweisen ### Workflow zur vSAN-Gesundheitsüberwachung 1. **Systemübersicht:** Beginnen Sie mit Get Cluster Usage und Get Cluster Rates 2. **Leistungsanalyse:** Überprüfen Sie Get Top Usage Rates und gerätespezifische Kennzahlen 3. **Gesundheitsbewertung:** Prüfen Sie Get Repair Status und Get Integ Check Status 4. **Kapazitätsplanung:** Verwenden Sie Summarize Disk Usage und Tier-Informationen 5. **Fehlerbehebung:** Verwenden Sie bei Bedarf gerätespezifische und knotenspezifische Befehle ### Vorbeugende Wartung * **Regelmäßige Gesundheitsprüfungen:** Überwachen Sie Cluster-Nutzung, Reparaturstatus und Gerätezustand * **Leistungsüberwachung:** Verfolgen Sie Cluster-Raten und Nutzungsmuster mit hoher Priorität * **Integritätsprüfung:** Planen Sie regelmäßige Integritätsprüfungen während Wartungsfenstern * **Kapazitätsplanung:** Überprüfen Sie regelmäßig Nutzungstrends und Wachstumsmuster ### Leistungsoptimierung * **Cache-Analyse:** Überwachen Sie Cache-Info und Trefferquoten auf Optimierungsmöglichkeiten * **Tier-Verwaltung:** Überprüfen Sie Tier-Gerätezuordnungen und Knoten-Zuordnungen für eine ausgewogene Verteilung * **Lastverteilung:** Verwenden Sie Client- und Nutzungsinformationen, um die Arbeitslastverteilung zu optimieren * **Leseoptimierung:** Passen Sie die Read-Ahead-Einstellungen basierend auf Zugriffsmustern an ## Häufige vSAN-Probleme beheben ### Leistungsprobleme 1. Prüfen Sie **Cluster-Raten abrufen** und **Top-Auslastungsraten abrufen** nach Engpässen 2. Prüfen Sie **Cache-Info abrufen** nach Cache-Effizienz 3. Analysieren Sie **Gerätenutzung abrufen** nach der Leistung einzelner Geräte ### Kapazitätsprobleme 1. Verwenden Sie **Cluster-Auslastung abrufen** und **Festplattennutzung zusammenfassen** zur Speicherplatzanalyse 2. Prüfen Sie **Tier-Status abrufen** zur kapazitätsspezifischen Analyse von Tiers 3. Prüfen Sie **Volume-Nutzung abrufen** für den Verbrauch einzelner Volumes ### Bedenken hinsichtlich der Datenintegrität 1. Prüfen Sie **Status der Integritätsprüfung abrufen** für aktuelle Integritätsprüfungen 2. Prüfen Sie **Reparaturstatus abrufen** für laufende Reparaturen 3. Verwenden Sie **Dateistatus abrufen** zur Überprüfung der Integrität bestimmter Dateien ### Probleme mit dem Clusterzustand 1. Überprüfen Sie **Aktuellen Master abrufen** für den Führungsstatus 2. Prüfen Sie **Knotenliste abrufen** und **Knoteninfo abrufen** für den Zustand der Knoten 3. Prüfen Sie **Synchronisierungsliste abrufen** für Synchronisierungsprobleme ### Geräteprobleme 1. Verwenden Sie **Geräteliste abrufen** und **Gerätestatus abrufen** für den Gerätezustand 2. Prüfen Sie **Geräteliste des Knotens abrufen** für knotenspezifische Geräteprobleme 3. Ausführen **Integritätsprüfung für Gerät** bei vermuteten Geräteproblemen ## Erweiterte Diagnosen ### Dateisystemanalyse * Verwenden Sie **Inode suchen** und **Pfad aus Inode abrufen** für die Untersuchung des Dateisystems * Verwenden Sie **Dateistatus abrufen** für die detaillierte Dateianalyse * Prüfen Sie **FUSE-Info abrufen** für mountbezogene Probleme ### Konfigurationsverwaltung * Prüfen Sie **Laufende Konfiguration abrufen** für die aktuelle Konfiguration * Überprüfen Sie Tier- und Gerätezuordnungen mit Zuordnungsbefehlen * Vergleichen Sie Knoten- und Geräteinformationen auf Konsistenz ### Leistungsoptimierung * Analysieren Sie Cache- und Read-Ahead-Statistiken zur Optimierung * Überwachen Sie Client-Verbindungen und Nutzungsmuster * Überprüfen Sie den Journalstatus zur Optimierung der Schreibleistung ## Nächste Schritte Nachdem Sie die vSAN-Diagnose beherrschen, sollten Sie Folgendes erkunden: * Fortgeschrittene Techniken zur vSAN-Leistungsoptimierung * Automatisierte Überwachungs- und Alarmierungssysteme * Integration mit externen Speicherverwaltungstools * Strategien für Notfallwiederherstellung und Backup Bei komplexen vSAN-Problemen oder Fragen zur Leistungsoptimierung wenden Sie sich an [VergeOS-Support](/overview/de/support-and-services.md) mit detaillierten Diagnoseausgaben und Informationen zur Systemkonfiguration. --- # 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/de/speicher/vsan-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.