Dropstoneトラブルシューティングガイド - 問題の診断と修正

このガイドでは、Dropstone.ioで発生する一般的な問題を体系的に診断・解決するためのアプローチを紹介します。以下の手順に従って、サポートに連絡する前に必要な情報を収集してください。

トラブルシューティングに必要な基本情報

以下の情報は、Dropstone内のほとんどのトラブルシューティングシナリオで重要です。

1. 視覚的な記録

問題のスクリーンショット（機密情報は必ず編集してください）

• エラーが表示されているアプリケーションウィンドウ全体をキャプチャする
• エラーメッセージやダイアログを含める
• 可能であればタイムスタンプが表示されていることを確認する

2. 再現手順

問題を再現するための詳細な手順を記載してください：

1. 実行した操作（例：「「デプロイ」ボタンをクリックした」）
2. 期待される動作
3. 実際の動作
4. 発生頻度（毎回、時々、一度だけ）

3. システム情報

以下の場所からシステム情報を取得します：

Dropstone → ヘルプ → バージョン情報

これには以下が含まれます：

• Dropstoneのバージョン
• オペレーティングシステム
• アーキテクチャ（x64、arm64）
• Electronのバージョン
• Node.jsのバージョン

4. ネットワーク構成

以下のいずれかを使用していますか？

• VPN（仮想プライベートネットワーク）
• Zscalerやその他のセキュリティプロキシ
• 企業ファイアウォール
• カスタムDNS設定

5. 開発者ツールコンソール

開発者ツールにアクセスして、JavaScriptエラーを確認します：

Dropstone → ヘルプ → 開発者ツールの切り替え

コンソールタブに移動して、以下を確認します：

• 赤いエラーメッセージ
• 問題に関連する警告メッセージ
• ネットワークリクエストの失敗

関連するエラーのスタックトレースをコピーします。

6. アプリケーションログ

Windows

ログは以下の場所にあります：

C:\Users\<ユーザー名>\AppData\Roaming\Dropstone\logs

コマンドパレットからアクセスするには：

1. Ctrl + Shift + P を押す
2. 「開発者: ログフォルダを開く」と入力して選択する

macOS

ログは以下の場所にあります：

~/Library/Application Support/Dropstone/logs

コマンドパレットからアクセスするには：

1. Cmd + Shift + P を押す
2. 「開発者: ログフォルダを開く」と入力して選択する

Linux

ログは以下の場所にあります：

~/.config/Dropstone/logs

アプリケーション内でログを表示する

以下の場所に移動します： Dropstone → ターミナル → 出力

ドロップダウンから選択します：

• ウィンドウ - 一般的なアプリケーションログ
• Dropstone Core - コア機能のログ
• Dropstone デプロイメント - デプロイ関連のログ
• Dropstone ストレージ - ストレージとデータベースのログ
• Dropstone API - APIリクエスト/レスポンスのログ

一般的な問題と解決策

接続の問題

問題: Dropstoneサービスに接続できない

症状：

• 「接続がタイムアウトしました」エラー
• 「サーバーに到達できません」というメッセージ
• 無限に続く読み込み状態

解決策：

1. インターネット接続を確認する

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

2. ファイアウォール設定を確認する

   • Dropstoneがファイアウォールを通過できることを確認する
   • 企業のネットワークポリシーを確認する
   • *.dropstone.io ドメインをホワイトリストに追加する

3. プロキシ設定

   プロキシ設定を構成します：

   Dropstone → 設定 → ネットワーク → プロキシ設定

   または、環境変数を設定します：

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

4. DNS解決

   • DNSキャッシュをフラッシュする
   • 代替DNS（8.8.8.8、1.1.1.1）を試す

認証の問題

問題: ログイン失敗またはトークンの有効期限切れ

症状：

• 「認証に失敗しました」エラー
• 繰り返し表示されるログインプロンプト
• 401 Unauthorized応答

解決策：

1. 認証キャッシュをクリアする

   Dropstone → コマンドパレット → 認証キャッシュをクリア

2. 再認証する

   1. Dropstoneからサインアウトする
   2. dropstone.ioのブラウザCookieをクリアする
   3. 再度サインインする
   

3. トークンの有効性を確認する

   設定 → アカウント → セッション管理 に移動します。

   アクティブなセッションを確認し、不審なセッションを取り消します。

4. SSOの問題

   シングルサインオンを使用している場合：

   • SSOプロバイダーにアクセスできることを確認する
   • SAMLアサーションの有効期限切れを確認する
   • IDプロバイダーの管理者に連絡する

パフォーマンスの問題

問題: アプリケーションの応答が遅い、またはCPU使用率が高い

症状：

• 入力やクリック時のラグ
• 高いCPU/メモリ使用率
• フリーズまたは応答しないUI

解決策：

1. リソース使用量を確認する

   Dropstone → ヘルプ → プロセスマネージャー

   過剰なリソースを消費しているプロセスを特定します。

2. 拡張機能を無効にする

   問題を切り分けるために、一時的に拡張機能を無効にします：

   設定 → 拡張機能 → すべて無効にする → 再起動

3. キャッシュをクリアする

   Dropstone → 設定 → 詳細設定 → キャッシュをクリア
   

4. プロジェクトサイズを削減する

   • インデックス作成から大きなファイルを除外する
   • .dpsignore ファイルに追加する：
   node_modules/
   dist/
   build/
   *.log
   .git/
   

5. ハードウェアアクセラレーション

   GPUアクセラレーションを切り替えます：

   設定 → システム → ハードウェアアクセラレーションを使用

デプロイメントの問題

問題: デプロイの失敗

症状：

• ビルドの失敗
• デプロイのタイムアウト
• 「リモートにプッシュできません」エラー

解決策：

1. ビルドログを確認する

   詳細なビルド出力を表示します：

   デプロイメント → 履歴 → 失敗したデプロイを選択 → ログを表示

2. 環境変数を確認する

   設定 → デプロイメント → 環境変数
   

   必要な変数がすべて設定されていることを確認します。

3. デプロイ設定を確認する

   dropstone.config.js を検証します：

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

4. ストレージ容量

   ストレージの上限を超えていないことを確認します：

   ダッシュボード → 使用状況 → ストレージ

5. ビルドのタイムアウト

   設定でタイムアウトを増やします：

   deployment: {
     timeout: 900 // 15分（秒単位）
   }
   

ストレージとデータベースの問題

問題: データ同期またはストレージエラー

症状：

• 「ストレージ容量を超えました」
• 同期の競合
• データが永続化されない

解決策：

1. ストレージ使用量を確認する

   ダッシュボード → ストレージ → 使用統計

2. 同期の競合を解決する

   1. 競合しているファイルに移動する
   2. Dropstoneに競合マーカーが表示される
   3. 手動で解決するか、保持するバージョンを選択する
   

3. データベース接続

   データベースの接続をテストします：

   // Dropstoneコンソールで
   await dropstone.db.test()
   

4. ローカルキャッシュをクリアする

   設定 → ストレージ → ローカルキャッシュをクリア
   

   警告：これにより、ローカルにキャッシュされたデータが削除されます。

5. バックアップと復元

   トラブルシューティングの前にバックアップを作成します：

   Dropstone → ツール → バックアップ → バックアップを作成
   

高度なトラブルシューティング

セーフモード

すべての拡張機能を無効にしてDropstoneを起動します：

Windows/Linux：

dropstone --disable-extensions

macOS：

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

デフォルト設定にリセットする

すべての設定をデフォルトにリセットするには：

1. 現在の設定をバックアップする

   設定 → 詳細設定 → 設定をエクスポート
   

2. リセットする

   設定 → 詳細設定 → すべての設定をリセット
   

詳細ログ

デバッグ用の詳細ログを有効にします：

1. コマンドパレットを開く（Ctrl/Cmd + Shift + P）
2. 開発者: ログレベルを設定 を選択する
3. トレース を選択する

ログに詳細な診断情報が含まれるようになります。

ネットワーク診断

組み込みのネットワーク診断を実行します：

Dropstone → ヘルプ → ネットワーク診断を実行

これにより、以下がチェックされます：

• DNS解決
• APIエンドポイントへのアクセス可能性
• WebSocket接続
• CDNの可用性

サポートを受ける

サポートに連絡する前に

以下を確認してください：

• このトラブルシューティングガイドを確認した
• ステータスページを確認した
• 必要なトラブルシューティング情報をすべて収集した

サポートに連絡する

メール： support@blankline.org

メッセージに含める内容：

1. 問題の概要
2. 再現手順
3. システム情報
4. 関連するログ（最後の100行）
5. スクリーンショット
6. すでに試したこと

その他のリソース

• ドキュメント： docs.dropstone.io
• ステータスページ： status.dropstone.io
• 営業/エンタープライズ： dropstone.io/contact

便利なコマンド

コマンドパレットのクイックリファレンス

CLI診断

# Dropstone CLIのバージョンを確認
dropstone --version

# インストールを検証
dropstone doctor

# API接続をテスト
dropstone ping

# 現在の設定を表示
dropstone config list

# ローカルキャッシュをクリア
dropstone cache clear

# ログをエクスポート
dropstone logs export --output ./dropstone-logs.txt

付録

ログファイルの場所

設定ファイルの場所

環境変数

最終更新日：2025年9月29日 バージョン：1.0.0