바이낸스 Mac 클라이언트의 로그는 주로 세 곳에 저장됩니다. 첫째, ~/Library/Application Support/Binance/logs/ 폴더에는 앱 실행 로그가 저장됩니다. **둘째, ~/Library/Logs/Binance/**에는 시스템 계층 로그가, **셋째, ~/Library/Logs/DiagnosticReports/**에는 충돌 보고서가 저장됩니다. Console.app이나 log stream --predicate 'subsystem == "com.binance.app"' 명령어를 사용하여 실시간으로 확인할 수 있습니다. 오류 해결 시 네트워크 로그와 WebSocket 상태 확인도 중요합니다. 최신 클라이언트는 바이낸스 공식 사이트에서 다운로드할 수 있으며, 모바일 앱 로그 확인이 필요한 경우 바이낸스 공식 앱을 설치하여 대조해볼 수 있습니다. 본문에서는 로그 디렉터리, Console 사용법, 주요 오류 해결법을 자세히 다룹니다.
1. 로그 파일 위치 안내
Mac 앱 로그는 고정된 디렉터리 구조를 따릅니다.
| 경로 | 용도 | 가독성 |
|---|---|---|
~/Library/Application Support/Binance/logs/ |
앱 비즈니스 로그 | 높음 |
~/Library/Logs/Binance/ |
시스템 통합 로그 | 보통 |
~/Library/Caches/Binance/Cache/ |
네트워크 캐시 | 낮음 |
~/Library/Logs/DiagnosticReports/ |
충돌 보고서 | 보통 |
/var/log/system.log |
구형 시스템 로그 | 보통 |
| Console.app 실시간 스트림 | 모든 통합 로그 | 높음 |
빠르게 여는 방법: Finder에서 Command + Shift + G → 경로 붙여넣기 → 엔터. 또는 터미널에서 다음 명령어를 입력하세요:
open ~/Library/Application\ Support/Binance/logs/
2. Application Support 내 비즈니스 로그
로그 분류
~/Library/Application Support/Binance/logs/
├── main.log # 메인 프로세스
├── renderer.log # 렌더링 프로세스
├── network.log # 네트워크 요청
├── websocket.log # WebSocket 시세 푸시
├── trading.log # 거래 조작 기록
├── error.log # 오류 요약
└── archive/ # 지난 로그 (7일 순환)
실시간 확인
tail -f ~/Library/Application\ Support/Binance/logs/main.log
모든 로그를 통합해서 보려면:
tail -f ~/Library/Application\ Support/Binance/logs/*.log
특정 조건 검색
- 날짜별:
grep "2026-04-15" ~/Library/Application\ Support/Binance/logs/network.log - 키워드별:
grep -i "error\|fail\|timeout" ~/Library/Application\ Support/Binance/logs/*.log
3. Console.app(콘솔) 활용
앱 실행
Spotlight 검색에서 Console.app을 찾거나, 응용 프로그램 → 유틸리티 → 콘솔을 실행합니다.
바이낸스 로그 필터링
왼쪽 사이드바에서 '내 기기 이름' 선택 → 상단 검색창에 Binance 입력 후 엔터.
로그 저장 및 공유
메뉴바의 파일 → 내보내기 → .logarchive 파일로 저장하여 기술 지원팀에 전달할 수 있습니다.
충돌 보고서 확인
왼쪽 사이드바의 충돌 보고서 메뉴를 클릭하면 앱 충돌 기록 목록이 나타납니다. 특정 항목을 클릭하여 스택 추적 정보를 확인하거나, 마우스 오른쪽 버튼 → Finder에서 보기로 .ips 파일 위치를 찾을 수 있습니다.
4. log 명령어 활용 (숙련자 권장)
macOS에 내장된 강력한 log 도구입니다.
실시간 스트림 확인
log stream --predicate 'subsystem CONTAINS "binance"' --style compact
최근 1시간 로그 조회
log show --predicate 'subsystem CONTAINS "binance"' --last 1h
특정 프로세스(Binance) 로그 추출
log show --predicate 'process == "Binance"' --last 30m
5. 충돌 보고서 상세 분석
파일 경로
~/Library/Logs/DiagnosticReports/Binance-*.ips
Sonoma 버전부터 .ips 형식으로 변경되었으며(이전에는 .crash), 본질은 JSON 파일입니다.
주요 필드 의미
| 필드 | 의미 |
|---|---|
cpuType |
충돌 당시 CPU 아키텍처 (arm64/x86_64) |
osVersion |
macOS 버전 정보 |
exception.type |
예외 유형 (EXC_BAD_ACCESS / SIGABRT 등) |
threads |
충돌 당시 모든 스레드 스택 |
일반적인 충돌 원인
- EXC_BAD_ACCESS: 잘못된 메모리 접근 (업데이트 후 잔여 데이터 충돌 등)
- SIGABRT: 앱 강제 종료 (보통 Electron 렌더링 프로세스 프리징)
- EXC_CRASH: API 반환값 오류로 인한 발생
6. 주요 오류 코드 대조표
로그의 키워드를 통해 문제를 즉시 진단할 수 있습니다.
| 로그 키워드 | 문제 원인 | 해결 방법 |
|---|---|---|
ECONNREFUSED |
연결 거부 | 프록시/방화벽 설정 확인 |
ETIMEDOUT |
연결 시간 초과 | DNS 변경 또는 네트워크 교체 |
certificate has expired |
인증서 만료 | 시스템 시간 동기화 확인 |
Invalid API key |
API 키 오류 | API 키 재발급 및 재설정 |
timestamp for this request is outside |
시간 불일치 | NTP 시간 동기화 실행 |
WebSocket closed: 1006 |
비정상 종료 | 네트워크 안정성 확인 |
Keychain access denied |
키체인 접근 거부 | 키체인 접근 권한 재설정 |
7. 로그 및 캐시 정리 방법
비즈니스 로그 아카이브 삭제
rm -rf ~/Library/Application\ Support/Binance/logs/archive/
캐시 데이터 정리
rm -rf ~/Library/Caches/Binance/
클라이언트 초기화 (완전 리셋)
앱이 계속 실행되지 않을 때 유용합니다:
killall Binance
rm -rf ~/Library/Application\ Support/Binance/
rm -rf ~/Library/Preferences/com.binance.app.plist
rm -rf ~/Library/Caches/Binance/
다음 실행 시 초기 설치 상태와 동일하게 작동하며 QR 로그인이 필요합니다.
8. 디버그(Debug) 모드 실행
터미널 파라미터 실행
/Applications/Binance.app/Contents/MacOS/Binance --debug --verbose
환경 변수 설정
export BINANCE_DEBUG=1
export ELECTRON_ENABLE_LOGGING=1
open /Applications/Binance.app
9. 버그 제보 시 필수 정보
바이낸스 고객센터에 버그를 제보할 때 다음 정보를 포함하세요:
- macOS 버전 (
sw_vers) - 바이낸스 앱 버전 (설정 → 정보)
- 충돌 전 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
tar -czf ~/binance-debug.tar.gz -C ~ binance-debug-report
10. 고급 네트워크 분석
문제가 지속되면 패킷 분석 도구를 사용할 수 있습니다:
- Charles Proxy: HTTPS 요청 상세 분석용
- Wireshark: TCP 계층의 하위 레벨 분석용 (핸드셰이크 실패 등)
- mitmproxy: 가벼운 터미널용 패킷 분석 도구
자주 묻는 질문 FAQ
Q1: 로그 파일이 너무 커지면 자동으로 삭제되나요? A: 클라이언트에 7일 순환 기능이 내장되어 있어 오래된 로그는 자동 삭제됩니다. 수동으로 더 자주 삭제하려면 crontab 설정을 이용하세요.
Q2: Console.app에서 바이낸스 로그가 전혀 보이지 않습니다.
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 정보는 기록되지 않습니다. 로그 공유 전 계정 ID 등을 가리고 싶다면 텍스트 편집기에서 마스킹 처리를 하세요.
더 많은 해결 팁은 카테고리 내비게이션의 Mac 가이드 카테고리에서 확인하세요.