WORKSPACE.PM
Zurück zur Wissensdatenbank

Wie erstelle ich ein Diagnosepaket für den Support?

3 Min. Lesezeit
Aktualisiert: 23.8.2026

Diagnosepaket und Supportweg

Übersicht

Es gibt keine Telemetrie: Ihre Instanz meldet nichts an uns. Das Diagnosepaket ist der einzige Weg, auf dem der Support den Zustand Ihres Servers sehen kann - und Sie schnüren und verschicken es selbst. Vor dem Schreiben listet wsp auf, was hineinkommt.

Voraussetzungen

  • Root-Rechte auf dem Server
  • Ein Zugang zum Helpdesk für das Ticket

Schritt-für-Schritt-Anleitung

  1. Paket schnüren

    sudo wsp doctor --bundle
    • wsp listet vor dem Schreiben auf, was enthalten ist, und nennt am Ende den Dateinamen

  2. Den Inhalt vor dem Verschicken ansehen

    tar tzf wsp-diagnose-20260823-174512.tar.gz
tar xzf wsp-diagnose-20260823-174512.tar.gz -O env.redacted

  3. Ticket im Helpdesk anlegen und das Paket anhängen

  4. Die richtigen Angaben mitgeben

    • Was Sie tun wollten, zum Beispiel "Update von 2.6.1 auf 2.7.0"
    • Was geschah, mit dem genauen Wortlaut der Fehlermeldung und dem Rückgabewert
    • Wann, seit wann und wen es betrifft
    • Was Sie schon versucht haben

Was enthalten ist

DateiInhalt
wsp-version.txtVersion des Werkzeugs
state.jsonZustand der Installation
env.redactedKonfiguration, Geheimnisse maskiert
instance-idKennung der Instanz
preflight.txtPrüfungen zum Zeitpunkt des Pakets
docker-services.txtDocker-Sicht auf den Stack
docker-ps.txtDocker-Sicht auf den Stack
backups.txtListe der Sicherungen
logs/*.logLauf-Protokolle

Was nicht enthalten ist

  • Das Verzeichnis /etc/wsp/secrets/ - vollständig, nicht ein einziger Wert
  • Ihr Lizenzschlüssel, in der Konfigurationskopie durch <entfernt> ersetzt
  • SMTP-Passwort und Resend-Schlüssel, ebenso ersetzt
  • Ihre Fachdaten: keine Projekte, keine Nutzer, keine Dateien
  • Die Sicherungen selbst, nur deren Liste

Häufige Fehler und Tipps

  • Tipp: Die Kennung Ihrer Instanz bringt den Support besonders weiter.
    • Sie steht im Paket unter instance-id.
  • Tipp: Den genauen Wortlaut der Fehlermeldung mitschicken.
    • Eine Umschreibung kostet eine Rückfrage.
  • Hinweis: Bei rotem Abnahmelauf und bei fehlgeschlagener Migration gehört das Paket immer dazu.
  • Tipp: Das Paket lässt sich vor dem Verschicken vollständig einsehen.
    • Sie können jede Datei darin öffnen und prüfen, bevor Sie es aus der Hand geben.

Weiterführende Informationen