Guía de Solución de Problemas de Dropstone - Diagnostica y Corrige Problemas

Esta guía proporciona enfoques sistemáticos para diagnosticar y resolver problemas comunes con Dropstone.io. Sigue estos pasos para recopilar la información necesaria antes de contactar al soporte.

Información Esencial para la Solución de Problemas

La siguiente información es crítica para la mayoría de los escenarios de solución de problemas dentro de Dropstone:

1. Documentación Visual

Captura de Pantalla del Problema (redacta cualquier información sensible)

• Captura la ventana completa de la aplicación mostrando el error
• Incluye cualquier mensaje de error o diálogo
• Asegúrate de que las marcas de tiempo sean visibles si están disponibles

2. Pasos de Reproducción

Proporciona pasos detallados para reproducir el problema:

1. Acción realizada (ej., "Hice clic en el botón 'Desplegar'")
2. Comportamiento esperado
3. Comportamiento real
4. Frecuencia (siempre, a veces, una vez)

3. Información del Sistema

Recupera la información del sistema desde:

Dropstone → Ayuda → Acerca de

Esto incluye:

• Versión de Dropstone
• Sistema operativo
• Arquitectura (x64, arm64)
• Versión de Electron
• Versión de Node.js

4. Configuración de Red

¿Estás utilizando alguno de los siguientes?

• VPN (Red Privada Virtual)
• Zscaler u otros proxies de seguridad
• Cortafuegos corporativo
• Configuración de DNS personalizada

5. Consola de Herramientas de Desarrollo

Accede a las herramientas de desarrollo para verificar errores de JavaScript:

Dropstone → Ayuda → Alternar Herramientas de Desarrollo

Navega a la pestaña Consola y verifica:

• Mensajes de error en rojo
• Mensajes de advertencia relacionados con tu problema
• Fallos en solicitudes de red

Copia cualquier seguimiento de pila de errores relevante.

6. Registros de la Aplicación

Windows

Los registros se encuentran en:

C:\Users\<tu-nombre-de-usuario>\AppData\Roaming\Dropstone\logs

Accede a través de la Paleta de Comandos:

1. Presiona Ctrl + Shift + P
2. Escribe y selecciona: Developer: Open Logs Folder

macOS

Los registros se encuentran en:

~/Library/Application Support/Dropstone/logs

Accede a través de la Paleta de Comandos:

1. Presiona Cmd + Shift + P
2. Escribe y selecciona: Developer: Open Logs Folder

Linux

Los registros se encuentran en:

~/.config/Dropstone/logs

Visualización de Registros en la Aplicación

Navega a: Dropstone → Terminal → Salida

Selecciona del menú desplegable:

• Window - Registros generales de la aplicación
• Dropstone Core - Registros de funcionalidad principal
• Dropstone Deployment - Registros relacionados con despliegues
• Dropstone Storage - Registros de almacenamiento y base de datos
• Dropstone API - Registros de solicitudes/respuestas de API

Problemas Comunes y Soluciones

Problemas de Conexión

Problema: No se Puede Conectar a los Servicios de Dropstone

Síntomas:

• Errores de "Tiempo de espera de conexión agotado"
• Mensajes de "No se puede alcanzar el servidor"
• Estados de carga indefinidos

Soluciones:

1. Verifica la Conexión a Internet

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

2. Verifica la Configuración del Cortafuegos

   • Asegúrate de que Dropstone esté permitido a través de tu cortafuegos
   • Verifica las políticas de red corporativas
   • Agrega el dominio *.dropstone.io a la lista blanca

3. Configuración de Proxy

   Configura los ajustes de proxy:

   Dropstone → Configuración → Red → Configuración de Proxy

   O establece variables de entorno:

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

4. Resolución de DNS

   • Vacía la caché de DNS
   • Prueba con DNS alternativos (8.8.8.8, 1.1.1.1)

Problemas de Autenticación

Problema: Fallos de Inicio de Sesión o Expiración de Tokens

Síntomas:

• Errores de "Autenticación fallida"
• Solicitudes de inicio de sesión repetidas
• Respuestas 401 No Autorizado

Soluciones:

1. Limpiar la Caché de Autenticación

   Dropstone → Paleta de Comandos → Clear Authentication Cache

2. Re-autenticarse

   1. Cierra sesión en Dropstone
   2. Limpia las cookies del navegador para dropstone.io
   3. Inicia sesión nuevamente
   

3. Verificar la Validez del Token

   Navega a: Configuración → Cuenta → Gestión de Sesiones

   Revisa las sesiones activas y revoca las sospechosas.

4. Problemas de SSO

   Si usas Inicio de Sesión Único:

   • Verifica que el proveedor de SSO sea accesible
   • Comprueba si hay aserciones SAML expiradas
   • Contacta al administrador de tu proveedor de identidad

Problemas de Rendimiento

Problema: Respuesta Lenta de la Aplicación o Alto Uso de CPU

Síntomas:

• Retraso al escribir o hacer clic
• Alto uso de CPU/memoria
• Interfaz congelada o que no responde

Soluciones:

1. Verifica el Uso de Recursos

   Dropstone → Ayuda → Administrador de Procesos

   Identifica los procesos que consumen recursos excesivos.

2. Desactiva Extensiones

   Desactiva temporalmente las extensiones para aislar el problema:

   Configuración → Extensiones → Desactivar todas → Reiniciar

3. Limpiar Caché

   Dropstone → Configuración → Avanzado → Limpiar Caché
   

4. Reducir el Tamaño del Proyecto

   • Excluye archivos grandes de la indexación
   • Agrega al archivo .dpsignore:
   node_modules/
   dist/
   build/
   *.log
   .git/
   

5. Aceleración por Hardware

   Alterna la aceleración por GPU:

   Configuración → Sistema → Usar Aceleración por Hardware

Problemas de Despliegue

Problema: Despliegues Fallidos

Síntomas:

• Fallos de compilación
• Tiempos de espera de despliegue agotados
• Errores de "No se puede enviar al remoto"

Soluciones:

1. Verifica los Registros de Compilación

   Visualiza la salida detallada de compilación:

   Despliegue → Historial → Selecciona el despliegue fallido → Ver Registros

2. Verifica las Variables de Entorno

   Configuración → Despliegue → Variables de Entorno
   

   Asegúrate de que todas las variables requeridas estén configuradas.

3. Verifica la Configuración de Despliegue

   Valida tu dropstone.config.js:

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

4. Cuota de Almacenamiento

   Verifica que no hayas excedido los límites de almacenamiento:

   Panel de Control → Uso → Almacenamiento

5. Tiempo de Espera de Compilación

   Aumenta el tiempo de espera en la configuración:

   deployment: {
     timeout: 900 // 15 minutos en segundos
   }
   

Problemas de Almacenamiento y Base de Datos

Problema: Errores de Sincronización de Datos o Almacenamiento

Síntomas:

• "Cuota de almacenamiento excedida"
• Conflictos de sincronización
• Datos que no persisten

Soluciones:

1. Verifica el Uso de Almacenamiento

   Panel de Control → Almacenamiento → Estadísticas de Uso

2. Resolver Conflictos de Sincronización

   1. Navega al archivo en conflicto
   2. Dropstone mostrará marcadores de conflicto
   3. Resuelve manualmente o selecciona la versión a conservar
   

3. Conexión a la Base de Datos

   Prueba la conectividad de la base de datos:

   // En la consola de Dropstone
   await dropstone.db.test()
   

4. Limpiar Caché Local

   Configuración → Almacenamiento → Limpiar Caché Local
   

   Advertencia: Esto eliminará los datos almacenados en caché localmente.

5. Copia de Seguridad y Restauración

   Crea una copia de seguridad antes de solucionar problemas:

   Dropstone → Herramientas → Copia de Seguridad → Crear Copia de Seguridad
   

Solución de Problemas Avanzada

Modo Seguro

Inicia Dropstone en modo seguro para desactivar todas las extensiones:

Windows/Linux:

dropstone --disable-extensions

macOS:

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

Restablecer a la Configuración Predeterminada

Para restablecer todas las configuraciones a los valores predeterminados:

1. Copia de Seguridad de la Configuración Actual

   Configuración → Avanzado → Exportar Configuración
   

2. Restablecer

   Configuración → Avanzado → Restablecer Todas las Configuraciones
   

Registro Detallado

Habilita el registro detallado para depuración:

1. Abre la Paleta de Comandos (Ctrl/Cmd + Shift + P)
2. Selecciona: Developer: Set Log Level
3. Elige: Trace

Los registros ahora incluirán información de diagnóstico detallada.

Diagnósticos de Red

Ejecuta los diagnósticos de red integrados:

Dropstone → Ayuda → Ejecutar Diagnósticos de Red

Esto verifica:

• Resolución de DNS
• Accesibilidad de los endpoints de API
• Conexiones WebSocket
• Disponibilidad de CDN

Obtener Ayuda

Antes de Contactar al Soporte

Asegúrate de tener:

• Revisado esta guía de solución de problemas
• Consultada la Página de Estado
• Recopilada toda la información esencial de solución de problemas

Contactar al Soporte

Correo Electrónico: support@blankline.org

Incluye en tu mensaje:

1. Resumen del problema
2. Pasos para reproducir
3. Información del sistema
4. Registros relevantes (últimas 100 líneas)
5. Capturas de pantalla
6. Lo que ya has intentado

Otros Recursos

• Documentación: docs.dropstone.io
• Página de Estado: status.dropstone.io
• Ventas / Empresas: dropstone.io/contact

Comandos Útiles

Referencia Rápida de la Paleta de Comandos

Diagnósticos CLI

# Verificar la versión de Dropstone CLI
dropstone --version

# Verificar la instalación
dropstone doctor

# Probar la conectividad de API
dropstone ping

# Ver la configuración actual
dropstone config list

# Limpiar la caché local
dropstone cache clear

# Exportar registros
dropstone logs export --output ./dropstone-logs.txt

Apéndice

Ubicaciones de Archivos de Registro

Ubicaciones de Archivos de Configuración

Variables de Entorno

Última Actualización: 29 de septiembre de 2025 Versión: 1.0.0