Diagnoseprotokolle und Support-Verfahren

Wenn ein Fehler auftritt, ist strukturierte Telemetrie der schnellste Weg zu einer Ursachenanalyse (Root Cause Analysis, RCA). StateWarden zeichnet detaillierte Audit-Ereignisse auf Ebene der Control Plane und nach Level gestufte Diagnoseprotokolle auf jedem Agenten auf.

Wenn Sie den StateWarden-Support kontaktieren oder eigene interne Diagnosen durchführen, reicht es nicht, sich auf vage Beschreibungen zu verlassen („das Backup ist fehlgeschlagen"). Verwenden Sie die unten beschriebenen integrierten Diagnosewerkzeuge.

1. Realm-Aktivität und Audit-Nachweise (Control Plane)

Die primäre Wahrheitsquelle für die gesamte Infrastruktur ist der Audit-Trail des Realms. Er enthält keine Low-Level-Debug-Ausgaben; er zeichnet Aktionen und Zustandsänderungen auf.

• Ereignisse & Protokolle (/events): Zeigt die Realm-Aktivität: Anmeldeereignisse, RBAC-Änderungen, Änderungen und Ausführungen von Backup-Richtlinien, die Generierung von BMR-Token, Kontingent-Ablehnungen und Vigil-Triage-Entscheidungen. Einträge können nach Quelle (Dashboard, Artemis, Driad, Agent) und nach Schweregrad gefiltert werden.
• Audit-Paket (/audit-pack): Erstellt Audit-Nachweisberichte für das Realm (z. B. für Compliance-Audits), zusammengestellt aus der aufgezeichneten Aktivität.
• Verwendung: Wenn ein Administrator fragt: „Warum lief das Datenbank-Backup letzte Nacht nicht?", zeigt die Seite „Ereignisse & Protokolle" sofort, ob die Aufgabe wegen Überschreitung des Tageskontingents abgelehnt wurde oder ob ein Benutzer manuell eine Backup-Löschung ausgeführt hat.

2. Protokolle auf Geräteebene (der Agent)

Wenn die Control Plane die Aufgabe erfolgreich verteilt hat, der Vorgang aber lokal fehlgeschlagen ist (z. B. eine gesperrte Festplatte, ein Netzwerk-Timeout, ein VSS-Fehler), müssen Sie die internen Protokolle des Agenten konsultieren.

Der StateWarden-Agent besteht aus zwei Prozessen: sw-launcher (dem Supervisor, der Updates verwaltet und den Worker nach Abstürzen neu startet) und sw-agent (dem Worker, der Backup- und Sicherheitsaufgaben ausführt). Beide schreiben nach Level gestufte Protokolle.

Protokolle über das Dashboard anzeigen

Bei Standardfehlern müssen Sie sich nicht per SSH oder RDP auf der betroffenen Maschine anmelden.

1. Navigieren Sie zur Ansicht Geräte.
2. Wählen Sie das betroffene Gerät, um sein Detailpanel zu öffnen.
3. Klicken Sie auf den Tab Protokolle. Der Agent streamt seine jüngsten lokalen Ausgaben sicher zurück an die Artemis Control Plane, damit Sie sie bequem einsehen können.

Lokaler Zugriff auf die Rohprotokolle

Bei schwerwiegenden Fehlern (z. B. wenn der Agent vollständig offline ist und nicht zum Dashboard streamen kann) greifen Sie auf die Rohtextdateien auf der Host-Maschine zu.

• Windows: C:\ProgramData\StateWarden\logs\ (launcher.log, agent.log)
• Linux: /var/log/statewarden/ (launcher.log, agent.log) oder das systemd-Journal: journalctl -u statewarden --no-pager

3. Support kontaktieren (Ticket-System)

StateWarden enthält ein integriertes Support-Ticket-System zur Nachverfolgung von Problemen bis zu ihrer Lösung.

• Ein Ticket öffnen: Öffnen Sie in der Navigationsleiste des Dashboards HELP → My Tickets (/support) und klicken Sie anschließend auf New Ticket. Geben Sie Folgendes an:
  • Subject - eine einzeilige Zusammenfassung.
  • Category - General, Bug Report, Feature Request, Billing oder Security.
  • Priority - Low, Normal, High oder Critical.
  • Message - eine detaillierte Beschreibung des Problems, einschließlich relevanter Ereignistypen oder Protokollauszüge.
• Weiterbearbeitung: Antworten des Support-Teams erscheinen im Ticket-Thread; Sie können antworten und Statusänderungen in derselben Ansicht verfolgen.
• Interne Bearbeitung: Das Support-Team arbeitet in einer dedizierten Admin-Warteschlange (/admin/support), wo es den Ticket-Status ändern und interne Notizen anhängen kann.

Hängen Sie Fehlerberichten nach Möglichkeit immer ein Diagnose-Bundle an (Abschnitt 4); dies verkürzt die Zeit bis zur Lösung erheblich.

4. Ein sicheres Support-Bundle generieren

Wenn Sie ein Problem an die StateWarden-Entwicklung eskalieren, wird technischer Kontext benötigt.

Um die versehentliche Übertragung sensibler Daten (wie Masterschlüssel oder proprietäre Konfigurationsdateien) über unsichere Kanäle zu verhindern, stellt die StateWarden-CLI einen Bundle-Befehl bereit.

1. Öffnen Sie ein Terminal auf der betroffenen Maschine.
2. Führen Sie aus: sw diag bundle
3. Der Agent sammelt aktuelle Protokolldateien, den Zustand der Netzwerkkonfiguration, den Status der VSS-Writer (Windows) und grundlegende Hardware-Telemetrie.
4. Das Bundle wird bereinigt: Es enthält kein kryptografisches Material und keine personenbezogenen Daten.
5. Es erzeugt ein komprimiertes .zip- oder .tar.gz-Archiv, das Sie Ihrem Support-Ticket anhängen können.

StateWarden: Resilience Engineered.