Guia de Solução de Problemas do Dropstone - Diagnostique e Corrija Problemas

Este guia fornece abordagens sistemáticas para diagnosticar e resolver problemas comuns com o Dropstone.io. Siga estas etapas para reunir as informações necessárias antes de entrar em contato com o suporte.

Informações Essenciais para Solução de Problemas

As seguintes informações são críticas para a maioria dos cenários de solução de problemas no Dropstone:

1. Documentação Visual

Captura de Tela do Problema (oculte qualquer informação sensível)

• Capture a janela inteira do aplicativo mostrando o erro
• Inclua quaisquer mensagens de erro ou diálogos
• Garanta que os carimbos de data/hora estejam visíveis, se disponíveis

2. Etapas de Reprodução

Forneça etapas detalhadas para reproduzir o problema:

1. Ação realizada (ex.: "Cliquei no botão 'Deploy'")
2. Comportamento esperado
3. Comportamento real
4. Frequência (sempre, às vezes, uma vez)

3. Informações do Sistema

Recupere informações do sistema em:

Dropstone → Ajuda → Sobre

Isso inclui:

• Versão do Dropstone
• Sistema operacional
• Arquitetura (x64, arm64)
• Versão do Electron
• Versão do Node.js

4. Configuração de Rede

Você está usando algum dos seguintes?

• VPN (Rede Privada Virtual)
• Zscaler ou outros proxies de segurança
• Firewall corporativo
• Configurações personalizadas de DNS

5. Console de Ferramentas do Desenvolvedor

Acesse as ferramentas do desenvolvedor para verificar erros de JavaScript:

Dropstone → Ajuda → Alternar Ferramentas do Desenvolvedor

Navegue até a aba Console e verifique:

• Mensagens de erro em vermelho
• Mensagens de aviso relacionadas ao seu problema
• Falhas em solicitações de rede

Copie quaisquer rastreamentos de pilha de erros relevantes.

6. Logs do Aplicativo

Windows

Os logs estão localizados em:

C:\Users\<seu-nome-de-usuario>\AppData\Roaming\Dropstone\logs

Acesso via Paleta de Comandos:

1. Pressione Ctrl + Shift + P
2. Digite e selecione: Developer: Open Logs Folder

macOS

Os logs estão localizados em:

~/Library/Application Support/Dropstone/logs

Acesso via Paleta de Comandos:

1. Pressione Cmd + Shift + P
2. Digite e selecione: Developer: Open Logs Folder

Linux

Os logs estão localizados em:

~/.config/Dropstone/logs

Visualizando Logs no Aplicativo

Navegue até: Dropstone → Terminal → Saída

Selecione no menu suspenso:

• Window - Logs gerais do aplicativo
• Dropstone Core - Logs de funcionalidades principais
• Dropstone Deployment - Logs relacionados a implantações
• Dropstone Storage - Logs de armazenamento e banco de dados
• Dropstone API - Logs de solicitação/resposta da API

Problemas Comuns e Soluções

Problemas de Conexão

Problema: Incapacidade de Conectar aos Serviços do Dropstone

Sintomas:

• Erros de "tempo limite de conexão"
• Mensagens de "não foi possível alcançar o servidor"
• Estados de carregamento indefinidos

Soluções:

1. Verifique a Conexão com a Internet

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

2. Verifique as Configurações do Firewall

   • Garanta que o Dropstone esteja permitido através do seu firewall
   • Verifique as políticas de rede corporativas
   • Adicione o domínio *.dropstone.io à lista de permissões

3. Configuração de Proxy

   Configure as configurações de proxy:

   Dropstone → Configurações → Rede → Configurações de Proxy

   Ou defina variáveis de ambiente:

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

4. Resolução de DNS

   • Limpe o cache de DNS
   • Tente um DNS alternativo (8.8.8.8, 1.1.1.1)

Problemas de Autenticação

Problema: Falhas de Login ou Expiração de Token

Sintomas:

• Erros de "falha na autenticação"
• Solicitações repetidas de login
• Respostas 401 Não Autorizado

Soluções:

1. Limpe o Cache de Autenticação

   Dropstone → Paleta de Comandos → Clear Authentication Cache

2. Reautentique

   1. Saia do Dropstone
   2. Limpe os cookies do navegador para dropstone.io
   3. Entre novamente
   

3. Verifique a Validade do Token

   Navegue até: Configurações → Conta → Gerenciamento de Sessão

   Revise as sessões ativas e revogue as suspeitas.

4. Problemas com SSO

   Se estiver usando Single Sign-On:

   • Verifique se o provedor de SSO está acessível
   • Verifique se há asserções SAML expiradas
   • Entre em contato com o administrador do seu provedor de identidade

Problemas de Desempenho

Problema: Resposta Lenta do Aplicativo ou Alto Uso de CPU

Sintomas:

• Lag ao digitar ou clicar
• Alto uso de CPU/memória
• Interface congelada ou sem resposta

Soluções:

1. Verifique o Uso de Recursos

   Dropstone → Ajuda → Gerenciador de Processos

   Identifique processos que consomem recursos excessivos.

2. Desative Extensões

   Desative temporariamente as extensões para isolar o problema:

   Configurações → Extensões → Desative todas → Reinicie

3. Limpe o Cache

   Dropstone → Configurações → Avançado → Limpar Cache
   

4. Reduza o Tamanho do Projeto

   • Exclua arquivos grandes da indexação
   • Adicione ao arquivo .dpsignore:
   node_modules/
   dist/
   build/
   *.log
   .git/
   

5. Aceleração de Hardware

   Alterne a aceleração de GPU:

   Configurações → Sistema → Usar Aceleração de Hardware

Problemas de Implantação

Problema: Implantações com Falha

Sintomas:

• Falhas de build
• Tempos limite de implantação
• Erros de "não foi possível enviar para o remoto"

Soluções:

1. Verifique os Logs de Build

   Veja a saída detalhada do build:

   Implantação → Histórico → Selecione a implantação com falha → Ver Logs

2. Verifique as Variáveis de Ambiente

   Configurações → Implantação → Variáveis de Ambiente
   

   Garanta que todas as variáveis necessárias estejam definidas.

3. Verifique a Configuração de Implantação

   Valide seu dropstone.config.js:

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

4. Cota de Armazenamento

   Verifique se você não excedeu os limites de armazenamento:

   Painel → Uso → Armazenamento

5. Tempo Limite de Build

   Aumente o tempo limite na configuração:

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

Problemas de Armazenamento e Banco de Dados

Problema: Erros de Sincronização ou Armazenamento de Dados

Sintomas:

• "Cota de armazenamento excedida"
• Conflitos de sincronização
• Dados não persistindo

Soluções:

1. Verifique o Uso de Armazenamento

   Painel → Armazenamento → Estatísticas de Uso

2. Resolva Conflitos de Sincronização

   1. Navegue até o arquivo com conflito
   2. O Dropstone mostrará marcadores de conflito
   3. Resolva manualmente ou selecione a versão a manter
   

3. Conexão com o Banco de Dados

   Teste a conectividade do banco de dados:

   // No console do Dropstone
   await dropstone.db.test()
   

4. Limpe o Cache Local

   Configurações → Armazenamento → Limpar Cache Local
   

   Aviso: Isso removerá os dados armazenados em cache localmente.

5. Backup e Restauração

   Crie um backup antes de solucionar problemas:

   Dropstone → Ferramentas → Backup → Criar Backup
   

Solução de Problemas Avançada

Modo de Segurança

Inicie o Dropstone em modo de segurança para desativar todas as extensões:

Windows/Linux:

dropstone --disable-extensions

macOS:

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

Redefinir para as Configurações Padrão

Para redefinir todas as configurações para os padrões:

1. Faça Backup das Configurações Atuais

   Configurações → Avançado → Exportar Configurações
   

2. Redefina

   Configurações → Avançado → Redefinir Todas as Configurações
   

Registro Detalhado (Verbose Logging)

Ative o registro detalhado para depuração:

1. Abra a Paleta de Comandos (Ctrl/Cmd + Shift + P)
2. Selecione: Developer: Set Log Level
3. Escolha: Trace

Os logs agora incluirão informações detalhadas de diagnóstico.

Diagnóstico de Rede

Execute o diagnóstico de rede integrado:

Dropstone → Ajuda → Executar Diagnóstico de Rede

Isso verifica:

• Resolução de DNS
• Acessibilidade do endpoint da API
• Conexões WebSocket
• Disponibilidade do CDN

Obtendo Ajuda

Antes de Entrar em Contato com o Suporte

Garanta que você tenha:

• Verificado este guia de solução de problemas
• Revisado a Página de Status
• Reunido todas as informações essenciais de solução de problemas

Entre em Contato com o Suporte

E-mail: support@blankline.org

Inclua em sua mensagem:

1. Resumo do problema
2. Etapas para reproduzir
3. Informações do sistema
4. Logs relevantes (últimas 100 linhas)
5. Capturas de tela
6. O que você já tentou

Outros Recursos

• Documentação: docs.dropstone.io
• Página de Status: status.dropstone.io
• Vendas / Empresarial: dropstone.io/contact

Comandos Úteis

Referência Rápida da Paleta de Comandos

Diagnóstico da CLI

# Verificar a versão da CLI do Dropstone
dropstone --version

# Verificar a instalação
dropstone doctor

# Testar a conectividade da API
dropstone ping

# Visualizar a configuração atual
dropstone config list

# Limpar o cache local
dropstone cache clear

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

Apêndice

Locais dos Arquivos de Log

Locais dos Arquivos de Configuração

Variáveis de Ambiente

Última atualização: 29 de setembro de 2025 Versão: 1.0.0