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 el monitoreo del proceso de actualización, el troubleshooting de problemas y la comprensión de cómo tus dispositivos interactúan con Capgo. Puedes acceder a ella por clickando en tu aplicación y luego clickando en la pestaña de “Registros” (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 Recarga - Refresque la lista de registros con los datos más recientes
3. Filtros de Rango de Tiempo y Acciones - Filtra registros por rango de fecha 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 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.

Rango de fechas

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

Filtro de rango de fechas

1. Preestablecidos rápidos - Seleccionar rangos de tiempo comunes: Últimas 1h, 3h, 6h o 12h
2. Hora de inicio - Establecer una hora de inicio personalizada para el rango
3. Hora de fin - Establecer una hora de fin personalizada para el rango
4. Calendario - Selecciona fechas específicas utilizando la vista del calendario

Haz clic en “Seleccionar” para aplicar tu rango de fechas elegido, o en “Cancelar” para descartar el selector.

Filtrar por Tipo de Acción

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

Filtro de Acciones

Entre los filtros de acción disponibles se encuentran:

• Latido del dispositivo - Verificaciones de salud periódicas de los dispositivos
• Solicitud de eliminación de versión - Cuando se elimina una versión de paquete
• Volver a la versión predeterminada - Cuando un dispositivo vuelve a la versión de paquete incorporada
• 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 ejemplo (datos falsos)

Hora (UTC)	ID de 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á 40% completa
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 bloqueó un salto a 2.x
2025-01-14 10:05:05	B9C8D7	rateLimited	integrado	El dispositivo alcanzó el límite de solicitudes; SDK se retira hasta el reinicio

Ejemplos de escenarios de registro

Para ayudarte a entender qué te dicen los registros, aquí tienes 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 tus registros:

Tiempo	ID de dispositivo	Acción	Versión	¿Qué significa
10:00:01	a1b2c3d4	get	1.2.0	El dispositivo comprobó actualizaciones y recibió la versión 1.2.0 info
10:00:02	a1b2c3d4	download_10	1.2.0	Descarga iniciada, 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	Bundle 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 versión más reciente, no es necesario actualizar

Actualización fallida con restauración

Cuando una actualización falla y el dispositivo se restaura:

Hora	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	Descarga completada
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 ha caído o notifyAppReady() no se ha llamado - se ha activado el rollback
11:15:11	i9j0k1l2	reset	integrado	El dispositivo se ha reversionado a la versión integrada

Acción necesaria: Verifique que su aplicación llame notifyAppReady() después de una inicialización exitosa. Consulte la documentación del plugin para obtener más detalles.

Fallo de descarga

Cuando problemas de red impiden la descarga:

Tiempo	ID de 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.

Se ha alcanzado el límite del plan

When your account reaches its device limit: __CAPGO_KEEP_0__

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

Acción necesaria: Actualiza tu plan o espera al próximo ciclo de facturación.

Configuración de canal bloqueando actualizaciones

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	Un dispositivo en v1.x no puede actualizar automáticamente a v2.x (saltos de versión mayor bloqueados)
12:05:00	y5z6a7b8	disableEmulator	1.2.0	Se detectó un emulador, y el canal bloquea emuladores
12:10:00	c9d0e1f2	disableDevBuild	1.2.0	Se detectó una construcción de desarrollo, y el canal bloquea construcciones de desarrollo

Acción necesaria: Estos son protecciones intencionales. Si desea permitir estas actualizaciones, modifique sus ajustes de canal.

Códigos de registro (Capgo backend enum)

Estos códigos provienen de stats_action el enum utilizado por la consola 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 & ciclo de vida

Code(s)	Significado
get	El dispositivo solicitó Capgo el manifiesto de canal actual
download_manifest_start, download_manifest_complete	El manifiesto de descarga comenzó / terminó (para delta o paquetes de archivos múltiples)
download_zip_start, download_zip_complete	La descarga de archivo ZIP comenzó / terminó
download_10 … download_90	Milestones de progreso de descarga
download_complete	Bundle completo descargado
set	Bundle preparado para la próxima ejecución
reset	Dispositivo reestablecido a la configuración de bundle predeterminada
delete	Bundle eliminado de almacenamiento local
uninstall	Deteción de desinstalación de la aplicación
app_moved_to_foreground, app_moved_to_background	Eventos de ciclo de vida de la aplicación registrados por SDK
ping	Verificación de salud/rastreo de corazón desde el dispositivo
setChannel, getChannel	Canal sobrescrito o recuperado mediante llamada a SDK

Configuración o política que bloquea

Code(s)	¿Por qué se bloqueó la actualización?
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative	Estrategia de canal prohíbe esto Saltos de semver
disablePlatformIos, disablePlatformAndroid	La plataforma está deshabilitada en el canal
disableDevBuild, disableEmulator	No se permiten construcciones de desarrollo o emuladores
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured	Falló la selección o sobrescritura de canal
missingBundle, cannotGetBundle	El manifiesto se refiere a un paquete Capgo no puede servir
needPlanUpgrade	La organización ha alcanzado su límite de planos/dispositivos
rateLimited	Demasiadas solicitudes; SDK ralentiza hasta reiniciar
blocked_by_server_url, backend_refusal, InvalidIp	Una 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	El archivo de manifiesto no pudo ser recuperado o validado
checksum_fail, checksum_required	La comprobación de integridad falló o faltaba el checksum
unzip_fail, directory_path_fail, canonical_path_fail, windows_path_fail	La validación del sistema de archivos o descompresión falló
decrypt_fail	La desifrado falló (paquete cifrado)
update_fail	El paquete se instaló pero la aplicación nunca se llamó notifyAppReady(); se activó el rollback
download_zip_* sin un posterior set	Se completó la descarga pero nunca se completó la fase de instalación

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

Obtener más detalles sobre un Log

Si haces clic en una entrada de registro específica, típicamente te llevará a la página del dispositivo. Esto te permite ver la historia completa 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.

Sigue adelante desde Registros

Si estás utilizando Registros para planificar tableros de mandos y operaciones de API , conecta con API Resumen para los detalles de implementación en API Resumen, Introducción para los detalles de implementación en Introducción, API Claves para el detalle de implementación en API Claves, Dispositivos para el detalle de implementación en Dispositivos, y Paquetes para el detalle de implementación en Paquetes.