Registros

Entendiendo los registros de la aplicación

La página de registros proporciona una historia detallada de eventos de actualización y información diagnóstica para tu aplicación. Esto es crucial para monitorear el proceso de actualización, resolver problemas y entender cómo tus dispositivos interactúan con Capgo. Puedes acceder a ella por haciendo clic en tu aplicación y luego haciendo clic en la pestaña "Logs" (anteriormente denominada "actualizaciones" en algunas capturas de pantalla o documentación más antiguas).

Desde allí deberías ver una página similar a esta, que muestra una lista de entradas de registro:

Resumen de la Página de Registros

La interfaz de la página de registros incluye:

1. Pestaña de Registros - La pestaña de navegación para acceder a la vista de registros
2. Botón de Recargar - Refrescar la lista de registros con los datos más recientes
3. Filtros de Rango de Tiempo y Acciones - Filtre los registros por rango de fechas y tipo de acción (consulte las secciones a continuación)

Cada fila muestra:

• Fecha de timestamp (UTC)
• ID de dispositivo
• Acción code (qué sucedió)
• Nombre de la versión (paquete o builtin)

Haga clic en una fila para saltar a la página de detalles del dispositivo para ver el historial completo.

Filtrar por rango de fechas

Puede filtrar los registros por un período de tiempo específico utilizando el calendario de fechas:

Filtro de rango de fechas

1. Predefinidos rápidos - Seleccione rangos de tiempo comunes: los últimos 1h, 3h, 6h o 12h
2. Hora de inicio - Establezca una hora de inicio personalizada para el rango
3. Hora de fin - Establezca una hora de fin personalizada para el rango
4. Calendario - Elija fechas específicas utilizando la vista del calendario

Haga clic en “Seleccionar” para aplicar el rango de fechas elegido, o en “Cancelar” para descartar el calendario.

Filtrado por Tipo de Acción

El menú Desarrollo de Acciones te permite filtrar los registros por tipos de eventos específicos:

Filtro de Acciones

Los filtros de acción disponibles incluyen:

• Latido del dispositivo - Verificaciones de salud periódicas de los dispositivos
• Solicitud de eliminación de versión - Cuando una versión de paquete es eliminada
• Restablecer a la versión predeterminada - Cuando un dispositivo reemplaza la versión de paquete por defecto
• Versión instalada con éxito - Instalación de paquete exitosa
• Nueva versión enviada al dispositivo - Cuando Capgo envía una actualización a un dispositivo
• Instalación de versión fallida - Cuando la instalación de paquete falla

Utilice la caja de búsqueda en la parte superior para encontrar rápidamente tipos de acciones específicas. Puede seleccionar múltiples acciones para mostrar registros que coincidan con cualquiera de los tipos seleccionados.

Fragmento de registro de muestra (datos falsos)

Hora (UTC)	ID del dispositivo	Acción	Versión	¿Qué te dice
2025-01-14 10:00:01	A1B2C3	get	2.4.1	El dispositivo preguntó a Capgo si hay una actualización disponible
2025-01-14 10:00:03	A1B2C3	download_manifest_start	2.4.1	Se inició la carga del manifiesto; SDK está a punto de descargar archivos
2025-01-14 10:00:07	A1B2C3	download_40	2.4.1	La descarga del paquete está completa al 40%
2025-01-14 10:00:12	A1B2C3	download_zip_complete	2.4.1	Se terminó la descarga del archivo Zip
2025-01-14 10:00:13	A1B2C3	set	2.4.1	Se instaló el paquete y se marcó como el siguiente para ejecutar
2025-01-14 10:05:00	B9C8D7	disableAutoUpdateToMajor	1.9.0	La política de canal impidió un salto a 2.x
2025-01-14 10:05:05	B9C8D7	rateLimited	integrado	El dispositivo alcanzó el límite de solicitudes; SDK se detiene hasta reiniciar

Escenarios de registro de ejemplo

Para ayudarlo a entender qué le dicen los registros, aquí hay secuencias de ejemplo que muestran viajes de actualización de dispositivos reales:

Flujo de Actualización Exitosa

Esto es cómo se ve una actualización saludable en sus registros:

Tiempo	ID de dispositivo	Acción	Versión	¿Qué significa?
10:00:01	a1b2c3d4	get	1.2.0	El dispositivo verificó actualizaciones y recibió información de versión 1.2.0
10:00:02	a1b2c3d4	download_10	1.2.0	Se inició la descarga, 10% completado
10:00:03	a1b2c3d4	download_50	1.2.0	Descarga en 50%
10:00:05	a1b2c3d4	download_complete	1.2.0	Descarga finalizada con éxito
10:00:06	a1b2c3d4	set	1.2.0	Paquete instalado y activado

Dispositivo ya está actualizado

Cuando un dispositivo verifica pero ya tiene la última versión:

Tiempo	ID del dispositivo	Acción	Versión	¿Qué significa
14:30:00	e5f6g7h8	noNew	1.2.0	El dispositivo ya está en la última versión, no es necesario actualizar

Actualización fallida con rollback

Cuando una actualización falla y el dispositivo vuelve a su estado anterior:

Tiempo	ID del dispositivo	Acción	Versión	¿Qué significa
11:15:00	i9j0k1l2	get	1.3.0	El dispositivo recibió información de actualización
11:15:02	i9j0k1l2	download_complete	1.3.0	Se completó la descarga
11:15:03	i9j0k1l2	set	1.3.0	Se estableció el paquete
11:15:10	i9j0k1l2	update_fail	1.3.0	La aplicación se cayó o notifyAppReady() no se llamó - se activó la devolución a estado anterior
11:15:11	i9j0k1l2	reset	versión incorporada	El dispositivo se ha reversionado a la versión incorporada

Acción necesaria: Verifica que tu aplicación invoque notifyAppReady() después de una inicialización exitosa. Consulta la documentación del plugin para obtener más detalles.

Fallo de descarga

Cuando problemas de red impiden la descarga:

Tiempo	ID del dispositivo	Acción	Versión	¿Qué significa
09:45:00	m3n4o5p6	get	1.2.0	El dispositivo recibió información de actualización
09:45:01	m3n4o5p6	download_30	1.2.0	Se inició la descarga, pero…
09:45:15	m3n4o5p6	download_fail	1.2.0	La descarga falló (tiempo de espera de red, conexión perdida, etc.)

Acción necesaria: El dispositivo volverá a intentarlo automáticamente al lanzar la aplicación nuevamente. No se requiere acción a menos que esto suceda con frecuencia.

Límite de plan alcanzado

Cuando tu cuenta alcance su límite de dispositivos:

Tiempo	ID de dispositivo	Acción	Versión	¿Qué significa esto?
16:00:00	q7r8s9t0	needPlanUpgrade	-	Este dispositivo no recibirá actualizaciones hasta que actualice o se reinicie el ciclo de facturación

Acción necesaria: Actualice su plan o espere al próximo ciclo de facturación

Bloqueo de actualizaciones en la configuración de canal

Cuando los ajustes de canal impiden una actualización:

Tiempo	ID de dispositivo	Acción	Versión	¿Qué significa
12:00:00	u1v2w3x4	disableAutoUpdateToMajor	2.0.0	Los dispositivos en v1.x no pueden actualizarse automáticamente a v2.x (saltos de versión mayor bloqueados)
12:05:00	y5z6a7b8	disableEmulator	1.2.0	Detectado emulador, y el canal bloquea emuladores
12:10:00	c9d0e1f2	disableDevBuild	1.2.0	Detectado compilación de desarrollo, y el canal bloquea compilaciones de desarrollo

Acción necesariaEstos son protecciones intencionales. Si desea permitir estas actualizaciones, modifique los ajustes de su canales de configuración.

Códigos de registro (Capgo enum de backend)

Estos códigos provienen de la stats_action enum utilizada por la consola de administración API (capgo/src/types/supabase.types.ts). Si ve un nuevo code en la IU, fue emitido por el SDK o backend y validado contra esta lista.

Ruta feliz y ciclo de vida

Code(s)	Significado
get	El dispositivo solicitó Capgo el manifiesto de canal actual
download_manifest_start, download_manifest_complete	Comenzó/terminó la descarga del manifiesto (para deltas o paquetes de varios archivos)
download_zip_start, download_zip_complete	Comenzó/terminó la descarga del archivo ZIP
download_10 … download_90	Milestones de progreso de descarga
download_complete	Se descargó todo el paquete
set	El paquete se ha preparado para el lanzamiento siguiente
reset	El dispositivo se ha reversionado a la caché interna
delete	La caché se ha eliminado de almacenamiento local
uninstall	Se ha detectado la desinstalación de la aplicación
app_moved_to_foreground, app_moved_to_background	Los eventos de ciclo de vida de la aplicación están registrados por SDK
ping	Verificación de salud/latido de corazón desde el dispositivo
setChannel, getChannel	El canal se ha sobrescrito o se ha recuperado mediante la llamada SDK

La configuración o la política bloquea

Code(s)	¿Por qué se bloqueó la actualización?
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative	La estrategia del canal prohíbe este salto de semver
disablePlatformIos, disablePlatformAndroid	La plataforma está deshabilitada en el canal
disableDevBuild, disableEmulator	No se permiten compilaciones de desarrollo o emuladores
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured	Falló la selección o sobrescritura del canal
missingBundle, cannotGetBundle	El manifiesto se refiere a un paquete Capgo que no puede servir
needPlanUpgrade	La organización alcanzó su límite de planos/dispositivos
rateLimited	Se recibieron demasiadas solicitudes; SDK ralentiza hasta reiniciar
blocked_by_server_url, backend_refusal, InvalidIp	La regla del lado del servidor bloqueó la solicitud

Fallas de descarga / integridad / instalación

Code(s)	Significado
download_fail	Falló la descarga del paquete (error de red o respuesta)
download_manifest_file_fail, download_manifest_checksum_fail, download_manifest_brotli_fail	No se pudo recuperar o validar el archivo de manifiesto
checksum_fail, checksum_required	Falló la comprobación de integridad o faltaba el checksum
unzip_fail, directory_path_fail, canonical_path_fail, windows_path_fail	Falló la validación del sistema de archivos o descomprimir
decrypt_fail	La desifrado falló (paquete cifrado)
update_fail	El paquete se instaló pero la aplicación nunca se llamó notifyAppReady(); se desencadenó el rollback
download_zip_* sin ninguna secuencia posterior set	Se completó la descarga pero nunca se completó la fase de instalación

➡️ ¿Necesita más orientación en profundidad sobre code? Consulte Guía de Referencia y Depuración de Log completo Code.

Obtener más detalles sobre un Log

Si hace clic en una entrada de registro específica, generalmente le llevará a la página del dispositivo. Esto le permite ver el historial completo para ese dispositivo en particular, lo que puede ser muy útil para diagnosticar problemas específicos del dispositivo o comprender su recorrido de actualización.