Los registros (logs) del cliente de Binance para Mac se encuentran principalmente en tres ubicaciones: primero, en ~/Library/Application Support/Binance/logs/ para los registros de funcionamiento de la aplicación; segundo, en ~/Library/Logs/Binance/ para los registros a nivel de sistema; y tercero, en ~/Library/Logs/DiagnosticReports/ para los informes de cierre inesperado (crashes). Puedes visualizarlos en tiempo real usando Console.app o el comando log stream --predicate 'subsystem == "com.binance.app"'. Al solucionar problemas, también es necesario verificar los registros de red y el estado de WebSocket. El cliente se puede descargar en el Sitio oficial de Binance; la versión móvil también cuenta con registros, puedes consultar la App oficial de Binance para comparar. En este artículo explicamos detalladamente los directorios de logs, el uso de la Consola y los errores típicos.
I. ¿Dónde están realmente los logs?
En Mac, los registros de aplicaciones siguen una estructura de directorios fija:
| Ruta | Uso | Legibilidad |
|---|---|---|
~/Library/Application Support/Binance/logs/ |
Logs de operación de la app | Alta |
~/Library/Logs/Binance/ |
Logs de integración del sistema | Media |
~/Library/Caches/Binance/Cache/ |
Caché de red | Baja |
~/Library/Logs/DiagnosticReports/ |
Informes de error (Crashes) | Media |
/var/log/system.log |
Log del sistema (antiguo) | Media |
| Flujo en tiempo real de Console.app | Todos los registros unificados | Alta |
Método rápido para abrir: Finder → Command + Shift + G → pega la ruta → Enter. O desde la Terminal:
open ~/Library/Application\ Support/Binance/logs/
II. Logs de operación en Application Support
1. Clasificación de logs
~/Library/Application Support/Binance/logs/
├── main.log # Proceso principal
├── renderer.log # Proceso de renderizado
├── network.log # Peticiones de red
├── websocket.log # Push de mercado vía WebSocket
├── trading.log # Registro de operaciones de trading
├── error.log # Resumen de errores
└── archive/ # Historial de logs (rotación de 7 días)
2. Visualización en tiempo real
tail -f ~/Library/Application\ Support/Binance/logs/main.log
O todos los logs mezclados:
tail -f ~/Library/Application\ Support/Binance/logs/*.log
3. Filtrar por fecha
grep "2026-04-15" ~/Library/Application\ Support/Binance/logs/network.log
4. Filtrar por palabra clave
grep -i "error\|fail\|timeout" ~/Library/Application\ Support/Binance/logs/*.log
III. Consola (Console.app)
1. Cómo abrirla
Busca Console.app en Spotlight, o ve a Aplicaciones → Utilidades → Consola.
2. Filtrar logs de Binance
En la barra lateral izquierda, haz clic en el nombre de tu dispositivo → en el cuadro de búsqueda superior escribe Binance → Enter.
3. Guardar logs actuales
Menú Archivo → Exportar → Guardar como archivo .logarchive. Adjúntalo al contactar con el soporte técnico.
4. Ver informes de error (Crash Reports)
Barra lateral izquierda → Informes de errores:
- Lista todos los registros de cierres inesperados.
- Haz clic en uno para ver el rastreo completo (stack trace).
- Clic derecho → Mostrar en Finder → para ir a la ubicación del archivo
.crasho.ips.
IV. Comando log (Recomendado para usuarios avanzados)
macOS incluye la potente herramienta de comandos log.
1. Flujo en tiempo real
log stream --predicate 'subsystem CONTAINS "binance"' --style compact
2. Logs de la última hora
log show --predicate 'subsystem CONTAINS "binance"' --last 1h
3. Filtrar por nombre de proceso
log show --predicate 'process == "Binance"' --last 30m
4. Exportar a un archivo
log show --predicate 'process == "Binance"' --last 4h > ~/binance-debug.log
5. Filtrar por nivel de error
log show --predicate 'process == "Binance" AND messageType == "error"' --last 24h
V. Detalles de los informes de error (Crash Reports)
1. Ruta
~/Library/Logs/DiagnosticReports/Binance-*.ips
Desde macOS Sonoma se usa el formato .ips (antes era .crash), que es básicamente un JSON.
2. Herramientas de visualización
- Console.app los analiza automáticamente.
- Cualquier editor de texto.
- Línea de comandos:
ls -lt ~/Library/Logs/DiagnosticReports/Binance-* | head -5
cat ~/Library/Logs/DiagnosticReports/Binance-2026-04-15-*.ips | jq .
3. Campos clave
| Campo | Significado |
|---|---|
cpuType |
Arquitectura de CPU al momento del error (arm64/x86_64) |
osVersion |
Versión de macOS |
bundleInfo.CFBundleShortVersionString |
Versión de Binance |
exception.type |
Tipo de excepción (EXC_BAD_ACCESS / SIGABRT) |
threads |
Pila de todos los hilos al momento del cierre |
4. Causas comunes de cierre
- EXC_BAD_ACCESS: Acceso a puntero nulo, común por residuos de datos antiguos tras una actualización.
- SIGABRT: Terminación activa, generalmente por bloqueo del proceso de renderizado de Electron.
- EXC_CRASH: Causado por valores de retorno anómalos de la API.
- Cierre por presión de memoria: Pila
__vm_deallocate.
VI. Tabla de referencia de errores típicos
Localiza el problema según las palabras clave en los logs:
| Palabra clave en log | Problema | Solución |
|---|---|---|
ECONNREFUSED |
Conexión rechazada | Revisa tu proxy o firewall |
ETIMEDOUT |
Tiempo de conexión agotado | Cambia de DNS o proxy |
certificate has expired |
Certificado caducado | Actualiza la hora del sistema |
Invalid API key |
Clave API incorrecta | Genera una nueva |
timestamp for this request is outside |
Hora no sincronizada | Sincroniza la hora mediante NTP |
WebSocket closed: 1006 |
Cierre anómalo | Revisa la estabilidad de tu red |
Keychain access denied |
Acceso denegado al Llavero | Restablece los permisos del Llavero |
QuotaExceededError |
Almacenamiento local lleno | Limpia la caché |
VII. Limpieza de logs y caché
1. Limpiar logs de operación
rm -rf ~/Library/Application\ Support/Binance/logs/archive/
2. Limpiar caché
rm -rf ~/Library/Caches/Binance/
3. Limpiar informes de error
rm ~/Library/Logs/DiagnosticReports/Binance-*
4. Restablecer el cliente
Para un restablecimiento total:
killall Binance
rm -rf ~/Library/Application\ Support/Binance/
rm -rf ~/Library/Preferences/com.binance.app.plist
rm -rf ~/Library/Caches/Binance/
Al iniciar la próxima vez será como una instalación nueva (necesitarás iniciar sesión de nuevo).
VIII. Activar el modo Debug del cliente
1. Parámetros de inicio
Inicia desde la Terminal con parámetros:
/Applications/Binance.app/Contents/MacOS/Binance --debug --verbose
2. Variables de entorno
export BINANCE_DEBUG=1
export ELECTRON_ENABLE_LOGGING=1
open /Applications/Binance.app
3. Electron DevTools
Presionar Command + Option + I podría abrir las DevTools (soportado en algunas versiones), permitiendo ver Network, Console, etc., similar a la depuración en un navegador.
IX. ¿Qué incluir al enviar un informe de error?
Al enviar comentarios al equipo oficial de Binance, adjunta:
- Versión de macOS:
sw_vers. - Versión de Binance: Ajustes del cliente → Acerca de.
- Logs de la última hora previa al error (exportados como logarchive).
- Informes de error
.ips. - Pasos para reproducir el error y marca de tiempo.
- Arquitectura de CPU:
uname -m.
Puedes empaquetar todo de una vez:
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
Envía el archivo binance-debug.tar.gz al soporte técnico.
X. Captura de paquetes a nivel de red
Para una depuración más profunda, captura los paquetes para ver las peticiones:
1. Charles Proxy
- Instala Charles (requiere configurar el certificado SSL).
- Establece el proxy del sistema Mac como Charles (127.0.0.1:8888).
- Inicia Binance → Observa las peticiones.
- Filtra por el dominio
binance.com.
2. Wireshark
brew install --cask wireshark
Captura el tráfico de toda la tarjeta de red, ideal para analizar problemas a nivel de capa TCP (como RST o fallos en el saludo inicial).
3. mitmproxy (Línea de comandos)
brew install mitmproxy
mitmproxy --mode transparent --listen-port 8080
Captura de paquetes ligera.
Preguntas frecuentes FAQ
P1: El archivo de log es cada vez más grande, ¿cómo se limpia automáticamente?
R: El cliente tiene una rotación integrada de 7 días; los archivos más antiguos se eliminan automáticamente. Si deseas ser más agresivo, puedes configurar un crontab:
0 2 * * * find ~/Library/Application\ Support/Binance/logs -mtime +3 -delete
Esto limpiará logs de más de 3 días cada madrugada a las 2:00.
P2: ¿Por qué no veo ningún log de Binance en Console.app?
R: Asegúrate de usar el subsistema correcto en el cuadro de búsqueda; prueba con com.binance o simplemente escribe Binance. Además, el cliente debe estar en ejecución para generar logs.
P3: ¿Aparecen muchos errores de permisos EACCES en el log?
R: Es posible que el cliente esté instalado en /Applications/ (visible para todos los usuarios) pero el directorio de logs no tenga permisos de escritura. Solución:
sudo chown -R $(whoami) ~/Library/Application\ Support/Binance
P4: No entiendo el informe de error .ips, ¿qué hago?
R: Envía el archivo al soporte técnico oficial de Binance; ellos tienen las tablas de símbolos para traducir el informe a nombres de funciones legibles. Tú puedes usarlo para obtener la marca de tiempo y el tipo de excepción.
P5: ¿Se filtra mi información de cuenta en los logs?
R: Los logs del cliente de Binance pueden registrar partes de las respuestas de la API (incluyendo ID de cuenta y activos), pero nunca registrarán contraseñas ni el código 2FA. Antes de compartir un log, se recomienda desensibilizarlo usando sed 's/account_id=[0-9]*/account_id=***/g'.
Consulta más técnicas de resolución de problemas en la categoría de tutoriales de Mac en la Navegación por categorías.