Registro y Diagnóstico

AppPorts tiene un sistema de registro integrado que registra eventos clave, operaciones de migración, información del sistema y detalles de errores durante la ejecución de la aplicación. Cuando surgen problemas, puede exportar un paquete de diagnóstico y enviarlo a los Issues del proyecto para solución de problemas.

Contenido Registrado

Información de Sesión de Inicio

La siguiente información se registra cada vez que la aplicación se inicia:

Elemento	Descripción
ID de Sesión	Identificador único para esta ejecución (prefijo UUID de 8 caracteres)
ID de Proceso	Identificador de proceso del sistema
Bundle ID	Identificador de la aplicación
Idioma de la App	Código de idioma actualmente seleccionado
Configuración Regional del Sistema	Identificador de configuración regional del sistema
Zona Horaria	Identificador de zona horaria actual
Lista de Idiomas Preferidos	Orden de idiomas preferidos del sistema

Información de Diagnóstico del Sistema

Elemento	Descripción
Versión de la App	Número de versión y número de compilación
Versión de macOS	Versión del sistema y nombre comercial (ej., "macOS Sequoia 15.x")
Modelo del Dispositivo	Modelo y nombre amigable (ej., "MacBook Pro (14-inch, M3 Pro, 2023)")
Info del Procesador	Cadena de marca, número de núcleos, número de núcleos activos
Memoria Física	Memoria total

Información de Almacenamiento Externo

Registrada al seleccionar un volumen de almacenamiento externo:

Elemento	Descripción
Nombre del Volumen	Nombre del volumen de almacenamiento
Capacidad Total / Espacio Disponible	Información de espacio de almacenamiento
Formato del Sistema de Archivos	ej., APFS, HFS+, exFAT, etc.
Protocolo de Interfaz	USB, Thunderbolt, NVMe/SATA
Velocidad del Dispositivo	Información de tasa de transferencia
Tamaño de Bloque	Tamaño de bloque de almacenamiento
UUID del Volumen	Identificador único del volumen de almacenamiento

Eventos de Operación de Migración

Cada operación de migración genera un ID de operación único (ej., data-migrate-ABCD1234), registrando:

• Inicio y fin de la operación
• Progreso de cada paso (copiar, eliminar directorio original, crear enlace simbólico, rollback)
• Capturas de estado de rutas antes y después de los pasos (existencia, permisos, tamaño, destino de symlink, bandera inmutable)
• Detección de datos de migración residuales y recuperación automática
• Progreso de copia de archivos, errores y reintentos

Informes de Rendimiento de Migración

Elemento	Descripción
Nombre de la App	Nombre de la aplicación migrada
Tamaño de Datos	Volumen de datos migrado
Duración	Duración de la migración (segundos)
Velocidad de Transferencia	Tasa de transferencia (MB/s)
Ruta de Origen / Ruta de Destino	Rutas de inicio y fin de la migración

Detalles de Error

Los registros de errores contienen información estructurada:

Campo	Descripción
Descripción del Error	Descripción legible del error
Tipo / Dominio / Código de Error	Información estructurada de NSError
Razón del Fallo	Razón detallada del fallo
Sugerencia de Recuperación	Sugerencia de recuperación proporcionada por el sistema
Ruta de Archivo	Ruta del archivo afectado
Error Subyacente	Error anidado registrado recursivamente

Resumen de Operación

Cada operación de migración genera un OperationSummaryRecord, reteniendo los 100 registros más recientes:

Campo	Descripción
operationID	Identificador único de la operación
category	Categoría de la operación (app_move, data-migrate, file-copy, etc.)
result	Resultado (success, failed, rolled_back, success_with_warning)
errorCode	Código de error (si existe)
startedAt / endedAt	Hora de inicio y fin
durationMs	Duración (milisegundos)

Configuración del Registro

Ubicación de Almacenamiento

Ruta predeterminada del registro:

~/Library/Application Support/AppPorts/AppPorts_Log.txt

Se puede personalizar mediante:

• Barra de menú → Registros → Establecer Ubicación del Registro
• Configuración → Configuración de Registro → Ruta Personalizada

Formato del Registro

[2026-05-08 09:30:00] [INFO] [session:a1b2c3d4] [pid:12345] App started
[2026-05-08 09:30:01] [DIAG] [session:a1b2c3d4] [pid:12345]   app_version: 1.6.1 (123)
[2026-05-08 09:30:05] [PERF] [session:a1b2c3d4] [pid:12345]   Migration complete: 2.3 GB, 45.2 MB/s, 52.1s

Niveles de Registro

Nivel	Descripción
INFO	Información general
ERROR	Información de errores (con detalles de error estructurados)
DIAG	Información de diagnóstico del sistema
DISK	Información de volúmenes de almacenamiento externo
PERF	Informe de rendimiento de migración
TRACE	Estado de rutas de bajo nivel y monitoreo de carpetas
DEBUG	Información de depuración (cálculo de tamaño, verificación de directorios anidados)
WARN	Advertencias (datos de migración residuales, modo de recuperación)

Rotación de Registros

• Tamaño máximo predeterminado: 2 MB (configurable: 1 MB, 5 MB, 10 MB, 50 MB, 100 MB)
• Auto-truncamiento al exceder: Descarta la mitad más antigua de las líneas, mantiene la mitad más nueva

Exportar Paquete de Diagnóstico

Cuando surgen problemas que requieren retroalimentación, por favor exporte un paquete de diagnóstico y adjúntelo al Issue.

Métodos de Exportación

Método 1: Barra de Menú

1. Haga clic en Barra de menú → Registros → Exportar Paquete de Diagnóstico
2. Elija la ubicación de guardado
3. El sistema genera automáticamente un archivo .zip y lo abre en Finder

Método 2: Página de Configuración

1. Abra AppPorts → Configuración (esquina superior derecha)
2. Encuentre la sección "Configuración de Registro"
3. Haga clic en el botón "Exportar Paquete de Diagnóstico"
4. Elija la ubicación de guardado

Contenido del Paquete de Diagnóstico

El AppPorts-Diagnostic-<datetime>.zip exportado contiene:

Archivo	Formato	Descripción
diagnostic-summary.json	JSON	Metadatos (ID de sesión, versión, configuración regional, zona horaria, etc.)
diagnostic-summary.txt	Texto plano	Resumen de diagnóstico legible
recent-operations.json	JSON	Los 100 registros de operaciones más recientes
recent-failures.json	JSON	Las 20 operaciones fallidas/con advertencia más recientes
AppPorts_Log.share-safe.txt	Texto plano	Registro completo (censurado)

Protección de Privacidad

Los archivos de registro en el paquete de diagnóstico están censurados:

Contenido Original	Reemplazado Con
Ruta del directorio home del usuario (ej., /Users/john)	/Users/<redacted-user>
Nombre del volumen de almacenamiento externo (ej., /Volumes/MyDrive)	/Volumes/<redacted-volume>
Ruta completa de $HOME	~

Enviar Issues

Después de obtener el paquete de diagnóstico, siga estos pasos para enviar:

1. Visite la página de Issues del proyecto
2. Haga clic en "New Issue", seleccione la plantilla de reporte de Bug
3. Describa el problema y los pasos de reproducción
4. Arrastre el archivo .zip de diagnóstico al área de adjuntos para subir
5. Envíe el Issue

💡 Mejorar la Eficiencia de Retroalimentación

Enviar Issues con paquetes de diagnóstico puede acelerar significativamente la resolución de problemas. El paquete de diagnóstico contiene el historial completo de operaciones, detalles de errores e información del entorno del sistema, permitiendo a los desarrolladores reproducir y analizar problemas sin comunicación repetida.