Panduan Pemecahan Masalah Dropstone - Diagnosa & Perbaiki Masalah

Panduan ini menyediakan pendekatan sistematis untuk mendiagnosa dan menyelesaikan masalah umum dengan Dropstone.io. Ikuti langkah-langkah ini untuk mengumpulkan informasi yang diperlukan sebelum menghubungi dukungan.

Informasi Penting untuk Pemecahan Masalah

Informasi berikut sangat penting untuk sebagian besar skenario pemecahan masalah di dalam Dropstone:

1. Dokumentasi Visual

Tangkapan Layar Masalah (sensor informasi sensitif)

• Tangkap seluruh jendela aplikasi yang menampilkan kesalahan
• Sertakan pesan kesalahan atau dialog apa pun
• Pastikan stempel waktu terlihat jika tersedia

2. Langkah Reproduksi

Berikan langkah-langkah terperinci untuk mereproduksi masalah:

1. Tindakan yang dilakukan (misalnya, "Mengklik tombol 'Deploy'")
2. Perilaku yang diharapkan
3. Perilaku aktual
4. Frekuensi (selalu, kadang-kadang, sekali)

3. Informasi Sistem

Ambil informasi sistem dari:

Dropstone → Bantuan → Tentang

Ini mencakup:

• Versi Dropstone
• Sistem operasi
• Arsitektur (x64, arm64)
• Versi Electron
• Versi Node.js

4. Konfigurasi Jaringan

Apakah Anda menggunakan salah satu dari berikut ini?

• VPN (Virtual Private Network)
• Zscaler atau proxy keamanan lainnya
• Firewall perusahaan
• Pengaturan DNS kustom

5. Konsol Alat Pengembang

Akses alat pengembang untuk memeriksa kesalahan JavaScript:

Dropstone → Bantuan → Alihkan Alat Pengembang

Navigasikan ke tab Konsol dan periksa:

• Pesan kesalahan merah
• Pesan peringatan yang terkait dengan masalah Anda
• Kegagalan permintaan jaringan

Salin jejak tumpukan kesalahan yang relevan.

6. Log Aplikasi

Windows

Log terletak di:

C:\Users\<nama-pengguna-anda>\AppData\Roaming\Dropstone\logs

Akses melalui Palet Perintah:

1. Tekan Ctrl + Shift + P
2. Ketik dan pilih: Developer: Buka Folder Log

macOS

Log terletak di:

~/Library/Application Support/Dropstone/logs

Akses melalui Palet Perintah:

1. Tekan Cmd + Shift + P
2. Ketik dan pilih: Developer: Buka Folder Log

Linux

Log terletak di:

~/.config/Dropstone/logs

Melihat Log di Aplikasi

Navigasikan ke: Dropstone → Terminal → Output

Pilih dari dropdown:

• Window - Log aplikasi umum
• Dropstone Core - Log fungsionalitas inti
• Dropstone Deployment - Log terkait deployment
• Dropstone Storage - Log penyimpanan dan database
• Dropstone API - Log permintaan/respons API

Masalah Umum dan Solusinya

Masalah Koneksi

Masalah: Tidak Dapat Terhubung ke Layanan Dropstone

Gejala:

• Kesalahan "Koneksi timeout"
• Pesan "Tidak dapat menjangkau server"
• Status pemuatan tanpa batas

Solusi:

1. Periksa Koneksi Internet

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

2. Verifikasi Pengaturan Firewall

   • Pastikan Dropstone diizinkan melalui firewall Anda
   • Periksa kebijakan jaringan perusahaan
   • Masukkan domain *.dropstone.io ke daftar putih

3. Konfigurasi Proxy

   Konfigurasikan pengaturan proxy:

   Dropstone → Pengaturan → Jaringan → Pengaturan Proxy

   Atau atur variabel lingkungan:

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

4. Resolusi DNS

   • Bersihkan cache DNS
   • Coba DNS alternatif (8.8.8.8, 1.1.1.1)

Masalah Autentikasi

Masalah: Kegagalan Masuk atau Kedaluwarsa Token

Gejala:

• Kesalahan "Autentikasi gagal"
• Permintaan masuk berulang
• Respons 401 Tidak Diizinkan

Solusi:

1. Bersihkan Cache Autentikasi

   Dropstone → Palet Perintah → Bersihkan Cache Autentikasi

2. Autentikasi Ulang

   1. Keluar dari Dropstone
   2. Bersihkan cookie browser untuk dropstone.io
   3. Masuk kembali
   

3. Periksa Validitas Token

   Navigasikan ke: Pengaturan → Akun → Manajemen Sesi

   Tinjau sesi aktif dan cabut sesi yang mencurigakan.

4. Masalah SSO

   Jika menggunakan Single Sign-On:

   • Verifikasi penyedia SSO dapat diakses
   • Periksa asersi SAML yang kedaluwarsa
   • Hubungi administrator penyedia identitas Anda

Masalah Kinerja

Masalah: Respons Aplikasi Lambat atau Penggunaan CPU Tinggi

Gejala:

• Lag saat mengetik atau mengklik
• Penggunaan CPU/memori tinggi
• UI beku atau tidak responsif

Solusi:

1. Periksa Penggunaan Sumber Daya

   Dropstone → Bantuan → Manajer Proses

   Identifikasi proses yang mengonsumsi sumber daya berlebihan.

2. Nonaktifkan Ekstensi

   Nonaktifkan sementara ekstensi untuk mengisolasi masalah:

   Pengaturan → Ekstensi → Nonaktifkan semua → Mulai Ulang

3. Bersihkan Cache

   Dropstone → Pengaturan → Lanjutan → Bersihkan Cache
   

4. Kurangi Ukuran Proyek

   • Kecualikan file besar dari pengindeksan
   • Tambahkan ke file .dpsignore:
   node_modules/
   dist/
   build/
   *.log
   .git/
   

5. Akselerasi Perangkat Keras

   Alihkan akselerasi GPU:

   Pengaturan → Sistem → Gunakan Akselerasi Perangkat Keras

Masalah Deployment

Masalah: Deployment Gagal

Gejala:

• Kegagalan build
• Timeout deployment
• Kesalahan "Tidak dapat mendorong ke remote"

Solusi:

1. Periksa Log Build

   Lihat output build terperinci:

   Deployment → Riwayat → Pilih deployment yang gagal → Lihat Log

2. Verifikasi Variabel Lingkungan

   Pengaturan → Deployment → Variabel Lingkungan
   

   Pastikan semua variabel yang diperlukan telah diatur.

3. Periksa Konfigurasi Deployment

   Validasi dropstone.config.js Anda:

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

4. Kuota Penyimpanan

   Verifikasi Anda belum melebihi batas penyimpanan:

   Dasbor → Penggunaan → Penyimpanan

5. Timeout Build

   Tingkatkan timeout dalam konfigurasi:

   deployment: {
     timeout: 900 // 15 menit dalam detik
   }
   

Masalah Penyimpanan dan Database

Masalah: Sinkronisasi Data atau Kesalahan Penyimpanan

Gejala:

• "Kuota penyimpanan terlampaui"
• Konflik sinkronisasi
• Data tidak tersimpan

Solusi:

1. Periksa Penggunaan Penyimpanan

   Dasbor → Penyimpanan → Statistik Penggunaan

2. Selesaikan Konflik Sinkronisasi

   1. Navigasikan ke file yang berkonflik
   2. Dropstone akan menampilkan penanda konflik
   3. Selesaikan secara manual atau pilih versi yang akan dipertahankan
   

3. Koneksi Database

   Uji konektivitas database:

   // Di konsol Dropstone
   await dropstone.db.test()
   

4. Bersihkan Cache Lokal

   Pengaturan → Penyimpanan → Bersihkan Cache Lokal
   

   Peringatan: Ini akan menghapus data yang di-cache secara lokal.

5. Cadangkan dan Pulihkan

   Buat cadangan sebelum pemecahan masalah:

   Dropstone → Alat → Cadangkan → Buat Cadangan
   

Pemecahan Masalah Lanjutan

Mode Aman

Mulai Dropstone dalam mode aman untuk menonaktifkan semua ekstensi:

Windows/Linux:

dropstone --disable-extensions

macOS:

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

Atur Ulang ke Pengaturan Default

Untuk mengatur ulang semua pengaturan ke default:

1. Cadangkan Pengaturan Saat Ini

   Pengaturan → Lanjutan → Ekspor Pengaturan
   

2. Atur Ulang

   Pengaturan → Lanjutan → Atur Ulang Semua Pengaturan
   

Pencatatan Verbose

Aktifkan pencatatan terperinci untuk debugging:

1. Buka Palet Perintah (Ctrl/Cmd + Shift + P)
2. Pilih: Developer: Atur Tingkat Log
3. Pilih: Trace

Log sekarang akan menyertakan informasi diagnostik terperinci.

Diagnostik Jaringan

Jalankan diagnostik jaringan bawaan:

Dropstone → Bantuan → Jalankan Diagnostik Jaringan

Ini memeriksa:

• Resolusi DNS
• Aksesibilitas titik akhir API
• Koneksi WebSocket
• Ketersediaan CDN

Mendapatkan Bantuan

Sebelum Menghubungi Dukungan

Pastikan Anda memiliki:

• Memeriksa panduan pemecahan masalah ini
• Meninjau Halaman Status
• Mengumpulkan semua informasi pemecahan masalah penting

Hubungi Dukungan

Email: support@blankline.org

Sertakan dalam pesan Anda:

1. Ringkasan masalah
2. Langkah-langkah untuk mereproduksi
3. Informasi sistem
4. Log yang relevan (100 baris terakhir)
5. Tangkapan layar
6. Apa yang sudah Anda coba

Sumber Daya Lainnya

• Dokumentasi: docs.dropstone.io
• Halaman Status: status.dropstone.io
• Penjualan / Perusahaan: dropstone.io/contact

Perintah yang Berguna

Referensi Cepat Palet Perintah

Diagnostik CLI

# Periksa versi Dropstone CLI
dropstone --version

# Verifikasi instalasi
dropstone doctor

# Uji konektivitas API
dropstone ping

# Lihat konfigurasi saat ini
dropstone config list

# Bersihkan cache lokal
dropstone cache clear

# Ekspor log
dropstone logs export --output ./dropstone-logs.txt

Lampiran

Lokasi File Log

Lokasi File Konfigurasi

Variabel Lingkungan

Terakhir Diperbarui: 29 September 2025 Versi: 1.0.0