> 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/systemadministration/diagnostics.md). # Systemdiagnose Der *Systemdiagnose* Mit dieser Funktion können umfangreiche Systeminformationen schnell und einfach in einer einzigen komprimierten Datei gesammelt werden. Dabei wird ein Schnappschuss der Systemdetails zu einem bestimmten Zeitpunkt erfasst, einschließlich: ungefilterter Protokolle, Konfigurationsinformationen, Netzwerk- und Statusdaten sowie anderer Kennzahlen, die für Analyse und Fehlerbehebung nützlich sind. Diese Informationspunkte lassen sich in der Regel zwar einfacher über die VergeOS-Oberfläche abrufen, doch das Erzeugen der Systemdiagnosedatei kann eine bequeme Möglichkeit sein, alle Informationen zu sammeln und direkt an den VergeIO-Support zur professionellen Analyse zu senden. ## Wann Systemdiagnose ausführen Wenn Sie mit dem Support an einem Problem arbeiten, werden Sie möglicherweise aufgefordert, die Systemdiagnose auszuführen, um umfassende Informationen zur Unterstützung bei der Fehlerbehebung einfach zu sammeln. Eine Systemdiagnosedatei kann auch als Ausgangsbasis vor der Umsetzung einer erheblichen Systemänderung verwendet werden; nach der Änderung kann eine weitere Datei zum Vergleich ausgelöst werden. {% hint style="warning" %} **Auswirkungen berücksichtigen** * Das Auslösen der Systemdiagnose kann die Leistung beeinträchtigen, da dabei die Hardware geprüft und umfangreiche Informationen von jedem Knoten erfasst werden. * Sobald sie ausgelöst wurde, kann ein Systemdiagnosevorgang nicht abgebrochen werden. {% endhint %} ## Eine Systemdiagnosedatei erzeugen 1. Navigieren Sie zu **System** > **Systemdiagnose** 2. Klicken Sie **Erstellen** im linken Menü. 3. Geben Sie einen **Namen** und **Beschreibung** für den Diagnose-Build. Wenn Name leer gelassen wird, erzeugt das System automatisch einen Namen im Format: \[SYSTEMNAME]\_*diags*\_\[yyyymmdd\_hhmmss], z. B. Verge-Det\_diags\_20241113\_121503 {% hint style="success" %} **Name/Beschreibung** * Geben Sie vor dem direkten Senden an den VergeIO-Support immer einen aussagekräftigen Namen/eine aussagekräftige Beschreibung ein. * Ein identifizierender Name und eine Beschreibung helfen dabei, verschiedene Diagnoseinstanzen auf demselben System leicht zu unterscheiden. * Diese Felder können auch nach Abschluss der Generierung der Systemdiagnose bearbeitet werden. {% endhint %} 4. Wenn Sie mit dem Support arbeiten und das System über eine Internetverbindung verfügt, können Sie das Kontrollkästchen aktivieren, um ***Diagnoseinformationen an den Verge.io-Support senden***. Diese Option ist auch nach Abschluss der Dateierstellung verfügbar, über die *Bearbeiten* Option. {% hint style="info" %} **Direktes Senden an den VergeIO-Support** * Systemdiagnosen, die direkt von der Benutzeroberfläche an Verge.io gesendet werden, sind während der Übertragung verschlüsselt. * Der *Status* Das Feld zeigt an, wann ein Bericht direkt an den Support gesendet wurde. {% endhint %} 5. Klicken Sie **Senden** um die Datei zu erzeugen. Informationen werden von allen online befindlichen Knoten in Ihrem System abgerufen. Je nach Anzahl der Knoten und Größe der Protokolle kann dieser Vorgang einige bis mehrere Minuten oder länger dauern. Während der Erstellung zeigt die **Status** Spalte den Knoten an, an dem gerade gearbeitet wird, und zeigt **Abgeschlossen** an, wenn die Diagnosedatei erfolgreich fertiggestellt wurde. ## Herunterladen Für ein Air-Gapped-System oder ein System, das anderweitig keinen Internetzugang hat: Wählen Sie nach Abschluss der Dateierstellung die Diagnosedatei aus und klicken Sie auf *Herunterladen*. Koordinieren Sie die Übergabe der Datei zur Analyse mit Ihrem Support-Ansprechpartner. {% hint style="warning" %} **Auch wenn Systemdiagnosedateien niemals Benutzerdaten enthalten, werden potenziell sensible Informationen wie IP-Adressen, Netzwerkdetails sowie Namen von Mandanten und VMs einbezogen. Gehen Sie beim Herunterladen und Übertragen einer Systemdiagnosedatei sorgfältig vor, damit nur autorisiertes Personal Zugriff hat.** {% endhint %} ## Allgemeine Dateiinformationen ### Aufbau * Die oberste Ebene der Datei ist nach Host-Knoten gegliedert. * Der Ordner des Controller-Knotens (typischerweise Knoten 1) enthält ausführlichere Informationen als die Ordner anderer Knoten. ### Inhalt * **Protokolle der Mandantenknoten** - Systemprotokolle von jedem Mandantenknoten * **VergeOS-Konfigurationsinformationen** - VergeOS-Netzwerk- und vSAN-Spezifikationen, Version und andere Konfigurationseinstellungen * **SMART-Berichte** - S.M.A.R.T.-Diagnosebericht von jedem physischen Laufwerk * **vNet-Protokolle** - Containerprotokolle (DMZ, Kern, extern, Wartung, Mandanten-Netzwerke) * **Netzwerkberichte** - Ausgaben standardmäßiger Netzwerk-Utilities * **vSAN-Diagnose** - vSAN-Befehlsausgaben * **Blockgerätelisten** - strukturelle und beschreibende Informationen zu Blockgeräten (logische Sicht des Speichers) * **Kernel-Protokolle** - typischerweise leer, kann aber Einträge enthalten, wenn es zu Systemabstürzen oder Hardwarefehlern kommt * **Vollständige Systemprotokolle** - vollständiges aktuelles Systemprotokoll und bis zu 3 archivierte Systemprotokolle aus vorherigen Ein-/Ausschaltzyklen des Knotens * **Diagnose auf Betriebssystemebene** - Ausgaben standardmäßiger Linux-Diagnosebefehle * **Systemstatistiken** - eine Sammlung von Leistungsüberwachungsberichten, erstellt mit Linux sysstat * **Niedrigstufige OS-Informationen** - Informationen zu Systemressourcen, Hardware und aktiven Prozessen --- # 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/systemadministration/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.