Logs y diagnóstico

Sistema de Logging#

Vasak Desktop utiliza el sistema de logging estándar de Rust mediante el crate log. Los mensajes de registro no se guardan en archivos por defecto, sino que se envían a la salida de error estándar (stderr).

Cómo ver los logs#

Ejecutar con logs habilitados#

Para ver los logs al ejecutar la aplicación, usa la variable de entorno RUST_LOG:

1
2
3
4
5
6
7
8

# Ver todos los logs (muy detallado)
RUST_LOG=debug vasak-desktop

# Ver solo advertencias y errores
RUST_LOG=warn vasak-desktop

# Ver logs específicos de un módulo
RUST_LOG=vasak_desktop::audio=debug vasak-desktop

Niveles de log disponibles:

• error - Solo errores críticos
• warn - Advertencias y errores
• info - Información general + warn + error
• debug - Información detallada (recomendado para depuración)
• trace - Extremadamente detallado (para desarrollo)

Ver logs si ejecutas desde un lanzador#

Si inicias Vasak Desktop desde un lanzador de aplicaciones o al iniciar sesión, puedes ver los logs con journalctl:

1
2
3
4
5
6
7
8

# Ver logs en tiempo real
journalctl --user -f | grep vasak

# Ver logs recientes
journalctl --user --since "10 minutes ago" | grep vasak

# Ver solo errores
journalctl --user -p err | grep vasak

Redirigir logs a un archivo#

Si necesitas guardar los logs en un archivo para análisis:

1
2
3
4
5

# Guardar logs en un archivo
RUST_LOG=debug vasak-desktop 2>&1 | tee ~/vasak-desktop.log

# Solo guardar stderr (logs)
RUST_LOG=debug vasak-desktop 2> ~/vasak-desktop.log

Archivos de configuración#

La configuración del sistema se guarda en:

1

~/.config/vasak/system_config.json

Este archivo contiene:

• dark_mode - Estado del modo oscuro
• icon_pack - Pack de iconos seleccionado
• cursor_theme - Tema del cursor
• gtk_theme - Tema GTK

Depuración avanzada#

Los archivos de log contienen información con diferentes niveles de detalle:

• DEBUG - Información detallada para desarrolladores (mucho contenido)
• INFO - Información general sobre el funcionamiento
• WARN - Advertencias (algo podría no funcionar correctamente)
• ERROR - Errores (algo dejó de funcionar)
• CRITICAL - Errores graves que pueden causar crashes

Limpieza de Logs#

Los logs se regeneran automáticamente. Si necesitas limpiar logs antiguos:

1
2
3
4
5

# Eliminar todos los logs
rm -rf ~/.local/share/vasak-desktop/logs/

# Eliminar solo logs de más de 30 días
find ~/.local/share/vasak-desktop/logs -name "*.log" -mtime +30 -delete

Exportar Logs para Reporte#

Si necesitas compartir logs para un reporte de errores:

1
2
3
4
5
6
7
8
9

# Crear un archivo comprimido con todos los logs

### Capturar logs para reportar un error

Si necesitas compartir logs con los desarrolladores:

```bash
# Ejecutar con logs completos y guardar
RUST_LOG=debug vasak-desktop 2>&1 | tee vasak-debug-$(date +%Y%m%d-%H%M%S).log

Esto creará un archivo con fecha y hora que puedes adjuntar en un reporte de error.

Logs de D-Bus#

Para depurar la comunicación D-Bus (utilizada para audio, bluetooth, notificaciones):

1
2
3
4
5

# Ver mensajes D-Bus del sistema
dbus-monitor --system

# Ver mensajes D-Bus de sesión de usuario
dbus-monitor --session

Información adicional#

Verificar si la aplicación está ejecutándose#

1

ps aux | grep vasak-desktop

Ver uso de recursos#

1
2
3
4
5

# CPU y memoria
top -p $(pgrep vasak-desktop)

# O con htop
htop -p $(pgrep vasak-desktop)

Nota: Si encuentras un error, consulta la guía de reporte de errores para saber qué información incluir.