Dropstone Fehlerbehebungsleitfaden - Probleme diagnostizieren und beheben

Dieser Leitfaden bietet systematische Ansätze zur Diagnose und Behebung häufiger Probleme mit Dropstone.io. Befolgen Sie diese Schritte, um die notwendigen Informationen zu sammeln, bevor Sie den Support kontaktieren.

Wichtige Informationen für die Fehlerbehebung

Die folgenden Informationen sind für die meisten Fehlerbehebungsszenarien in Dropstone entscheidend:

1. Visuelle Dokumentation

Screenshot des Problems (vertrauliche Informationen schwärzen)

• Erfassen Sie das gesamte Anwendungsfenster mit der Fehlermeldung
• Fügen Sie alle Fehlermeldungen oder Dialoge hinzu
• Stellen Sie sicher, dass Zeitstempel sichtbar sind, falls verfügbar

2. Reproduktionsschritte

Geben Sie detaillierte Schritte zur Reproduktion des Problems an:

1. Durchgeführte Aktion (z. B. "Auf 'Deploy'-Button geklickt")
2. Erwartetes Verhalten
3. Tatsächliches Verhalten
4. Häufigkeit (immer, manchmal, einmal)

3. Systeminformationen

Systeminformationen abrufen von:

Dropstone → Hilfe → Über

Dies beinhaltet:

• Dropstone-Version
• Betriebssystem
• Architektur (x64, arm64)
• Electron-Version
• Node.js-Version

4. Netzwerkkonfiguration

Verwenden Sie eine der folgenden Optionen?

• VPN (Virtual Private Network)
• Zscaler oder andere Sicherheitsproxys
• Unternehmensfirewall
• Benutzerdefinierte DNS-Einstellungen

5. Entwickler-Tools-Konsole

Entwicklertools öffnen, um auf JavaScript-Fehler zu prüfen:

Dropstone → Hilfe → Entwicklertools umschalten

Navigieren Sie zum Tab Konsole und prüfen Sie auf:

• Rote Fehlermeldungen
• Warnmeldungen im Zusammenhang mit Ihrem Problem
• Fehlgeschlagene Netzwerkanfragen

Kopieren Sie relevante Fehler-Stacktraces.

6. Anwendungsprotokolle

Windows

Protokolle befinden sich unter:

C:\Users\<Ihr-Benutzername>\AppData\Roaming\Dropstone\logs

Zugriff über die Befehlspalette:

1. Drücken Sie Strg + Umschalt + P
2. Tippen und auswählen: Entwickler: Protokollordner öffnen

macOS

Protokolle befinden sich unter:

~/Library/Application Support/Dropstone/logs

Zugriff über die Befehlspalette:

1. Drücken Sie Cmd + Umschalt + P
2. Tippen und auswählen: Entwickler: Protokollordner öffnen

Linux

Protokolle befinden sich unter:

~/.config/Dropstone/logs

Protokolle in der Anwendung anzeigen

Navigieren Sie zu: Dropstone → Terminal → Ausgabe

Wählen Sie aus dem Dropdown-Menü:

• Fenster - Allgemeine Anwendungsprotokolle
• Dropstone Core - Protokolle der Kernfunktionen
• Dropstone Deployment - Bereitstellungsbezogene Protokolle
• Dropstone Storage - Speicher- und Datenbankprotokolle
• Dropstone API - API-Anfrage-/Antwortprotokolle

Häufige Probleme und Lösungen

Verbindungsprobleme

Problem: Keine Verbindung zu Dropstone-Diensten möglich

Symptome:

• "Verbindungszeitüberschreitung"-Fehler
• "Server nicht erreichbar"-Meldungen
• Unendliche Ladezustände

Lösungen:

1. Internetverbindung prüfen

   # Windows
   ping dropstone.io
   
   # macOS/Linux
   ping dropstone.io
   

2. Firewall-Einstellungen überprüfen

   • Stellen Sie sicher, dass Dropstone durch Ihre Firewall zugelassen ist
   • Prüfen Sie Unternehmensnetzwerkrichtlinien
   • Fügen Sie die Domain *.dropstone.io zur Whitelist hinzu

3. Proxy-Konfiguration

   Proxy-Einstellungen konfigurieren:

   Dropstone → Einstellungen → Netzwerk → Proxy-Einstellungen

   Oder Umgebungsvariablen festlegen:

   export HTTP_PROXY=http://proxy.example.com:8080
   export HTTPS_PROXY=http://proxy.example.com:8080
   

4. DNS-Auflösung

   • DNS-Cache leeren
   • Alternative DNS-Server versuchen (8.8.8.8, 1.1.1.1)

Authentifizierungsprobleme

Problem: Anmeldefehler oder Token-Ablauf

Symptome:

• "Authentifizierung fehlgeschlagen"-Fehler
• Wiederholte Anmeldeaufforderungen
• 401 Unauthorized-Antworten

Lösungen:

1. Authentifizierungs-Cache leeren

   Dropstone → Befehlspalette → Authentifizierungs-Cache leeren

2. Erneut authentifizieren

   1. Von Dropstone abmelden
   2. Browser-Cookies für dropstone.io löschen
   3. Erneut anmelden
   

3. Token-Gültigkeit prüfen

   Navigieren Sie zu: Einstellungen → Konto → Sitzungsverwaltung

   Überprüfen Sie aktive Sitzungen und widerrufen Sie verdächtige.

4. SSO-Probleme

   Bei Verwendung von Single Sign-On:

   • Überprüfen Sie, ob der SSO-Anbieter erreichbar ist
   • Prüfen Sie auf abgelaufene SAML-Assertions
   • Kontaktieren Sie Ihren Identitätsanbieter-Administrator

Leistungsprobleme

Problem: Langsame Anwendungsreaktion oder hohe CPU-Auslastung

Symptome:

• Verzögerungen beim Tippen oder Klicken
• Hohe CPU-/Speicherauslastung
• Eingefrorene oder nicht reagierende Benutzeroberfläche

Lösungen:

1. Ressourcennutzung prüfen

   Dropstone → Hilfe → Prozessmanager

   Identifizieren Sie Prozesse, die übermäßige Ressourcen verbrauchen.

2. Erweiterungen deaktivieren

   Deaktivieren Sie vorübergehend Erweiterungen, um das Problem zu isolieren:

   Einstellungen → Erweiterungen → Alle deaktivieren → Neu starten

3. Cache leeren

   Dropstone → Einstellungen → Erweitert → Cache leeren
   

4. Projektgröße reduzieren

   • Große Dateien von der Indizierung ausschließen
   • Zur .dpsignore-Datei hinzufügen:
   node_modules/
   dist/
   build/
   *.log
   .git/
   

5. Hardwarebeschleunigung

   GPU-Beschleunigung umschalten:

   Einstellungen → System → Hardwarebeschleunigung verwenden

Bereitstellungsprobleme

Problem: Fehlgeschlagene Bereitstellungen

Symptome:

• Build-Fehler
• Bereitstellungszeitüberschreitungen
• "Push zum Remote fehlgeschlagen"-Fehler

Lösungen:

1. Build-Protokolle prüfen

   Detaillierte Build-Ausgabe anzeigen:

   Bereitstellung → Verlauf → Fehlgeschlagene Bereitstellung auswählen → Protokolle anzeigen

2. Umgebungsvariablen überprüfen

   Einstellungen → Bereitstellung → Umgebungsvariablen
   

   Stellen Sie sicher, dass alle erforderlichen Variablen festgelegt sind.

3. Bereitstellungskonfiguration prüfen

   Validieren Sie Ihre dropstone.config.js:

   module.exports = {
     build: {
       command: 'npm run build',
       output: 'dist'
     },
     deployment: {
       region: 'us-east-1',
       runtime: 'nodejs18.x'
     }
   }
   

4. Speicherkontingent

   Überprüfen Sie, ob Sie die Speicherlimits überschritten haben:

   Dashboard → Nutzung → Speicher

5. Build-Timeout

   Timeout in der Konfiguration erhöhen:

   deployment: {
     timeout: 900 // 15 Minuten in Sekunden
   }
   

Speicher- und Datenbankprobleme

Problem: Datensynchronisations- oder Speicherfehler

Symptome:

• "Speicherkontingent überschritten"
• Synchronisationskonflikte
• Daten werden nicht gespeichert

Lösungen:

1. Speichernutzung prüfen

   Dashboard → Speicher → Nutzungsstatistik

2. Synchronisationskonflikte beheben

   1. Navigieren Sie zur Konfliktdatei
   2. Dropstone zeigt Konfliktmarkierungen an
   3. Manuell auflösen oder Version zum Behalten auswählen
   

3. Datenbankverbindung

   Datenbankkonnektivität testen:

   // In der Dropstone-Konsole
   await dropstone.db.test()
   

4. Lokalen Cache leeren

   Einstellungen → Speicher → Lokalen Cache leeren
   

   Warnung: Dies entfernt lokal zwischengespeicherte Daten.

5. Sichern und Wiederherstellen

   Vor der Fehlerbehebung ein Backup erstellen:

   Dropstone → Tools → Backup → Backup erstellen
   

Erweiterte Fehlerbehebung

Abgesicherter Modus

Starten Sie Dropstone im abgesicherten Modus, um alle Erweiterungen zu deaktivieren:

Windows/Linux:

dropstone --disable-extensions

macOS:

/Applications/Dropstone.app/Contents/MacOS/Dropstone --disable-extensions

Auf Standardeinstellungen zurücksetzen

Um alle Einstellungen auf die Standardwerte zurückzusetzen:

1. Aktuelle Einstellungen sichern

   Einstellungen → Erweitert → Einstellungen exportieren
   

2. Zurücksetzen

   Einstellungen → Erweitert → Alle Einstellungen zurücksetzen
   

Ausführliche Protokollierung

Detaillierte Protokollierung für die Fehlersuche aktivieren:

1. Befehlspalette öffnen (Strg/Cmd + Umschalt + P)
2. Auswählen: Entwickler: Protokollebene festlegen
3. Wählen: Trace

Die Protokolle enthalten nun detaillierte Diagnoseinformationen.

Netzwerkdiagnose

Integrierte Netzwerkdiagnose ausführen:

Dropstone → Hilfe → Netzwerkdiagnose ausführen

Dies prüft:

• DNS-Auflösung
• Erreichbarkeit der API-Endpunkte
• WebSocket-Verbindungen
• CDN-Verfügbarkeit

Hilfe erhalten

Vor der Kontaktaufnahme mit dem Support

Stellen Sie sicher, dass Sie:

• Diesen Fehlerbehebungsleitfaden geprüft haben
• Die Statusseite überprüft haben
• Alle wesentlichen Fehlerbehebungsinformationen gesammelt haben

Support kontaktieren

E-Mail: support@blankline.org

Fügen Sie Ihrer Nachricht Folgendes hinzu:

1. Problemzusammenfassung
2. Schritte zur Reproduktion
3. Systeminformationen
4. Relevante Protokolle (letzte 100 Zeilen)
5. Screenshots
6. Was Sie bereits versucht haben

Weitere Ressourcen

• Dokumentation: docs.dropstone.io
• Statusseite: status.dropstone.io
• Vertrieb / Enterprise: dropstone.io/contact

Nützliche Befehle

Befehlspaletten-Schnellreferenz

CLI-Diagnose

# Dropstone CLI-Version prüfen
dropstone --version

# Installation überprüfen
dropstone doctor

# API-Konnektivität testen
dropstone ping

# Aktuelle Konfiguration anzeigen
dropstone config list

# Lokalen Cache leeren
dropstone cache clear

# Protokolle exportieren
dropstone logs export --output ./dropstone-logs.txt

Anhang

Speicherorte der Protokolldateien

Speicherorte der Konfigurationsdateien

Umgebungsvariablen

Zuletzt aktualisiert: 29. September 2025 Version: 1.0.0