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 haciendo clic en tu aplicación y luego haciendo clic en la pestaña “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 Registro - 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 - Filtrar 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 la versión (paquete o builtin)

Haga clic en una fila para saltar a la página de detalles del dispositivo para obtener la historia completa.

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. Configuraciones rápidas - 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. Tiempo de Fin - Establece un tiempo de fin personalizado para el rango
4. Calendario - Selecciona fechas específicas utilizando la vista del calendario

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

Filtrado por Tipo de Acción

El menú 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 desde dispositivos
• Solicitud de eliminación de versión - Cuando una versión de paquete se elimina
• Restablecer a la versión predeterminada - Cuando un dispositivo vuelve a la versión de paquete incorporada
• Instalación de versión exitosa - 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 del dispositivo	Acción	Versión	¿Qué te dice?
2025-01-14 10:00:01	A1B2C3	get	2.4.1	El dispositivo preguntó Capgo si hay actualizaciones disponibles
2025-01-14 10:00:03	A1B2C3	download_manifest_start	2.4.1	Se inició la descarga 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 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 reiniciar

Ejemplos de escenarios de registro

Para ayudarte a comprender qué te dicen los registros, aquí tienes secuencias de ejemplo que muestran viajes de actualización reales de dispositivos:

Flujo de actualización exitoso

Esto es lo que una actualización saludable se ve en tus registros:

Tiempo	ID de dispositivo	Acción	Versión	¿Qué significa?
10:00:01	a1b2c3d4	get	1.2.0	El dispositivo ha revisado las actualizaciones y recibido 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	La descarga finalizó con éxito
10:00:06	a1b2c3d4	set	1.2.0	Se instaló y activó el paquete

El dispositivo ya está actualizado

Cuando un dispositivo revisa 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 versión anterior:

Tiempo	ID del dispositivo	Acción	Versión	¿Qué significa
11:15:00	i9j0k1l2	get	1.3.0	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	Paquete configurado
11:15:10	i9j0k1l2	update_fail	1.3.0	La aplicación se ha caído o notifyAppReady() no se llamó - se activó el rollback
11:15:11	i9j0k1l2	reset	builtin	El dispositivo se ha reversionado a la versión incorporada

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	La descarga comenzó 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: La dispositivo se volverá a intentar automáticamente en la próxima apertura de la aplicación. No se requiere ninguna acción a menos que esto suceda con frecuencia.

Límite de Plan Creado

Cuando su cuenta alcance su límite de dispositivo:

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

Acción necesaria: Actualice su plan __CAPGO_KEEP_0__.

Bloqueo de actualizaciones 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	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 compilación de desarrollo, y el canal bloquea compilaciones de desarrollo

Acción necesaria: Estos son protecciones intencionales. Si deseas permitir estas actualizaciones, modifica tus Configuración del canal.

Códigos de registro (Capgo enum de backend)

Estos códigos provienen del stats_action enum utilizado por la consola API (capgo/src/types/supabase.types.ts). Si ves 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	Descarga de manifiesto comenzó/terminó (para deltas o paquetes multiarchivo)
download_zip_start, download_zip_complete	Descarga de archivo ZIP comenzó/terminó
download_10 … download_90	Milestones de progreso de descarga
download_complete	Todo el paquete descargado
set	Paquete preparado para el próximo arranque
reset	Dispositivo reversionado a paquete incorporado
delete	Paquete eliminado de almacenamiento local
uninstall	Deteción de desinstalación de 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/pulso desde el dispositivo
setChannel, getChannel	Canal sobrescrito o recuperado mediante SDK llamada

Bloqueos de configuración o política

Code(s)	¿Por qué la actualización fue bloqueada?
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative	La estrategia de 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 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	No se pudo recuperar o validar el archivo de manifiesto
checksum_fail, checksum_required	Falló la comprobación de integridad o faltó el checksum
unzip_fail, directory_path_fail, canonical_path_fail, windows_path_fail	Falló la validación del sistema de archivos o la descomposición
decrypt_fail	Falló la descifrado (paquete cifrado)
update_fail	Se instaló el paquete pero nunca se llamó a la aplicación notifyAppReady(); se activó el rollback
download_zip_* sin una secuencia posterior set	Se completó la descarga pero nunca se completó la fase de instalación

¿Necesitas orientación más profunda para code? Consulta Guía de Referencia y Depuración de Logos Code.

Obtener más detalles sobre un registro

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 actualizaciones.