Mac版バイナンスが強制終了する際のデバッグ方法は？ログファイルの場所

2026-04-16 · 15 分 · FlyVault 編集部

バイナンスMacデスクトップクライアントのログファイルの保存パス、種類、確認方法を解説。Console.app、log streamコマンド、クラッシュレポート（.ips）、典型的なエラー対応表などを網羅。

バイナンスの Mac クライアントのログは、主に3つの場所に保存されています。1つ目は ~/Library/Application Support/Binance/logs/ で、アプリの実行ログが格納されます。2つ目は ~/Library/Logs/Binance/ で、システム統合ログが格納されます。3つ目は ~/Library/Logs/DiagnosticReports/ で、クラッシュレポートが格納されます。これらは Console.app や log stream --predicate 'subsystem == "com.binance.app"' コマンドでリアルタイムに確認できます。トラブルシューティングの際には、ネットワークログや WebSocket の状態も確認する必要があります。クライアントのダウンロードはバイナンス公式サイトから可能です。スマホ版にも同様のログ機能があり、バイナンス公式APP をダウンロードして比較確認することもできます。本記事では、ログディレクトリ、Console の使い方、典型的なエラーについて徹底解説します。

一、ログファイルの場所

Mac 上のアプリログは、一定のディレクトリ構造に従って保存されています：

パス	用途	読みやすさ
`~/Library/Application Support/Binance/logs/`	アプリの業務ログ	高
`~/Library/Logs/Binance/`	システム統合ログ	中
`~/Library/Caches/Binance/Cache/`	ネットワークキャッシュ	低
`~/Library/Logs/DiagnosticReports/`	クラッシュレポート	中
`/var/log/system.log`	システムログ（旧形式）	中
Console.app リアルタイムストリーム	すべての統合ログ（unified log）	高

ディレクトリを素早く開く方法：Finder で Command + Shift + G を押し、パスを貼り付けて Enter を押します。またはターミナルで以下を実行します：

open ~/Library/Application\ Support/Binance/logs/

二、Application Support 配下の業務ログ

1. ログの分類

~/Library/Application Support/Binance/logs/
├── main.log              # メインプロセス
├── renderer.log          # レンダリングプロセス
├── network.log           # ネットワークリクエスト
├── websocket.log         # WebSocket 相場データ配信
├── trading.log           # 取引操作記録
├── error.log             # エラー集約
└── archive/              # 過去のログ（7日間ローテーション）

2. リアルタイムで確認する

tail -f ~/Library/Application\ Support/Binance/logs/main.log

または、すべてのログをまとめて確認する場合：

tail -f ~/Library/Application\ Support/Binance/logs/*.log

3. 時間でフィルタリングする

grep "2026-04-15" ~/Library/Application\ Support/Binance/logs/network.log

4. キーワードで検索する

grep -i "error\|fail\|timeout" ~/Library/Application\ Support/Binance/logs/*.log

三、Console.app（コンソール）の使用

1. 開く方法

Spotlight 検索で Console.app と入力するか、アプリケーション → ユーティリティ → コンソールを開きます。

2. Binance ログの絞り込み

左側のサイドバーで「デバイス名」を選択し、上部の検索ボックスに Binance と入力して Enter を押します。

3. 現在のログを保存する

メニューバーのファイル → 書き出し → .logarchive ファイルとして保存します。テクニカルサポートに問い合わせる際に添付してください。

4. クラッシュレポートを確認する

左側のサイドバーで 「クラッシュレポート」 を選択します：

すべてのアプリの強制終了（クラッシュ）記録がリスト表示されます。
項目をクリックすると、詳細なスタックトレースを確認できます。
右クリック → 「Finder で表示」を選択すると、.ips ファイルの場所に移動できます。

四、log コマンド（上級者向け）

macOS には強力な log コマンドツールが標準搭載されています。

1. リアルタイムストリームを表示

log stream --predicate 'subsystem CONTAINS "binance"' --style compact

2. 直近1時間のログを表示

log show --predicate 'subsystem CONTAINS "binance"' --last 1h

3. プロセス名でフィルタリング

log show --predicate 'process == "Binance"' --last 30m

4. ファイルに書き出す

log show --predicate 'process == "Binance"' --last 4h > ~/binance-debug.log

5. エラーレベルのみ抽出

log show --predicate 'process == "Binance" AND messageType == "error"' --last 24h

五、クラッシュレポートの詳細

1. 保存パス

~/Library/Logs/DiagnosticReports/Binance-*.ips

macOS Sonoma 以降、形式が .ips に変更されました（以前は .crash）。中身は JSON 形式です。

2. 閲覧ツール

Console.app で自動解析されます。
テキストエディタで直接開くことも可能です。
コマンドラインでの確認：

ls -lt ~/Library/Logs/DiagnosticReports/Binance-* | head -5
cat ~/Library/Logs/DiagnosticReports/Binance-2026-04-15-*.ips | jq .

3. 重要なフィールド

フィールド	意味
`cpuType`	クラッシュ時の CPU アーキテクチャ（arm64 / x86_64）
`osVersion`	macOS のバージョン番号
`bundleInfo.CFBundleShortVersionString`	バイナンスクライアントのバージョン
`exception.type`	例外の種類（EXC_BAD_ACCESS / SIGABRT など）
`threads`	クラッシュ時の全スレッドスタック

4. 主なクラッシュ原因

EXC_BAD_ACCESS：ヌルポインタアクセス。アップデート後の古いデータの残留でよく発生します。
SIGABRT：強制終了。通常、Electron のレンダリングプロセスがフリーズした際に発生します。
EXC_CRASH：API の戻り値の異常などが原因で発生します。
メモリ圧迫によるクラッシュ：__vm_deallocate スタックなどで確認できます。

六、典型的なエラー対応表

ログ内のキーワードから問題を特定できます：

ログキーワード	問題内容	解決方法
`ECONNREFUSED`	接続が拒否されました	プロキシやファイアウォールを確認
`ETIMEDOUT`	接続タイムアウト	DNS の変更またはプロキシの切り替え
`certificate has expired`	証明書の期限切れ	システム時刻を同期・更新
`Invalid API key`	API キーのエラー	API キーを再生成
`timestamp for this request is outside`	時刻の同期ずれ	NTP で時刻を同期
`WebSocket closed: 1006`	異常切断	ネットワークの安定性を確認
`Keychain access denied`	キーチェーンの権限拒否	キーチェーンのアクセス権限をリセット
`QuotaExceededError`	ローカルストレージがいっぱい	キャッシュをクリア

七、ログとキャッシュのクリーンアップ

1. 業務ログの削除

rm -rf ~/Library/Application\ Support/Binance/logs/archive/

2. キャッシュの削除

rm -rf ~/Library/Caches/Binance/

3. クラッシュレポートの削除

rm ~/Library/Logs/DiagnosticReports/Binance-*

4. クライアントのリセット（完全初期化）

不具合が解消しない場合、以下のコマンドで徹底的にリセットできます：

killall Binance
rm -rf ~/Library/Application\ Support/Binance/
rm -rf ~/Library/Preferences/com.binance.app.plist
rm -rf ~/Library/Caches/Binance/

※次回の起動時は新規インストールと同じ状態になり、QR コードでの再ログインが必要です。

八、デバッグモードでの起動

1. 起動引数の指定

ターミナルから引数を付けて起動します：

/Applications/Binance.app/Contents/MacOS/Binance --debug --verbose

2. 環境変数の設定

export BINANCE_DEBUG=1
export ELECTRON_ENABLE_LOGGING=1
open /Applications/Binance.app

3. Electron DevTools（開発者ツール）

バージョンによっては、Command + Option + I で DevTools を開ける場合があります。ブラウザのデバッグと同様に Network や Console を確認できます。

九、バグ報告時に必要なもの

バイナンス公式にバグを報告する際は、以下の情報を添えてください：

macOS のバージョン：sw_vers コマンドの結果
Binance のバージョン：クライアントの設定 → バージョン情報
クラッシュ発生前1時間のログ（logarchive 形式で書き出し）
.ips クラッシュレポート
再現手順と発生時刻のタイムスタンプ
CPU アーキテクチャ：uname -m コマンドの結果

以下のコマンドでこれらを一つのパッケージにまとめることができます：

mkdir ~/binance-debug-report
cp -r ~/Library/Application\ Support/Binance/logs ~/binance-debug-report/
cp ~/Library/Logs/DiagnosticReports/Binance-*.ips ~/binance-debug-report/
sw_vers > ~/binance-debug-report/system.txt
uname -a >> ~/binance-debug-report/system.txt
tar -czf ~/binance-debug.tar.gz -C ~ binance-debug-report

生成された binance-debug.tar.gz をテクニカルサポートに送付してください。

十、ネットワーク層のパケットキャプチャ

より深いデバッグが必要な場合は、リクエストの内容を直接確認します：

1. Charles Proxy

Charles をインストール（SSL 証明書の設定が必要）。
Mac のシステムプロキシを Charles (127.0.0.1:8888) に設定。
Binance を起動し、リクエストを監視。
binance.com ドメインでフィルタリング。

2. Wireshark

brew install --cask wireshark

ネットワークインターフェース全体のトラフィックをキャプチャします。TCP 層の問題（RST、ハンドシェイク失敗など）の分析に適しています。

3. mitmproxy（コマンドライン）

brew install mitmproxy
mitmproxy --mode transparent --listen-port 8080

軽量なパケットキャプチャツールです。

よくある質問 FAQ

Q1: ログファイルが肥大化しています。自動で削除されますか？

A: クライアントに7日間のローテーション機能が内蔵されており、古いものは自動削除されます。より積極的に削除したい場合は、crontab に以下を記述してください：

0 2 * * * find ~/Library/Application\ Support/Binance/logs -mtime +3 -delete

毎日午前2時に3日以上前のログを削除します。

Q2: Console.app で Binance のログが全く表示されません。

A: 検索ボックスのキーワード（subsystem）が正しいか確認してください。com.binance と入力するか、単に Binance と入力してみてください。また、クライアントが実際に動作していないとログは出力されません。

Q3: ログに大量の EACCES（権限エラー）が表示されます。

A: クライアントを /Applications/ にインストールしているが、ログディレクトリへの書き込み権限がない可能性があります。以下のコマンドで権限を修正してください：

sudo chown -R $(whoami) ~/Library/Application\ Support/Binance

Q4: .ips クラッシュレポートの内容が難解で分かりません。

A: そのファイルをバイナンスのテクニカルサポートに送ってください。彼らはシンボル表を持っているため、可読な関数名に復元できます。自身で確認する場合は、主にタイムスタンプと例外の種類を確認する程度にとどめ、詳細なスタック解析は専門ツールに任せるのが無難です。

Q5: ログにアカウント情報が含まれていますか？

A: ログには一部の API レスポンス（アカウント ID、資産残高など）が記録されることがありますが、パスワードや 2FA コードは記録されません。ログを共有する際は、sed 's/account_id=[0-9]*/account_id=***/g' などのコマンドでマスキングすることをお勧めします。

さらなるトラブルシューティングのテクニックは、カテゴリナビの「Macガイド」カテゴリをご覧ください。

引き続き閲覧

バイナンスの利用でまだ疑問がありますか？カテゴリページに戻って同じテーマの他のガイドを探しましょう。

カテゴリナビ