Guida alla Risoluzione dei Problemi di Dropstone - Diagnosi e Correzione

Questa guida fornisce approcci sistematici per diagnosticare e risolvere problemi comuni con Dropstone.io. Segui questi passaggi per raccogliere le informazioni necessarie prima di contattare il supporto.

Informazioni Essenziali per la Risoluzione dei Problemi

Le seguenti informazioni sono fondamentali per la maggior parte degli scenari di risoluzione dei problemi in Dropstone:

1. Documentazione Visiva

Screenshot del Problema (oscura qualsiasi informazione sensibile)

• Cattura l'intera finestra dell'applicazione che mostra l'errore
• Includi eventuali messaggi di errore o finestre di dialogo
• Assicurati che i timestamp siano visibili se disponibili

2. Passaggi per la Riproduzione

Fornisci passaggi dettagliati per riprodurre il problema:

1. Azione eseguita (es., "Cliccato sul pulsante 'Deploy'")
2. Comportamento previsto
3. Comportamento effettivo
4. Frequenza (sempre, a volte, una volta)

3. Informazioni di Sistema

Recupera le informazioni di sistema da:

Dropstone → Aiuto → Informazioni su

Questo include:

• Versione di Dropstone
• Sistema operativo
• Architettura (x64, arm64)
• Versione di Electron
• Versione di Node.js

4. Configurazione di Rete

Stai utilizzando uno dei seguenti?

• VPN (Virtual Private Network)
• Zscaler o altri proxy di sicurezza
• Firewall aziendale
• Impostazioni DNS personalizzate

5. Console degli Strumenti di Sviluppo

Accedi agli strumenti di sviluppo per verificare la presenza di errori JavaScript:

Dropstone → Aiuto → Attiva/Disattiva Strumenti di Sviluppo

Vai alla scheda Console e controlla:

• Messaggi di errore rossi
• Messaggi di avviso relativi al tuo problema
• Errori di richieste di rete

Copia eventuali stack trace di errori pertinenti.

6. Log dell'Applicazione

Windows

I log si trovano in:

C:\Users\<nome-utente>\AppData\Roaming\Dropstone\logs

Accesso tramite la Palette dei Comandi:

1. Premi Ctrl + Shift + P
2. Digita e seleziona: Sviluppatore: Apri Cartella Log

macOS

I log si trovano in:

~/Library/Application Support/Dropstone/logs

Accesso tramite la Palette dei Comandi:

1. Premi Cmd + Shift + P
2. Digita e seleziona: Sviluppatore: Apri Cartella Log

Linux

I log si trovano in:

~/.config/Dropstone/logs

Visualizzazione dei Log nell'Applicazione

Vai a: Dropstone → Terminale → Output

Seleziona dal menu a tendina:

• Finestra - Log generali dell'applicazione
• Dropstone Core - Log delle funzionalità principali
• Dropstone Deployment - Log relativi al deployment
• Dropstone Storage - Log di archiviazione e database
• Dropstone API - Log delle richieste/risposte API

Problemi Comuni e Soluzioni

Problemi di Connessione

Problema: Impossibile Connettersi ai Servizi Dropstone

Sintomi:

• Errori di "Timeout di connessione"
• Messaggi di "Impossibile raggiungere il server"
• Stati di caricamento indefiniti

Soluzioni:

1. Controlla la Connessione Internet

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

2. Verifica le Impostazioni del Firewall

   • Assicurati che Dropstone sia consentito attraverso il firewall
   • Controlla le policy di rete aziendali
   • Aggiungi il dominio *.dropstone.io alla whitelist

3. Configurazione del Proxy

   Configura le impostazioni del proxy:

   Dropstone → Impostazioni → Rete → Impostazioni Proxy

   Oppure imposta le variabili d'ambiente:

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

4. Risoluzione DNS

   • Svuota la cache DNS
   • Prova un DNS alternativo (8.8.8.8, 1.1.1.1)

Problemi di Autenticazione

Problema: Errori di Accesso o Scadenza del Token

Sintomi:

• Errori di "Autenticazione fallita"
• Richieste di accesso ripetute
• Risposte 401 Non Autorizzato

Soluzioni:

1. Cancella la Cache di Autenticazione

   Dropstone → Palette dei Comandi → Cancella Cache di Autenticazione

2. Ri-autenticati

   1. Esci da Dropstone
   2. Cancella i cookie del browser per dropstone.io
   3. Accedi di nuovo
   

3. Controlla la Validità del Token

   Vai a: Impostazioni → Account → Gestione Sessioni

   Rivedi le sessioni attive e revoca quelle sospette.

4. Problemi SSO

   Se utilizzi Single Sign-On:

   • Verifica che il provider SSO sia accessibile
   • Controlla la scadenza delle asserzioni SAML
   • Contatta l'amministratore del tuo identity provider

Problemi di Prestazioni

Problema: Risposta Lenta dell'Applicazione o Utilizzo Elevato della CPU

Sintomi:

• Ritardo durante la digitazione o il clic
• Utilizzo elevato di CPU/memoria
• Interfaccia utente bloccata o non reattiva

Soluzioni:

1. Controlla l'Utilizzo delle Risorse

   Dropstone → Aiuto → Gestione Processi

   Identifica i processi che consumano risorse eccessive.

2. Disattiva le Estensioni

   Disattiva temporaneamente le estensioni per isolare il problema:

   Impostazioni → Estensioni → Disattiva tutte → Riavvia

3. Cancella la Cache

   Dropstone → Impostazioni → Avanzate → Cancella Cache
   

4. Riduci la Dimensione del Progetto

   • Escludi file di grandi dimensioni dall'indicizzazione
   • Aggiungi al file .dpsignore:
   node_modules/
   dist/
   build/
   *.log
   .git/
   

5. Accelerazione Hardware

   Attiva/disattiva l'accelerazione GPU:

   Impostazioni → Sistema → Usa Accelerazione Hardware

Problemi di Deployment

Problema: Deployment Falliti

Sintomi:

• Errori di build
• Timeout di deployment
• Errori di "Impossibile inviare al remoto"

Soluzioni:

1. Controlla i Log di Build

   Visualizza l'output dettagliato della build:

   Deployment → Cronologia → Seleziona il deployment fallito → Visualizza Log

2. Verifica le Variabili d'Ambiente

   Impostazioni → Deployment → Variabili d'Ambiente
   

   Assicurati che tutte le variabili richieste siano impostate.

3. Controlla la Configurazione del Deployment

   Valida il tuo dropstone.config.js:

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

4. Quota di Archiviazione

   Verifica di non aver superato i limiti di archiviazione:

   Dashboard → Utilizzo → Archiviazione

5. Timeout di Build

   Aumenta il timeout nella configurazione:

   deployment: {
     timeout: 900 // 15 minuti in secondi
   }
   

Problemi di Archiviazione e Database

Problema: Errori di Sincronizzazione o Archiviazione dei Dati

Sintomi:

• "Quota di archiviazione superata"
• Conflitti di sincronizzazione
• Dati non persistenti

Soluzioni:

1. Controlla l'Utilizzo dell'Archiviazione

   Dashboard → Archiviazione → Statistiche di Utilizzo

2. Risolvi i Conflitti di Sincronizzazione

   1. Vai al file in conflitto
   2. Dropstone mostrerà i marcatori di conflitto
   3. Risolvi manualmente o seleziona la versione da mantenere
   

3. Connessione al Database

   Testa la connettività del database:

   // Nella console di Dropstone
   await dropstone.db.test()
   

4. Cancella la Cache Locale

   Impostazioni → Archiviazione → Cancella Cache Locale
   

   Avviso: Questo rimuoverà i dati memorizzati localmente nella cache.

5. Backup e Ripristino

   Crea un backup prima di risolvere i problemi:

   Dropstone → Strumenti → Backup → Crea Backup
   

Risoluzione Avanzata dei Problemi

Modalità Provvisoria

Avvia Dropstone in modalità provvisoria per disattivare tutte le estensioni:

Windows/Linux:

dropstone --disable-extensions

macOS:

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

Ripristino delle Impostazioni Predefinite

Per ripristinare tutte le impostazioni ai valori predefiniti:

1. Backup delle Impostazioni Correnti

   Impostazioni → Avanzate → Esporta Impostazioni
   

2. Ripristino

   Impostazioni → Avanzate → Ripristina Tutte le Impostazioni
   

Registrazione Dettagliata (Verbose Logging)

Abilita la registrazione dettagliata per il debug:

1. Apri la Palette dei Comandi (Ctrl/Cmd + Shift + P)
2. Seleziona: Sviluppatore: Imposta Livello di Log
3. Scegli: Trace

I log ora includeranno informazioni diagnostiche dettagliate.

Diagnostica di Rete

Esegui la diagnostica di rete integrata:

Dropstone → Aiuto → Esegui Diagnostica di Rete

Questo controlla:

• Risoluzione DNS
• Accessibilità degli endpoint API
• Connessioni WebSocket
• Disponibilità della CDN

Ottenere Aiuto

Prima di Contattare il Supporto

Assicurati di avere:

• Consultato questa guida alla risoluzione dei problemi
• Controllato la Pagina di Stato
• Raccoglito tutte le informazioni essenziali per la risoluzione dei problemi

Contatta il Supporto

Email: support@blankline.org

Includi nel tuo messaggio:

1. Riepilogo del problema
2. Passaggi per riprodurre il problema
3. Informazioni di sistema
4. Log pertinenti (ultime 100 righe)
5. Screenshot
6. Cosa hai già provato

Altre Risorse

• Documentazione: docs.dropstone.io
• Pagina di Stato: status.dropstone.io
• Vendite / Enterprise: dropstone.io/contact

Comandi Utili

Riferimento Rapido della Palette dei Comandi

Diagnostica CLI

# Controlla la versione di Dropstone CLI
dropstone --version

# Verifica l'installazione
dropstone doctor

# Testa la connettività API
dropstone ping

# Visualizza la configurazione corrente
dropstone config list

# Cancella la cache locale
dropstone cache clear

# Esporta i log
dropstone logs export --output ./dropstone-logs.txt

Appendice

Posizioni dei File di Log

Posizioni dei File di Configurazione

Variabili d'Ambiente

Ultimo aggiornamento: 29 settembre 2025 Versione: 1.0.0