Guide de dépannage Dropstone - Diagnostiquer et résoudre les problèmes

Ce guide propose des approches systématiques pour diagnostiquer et résoudre les problèmes courants avec Dropstone.io. Suivez ces étapes pour rassembler les informations nécessaires avant de contacter le support.

Informations essentielles pour le dépannage

Les informations suivantes sont essentielles pour la plupart des scénarios de dépannage dans Dropstone :

1. Documentation visuelle

Capture d'écran du problème (masquez toute information sensible)

• Capturez la fenêtre entière de l'application montrant l'erreur
• Incluez tous les messages d'erreur ou boîtes de dialogue
• Assurez-vous que les horodatages sont visibles si disponibles

2. Étapes de reproduction

Fournissez des étapes détaillées pour reproduire le problème :

1. Action effectuée (par exemple, « Cliqué sur le bouton 'Déployer' »)
2. Comportement attendu
3. Comportement réel
4. Fréquence (toujours, parfois, une fois)

3. Informations système

Récupérez les informations système à partir de :

Dropstone → Aide → À propos

Cela inclut :

• Version de Dropstone
• Système d'exploitation
• Architecture (x64, arm64)
• Version d'Electron
• Version de Node.js

4. Configuration réseau

Utilisez-vous l'un des éléments suivants ?

• VPN (réseau privé virtuel)
• Zscaler ou d'autres proxys de sécurité
• Pare-feu d'entreprise
• Paramètres DNS personnalisés

5. Console des outils de développement

Accédez aux outils de développement pour vérifier les erreurs JavaScript :

Dropstone → Aide → Basculer les outils de développement

Accédez à l'onglet Console et vérifiez :

• Les messages d'erreur en rouge
• Les messages d'avertissement liés à votre problème
• Les échecs de requêtes réseau

Copiez toutes les traces de pile d'erreurs pertinentes.

6. Journaux d'application

Windows

Les journaux se trouvent à l'adresse :

C:\Users\<votre-nom-d'utilisateur>\AppData\Roaming\Dropstone\logs

Accès via la palette de commandes :

1. Appuyez sur Ctrl + Maj + P
2. Tapez et sélectionnez : Développeur : Ouvrir le dossier des journaux

macOS

Les journaux se trouvent à l'adresse :

~/Library/Application Support/Dropstone/logs

Accès via la palette de commandes :

1. Appuyez sur Cmd + Maj + P
2. Tapez et sélectionnez : Développeur : Ouvrir le dossier des journaux

Linux

Les journaux se trouvent à l'adresse :

~/.config/Dropstone/logs

Affichage des journaux dans l'application

Accédez à : Dropstone → Terminal → Sortie

Sélectionnez dans le menu déroulant :

• Fenêtre - Journaux généraux de l'application
• Noyau Dropstone - Journaux des fonctionnalités principales
• Déploiement Dropstone - Journaux liés au déploiement
• Stockage Dropstone - Journaux de stockage et de base de données
• API Dropstone - Journaux des requêtes/réponses API

Problèmes courants et solutions

Problèmes de connexion

Problème : Impossible de se connecter aux services Dropstone

Symptômes :

• Erreurs « Délai de connexion dépassé »
• Messages « Impossible d'atteindre le serveur »
• États de chargement indéfinis

Solutions :

1. Vérifiez la connexion Internet

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

2. Vérifiez les paramètres du pare-feu

   • Assurez-vous que Dropstone est autorisé à traverser votre pare-feu
   • Vérifiez les politiques réseau de l'entreprise
   • Ajoutez le domaine *.dropstone.io à la liste blanche

3. Configuration du proxy

   Configurez les paramètres du proxy :

   Dropstone → Paramètres → Réseau → Paramètres du proxy

   Ou définissez des variables d'environnement :

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

4. Résolution DNS

   • Videz le cache DNS
   • Essayez un DNS alternatif (8.8.8.8, 1.1.1.1)

Problèmes d'authentification

Problème : Échecs de connexion ou expiration du jeton

Symptômes :

• Erreurs « Échec de l'authentification »
• Invites de connexion répétées
• Réponses 401 Non autorisé

Solutions :

1. Effacez le cache d'authentification

   Dropstone → Palette de commandes → Effacer le cache d'authentification

2. Réauthentifiez-vous

   1. Déconnectez-vous de Dropstone
   2. Effacez les cookies du navigateur pour dropstone.io
   3. Connectez-vous à nouveau
   

3. Vérifiez la validité du jeton

   Accédez à : Paramètres → Compte → Gestion des sessions

   Examinez les sessions actives et révoquez celles qui semblent suspectes.

4. Problèmes SSO

   Si vous utilisez l'authentification unique (SSO) :

   • Vérifiez que le fournisseur SSO est accessible
   • Vérifiez les assertions SAML expirées
   • Contactez l'administrateur de votre fournisseur d'identité

Problèmes de performance

Problème : Réponse lente de l'application ou utilisation élevée du processeur

Symptômes :

• Décalage lors de la saisie ou des clics
• Utilisation élevée du processeur/mémoire
• Interface gelée ou qui ne répond pas

Solutions :

1. Vérifiez l'utilisation des ressources

   Dropstone → Aide → Gestionnaire de processus

   Identifiez les processus qui consomment des ressources excessives.

2. Désactivez les extensions

   Désactivez temporairement les extensions pour isoler le problème :

   Paramètres → Extensions → Désactiver tout → Redémarrer

3. Effacez le cache

   Dropstone → Paramètres → Avancé → Effacer le cache
   

4. Réduisez la taille du projet

   • Excluez les fichiers volumineux de l'indexation
   • Ajoutez au fichier .dpsignore :
   node_modules/
   dist/
   build/
   *.log
   .git/
   

5. Accélération matérielle

   Activez/désactivez l'accélération GPU :

   Paramètres → Système → Utiliser l'accélération matérielle

Problèmes de déploiement

Problème : Échecs de déploiement

Symptômes :

• Échecs de construction
• Délais de déploiement dépassés
• Erreurs « Impossible d'envoyer vers le dépôt distant »

Solutions :

1. Vérifiez les journaux de construction

   Affichez la sortie détaillée de la construction :

   Déploiement → Historique → Sélectionnez le déploiement échoué → Afficher les journaux

2. Vérifiez les variables d'environnement

   Paramètres → Déploiement → Variables d'environnement
   

   Assurez-vous que toutes les variables requises sont définies.

3. Vérifiez la configuration du déploiement

   Validez votre dropstone.config.js :

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

4. Quota de stockage

   Vérifiez que vous n'avez pas dépassé les limites de stockage :

   Tableau de bord → Utilisation → Stockage

5. Délai de construction dépassé

   Augmentez le délai dans la configuration :

   deployment: {
     timeout: 900 // 15 minutes en secondes
   }
   

Problèmes de stockage et de base de données

Problème : Erreurs de synchronisation des données ou de stockage

Symptômes :

• « Quota de stockage dépassé »
• Conflits de synchronisation
• Données non persistantes

Solutions :

1. Vérifiez l'utilisation du stockage

   Tableau de bord → Stockage → Statistiques d'utilisation

2. Résolvez les conflits de synchronisation

   1. Accédez au fichier en conflit
   2. Dropstone affichera les marqueurs de conflit
   3. Résolvez manuellement ou sélectionnez la version à conserver
   

3. Connexion à la base de données

   Testez la connectivité de la base de données :

   // Dans la console Dropstone
   await dropstone.db.test()
   

4. Effacez le cache local

   Paramètres → Stockage → Effacer le cache local
   

   Avertissement : Cela supprimera les données mises en cache localement.

5. Sauvegarde et restauration

   Créez une sauvegarde avant de dépanner :

   Dropstone → Outils → Sauvegarde → Créer une sauvegarde
   

Dépannage avancé

Mode sans échec

Démarrez Dropstone en mode sans échec pour désactiver toutes les extensions :

Windows/Linux :

dropstone --disable-extensions

macOS :

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

Réinitialisation aux paramètres par défaut

Pour réinitialiser tous les paramètres aux valeurs par défaut :

1. Sauvegardez les paramètres actuels

   Paramètres → Avancé → Exporter les paramètres
   

2. Réinitialisation

   Paramètres → Avancé → Réinitialiser tous les paramètres
   

Journalisation détaillée

Activez la journalisation détaillée pour le débogage :

1. Ouvrez la palette de commandes (Ctrl/Cmd + Maj + P)
2. Sélectionnez : Développeur : Définir le niveau de journalisation
3. Choisissez : Trace

Les journaux incluront désormais des informations de diagnostic détaillées.

Diagnostics réseau

Exécutez les diagnostics réseau intégrés :

Dropstone → Aide → Exécuter les diagnostics réseau

Cela vérifie :

• La résolution DNS
• L'accessibilité des points de terminaison API
• Les connexions WebSocket
• La disponibilité du CDN

Obtenir de l'aide

Avant de contacter le support

Assurez-vous d'avoir :

• Consulté ce guide de dépannage
• Consulté la page de statut
• Rassemblé toutes les informations de dépannage essentielles

Contacter le support

E-mail : support@blankline.org

Incluez dans votre message :

1. Résumé du problème
2. Étapes pour reproduire
3. Informations système
4. Journaux pertinents (100 dernières lignes)
5. Captures d'écran
6. Ce que vous avez déjà essayé

Autres ressources

• Documentation : docs.dropstone.io
• Page de statut : status.dropstone.io
• Ventes / Entreprise : dropstone.io/contact

Commandes utiles

Référence rapide de la palette de commandes

Diagnostics CLI

# Vérifier la version de Dropstone CLI
dropstone --version

# Vérifier l'installation
dropstone doctor

# Tester la connectivité API
dropstone ping

# Afficher la configuration actuelle
dropstone config list

# Effacer le cache local
dropstone cache clear

# Exporter les journaux
dropstone logs export --output ./dropstone-logs.txt

Annexe

Emplacements des fichiers journaux

Emplacements des fichiers de configuration

Variables d'environnement

Dernière mise à jour : 29 septembre 2025 Version : 1.0.0