Registros

Entendiendo los registros de la aplicación

La página de registros proporciona un historial detallado 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, la resolución de problemas y la comprensión de 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

Página de registros: incluye:

1. Opción de registros - La pestaña de navegación para acceder a la vista de registros
2. Botón de recarga - Refrescar la lista de registros con los datos más recientes
3. Filtros de fecha y acciones - Filtrar registros por rango de fecha y tipo de acción (consulte las secciones a continuación)

Cada fila muestra:

• Hora de registro (UTC)
• ID del dispositivo
• Acción code Lo que 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. Configuraciones rápidas - Selecciona rangos de tiempo comunes: últimos 1h, 3h, 6h o 12h
2. Hora de inicio - Establezca un tiempo de inicio personalizado para el rango
3. Fecha de Fin - Establezca un tiempo de fin personalizado para el rango
4. Calendario - Seleccione 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.

Filtrar por Tipo de Acción

El menú de acciones le 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 se elimina una versión de paquete
• Restablecer a la versión predeterminada - Cuando un dispositivo reemplaza el paquete incorporado
• 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 de 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 de archivos; 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 ha terminado la descarga del archivo Zip
2025-01-14 10:00:13	A1B2C3	set	2.4.1	Instalación de paquete y marcada como próxima a 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	builtin	El dispositivo alcanzó el límite de solicitudes; SDK se retira hasta reiniciar

Escenarios de registro de ejemplo

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 se ha revisado para obtener actualizaciones y recibió información de versión 1.2.0
10:00:02	a1b2c3d4	download_10	1.2.0	Se ha iniciado 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 ha instalado y activado el paquete

El dispositivo ya está actualizado

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

Tiempo	ID de 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 de dispositivo	Acción	Versión	What it means
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 estrelló o notifyAppReady() no se llamó - se activó el rollback
11:15:11	i9j0k1l2	reset	integrado	El dispositivo se reversionó 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 detalles.

Descarga Fallida

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: La dispositivo se volverá a intentar automáticamente en la próxima apertura de la aplicación. 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 dispositivo:

Tiempo	ID de dispositivo	Acción	Versión	¿Qué significa?
16:00:00	q7r8s9t0	needPlanUpgrade	-	Este dispositivo no recibirá actualizaciones hasta que subas de versión 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 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 las compilaciones de desarrollo

Acción necesaria: Estos son protecciones intencionales. Si deseas permitir estas actualizaciones, modifica tus configuración de 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 se validó contra esta lista.

Flujo feliz & ciclo de vida

Code(s)	Significado
get	Dispositivo solicitó Capgo para el manifiesto de canal actual
download_manifest_start, download_manifest_complete	Comenzó/terminó la descarga del manifiesto (para deltas o paquetes multiarchivo)
download_zip_start, download_zip_complete	Comenzó/terminó la descarga del archivo ZIP
download_10 … download_90	Milestones de progreso de descarga
download_0	Marcador de progreso del 0% para el primer evento de progreso
download_complete	Descargado el paquete completo
set	Paquete preparado para la próxima ejecución
reset	Dispositivo reversionado a paquete incorporado
delete	Paquete eliminado de almacenamiento local
uninstall	Detectada la 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/ratificación de corazón desde dispositivo
setChannel, getChannel	El canal se ha sobrescrito o se ha recuperado mediante una llamada a SDK

Solución rápida para bloqueos de políticas / ralentizadores nuevos

Code	¿Por qué esto sucede?	¿Qué hacer a continuación?
invalidIp	Capgo detectó tráfico que parece ser de bots (direcciones IP de Google/infraestructura en la nube).	Ignorar en usuarios reales; reintenta desde dispositivos reales y redes normales, o verifica después de un tiempo.
needPlanUpgrade	La organización ha alcanzado el límite de plano/dispositivos.	Actualiza el plan en la consola o espera al próximo ciclo de facturación.
semver_error	La versión nativa de la aplicación en la configuración no está presente o no es válida (x.y.z).	Configura plugins.CapacitorUpdater.version a semver válido, luego verifíquelo en el Prueba de SemVer y reconstruye la aplicación.
disablePlatformIos	iOS está deshabilitado en la política de canal.	Si esto fue accidental, habilite iOS en ese canal y vuelva a publicar la ruta. Si bloqueaste intencionalmente iOS en este track, manténlo fuera y mueve las compilaciones de iOS a un canal separado.
disablePlatformAndroid	Android está deshabilitado en la política de canal.	Si esto fue accidental, habilite Android en ese canal y vuelva a publicar la ruta. Si bloqueaste intencionalmente Android en este track, manténlo fuera y mueve las compilaciones de Android a un canal separado.
disableAutoUpdate	El modo de actualización automática del canal bloquea este estilo de actualización.	Cambia la política de actualización automática del canal (mayor/minor/patch/metadata/nothing) para permitir tu lanzamiento previsto.
disableAutoUpdateUnderNative	El canal está configurado para bloquear actualizaciones anteriores a la base de línea del dispositivo.	Envía una versión a o por encima de la base de línea nativa, o deshabilite esa protección sub-nativa.
disableAutoUpdateMetadata	El canal requiere min_update_version metadatos y la aplicación es más antigua.	Establecer min_update_version para el paquete objetivo o versión de lanzamiento desde una versión nativa más nueva.
disableAutoUpdateToMajor	El canal bloquea saltos de versión mayor.	Mantén las versiones principales en la misma estrategia de canal, o permite saltos de versión mayor para este track.
disableAutoUpdateToMinor	El canal bloquea saltos de versión menor.	Mantén las versiones menores en la misma estrategia de canal, o permite saltos de versión menor para este track.
disableAutoUpdateToPatch	Los saltos de nivel de parche están bloqueados para este flujo.	Alinea tu ritmo de lanzamiento, o abre saltos de parche en la política de canal para este track.
disableEmulator	Las actualizaciones de emulador no están permitidas para este canal.	Si esto fue accidental, enciende las actualizaciones de emulador en un canal de prueba donde validas emuladores. Si es intencional, mantén este canal bloqueado para emuladores y utiliza otro canal para ediciones de emulador.
disableDevBuild	Las ediciones de desarrollo están bloqueadas para este canal.	If esto fue accidental, permite actualizaciones de dev o mueve este dispositivo a un canal habilitado para dev. Si esto es intencional, mantén este canal bloqueado solo para versiones de lanzamiento.
disableProdBuild	Un dispositivo construido en modo de producción llamado /updates, mientras su canal lo bloqueó.	If esto fue accidental, permite actualizaciones de producción en ese canal y vuelve a publicar. Si esto es intencional, mantén la restricción y envía versiones de producción al canal/construcción adecuado.
cannotGetBundle	Capgo no pudo construir una URL de descarga válida para el paquete seleccionado.	Vuelve a subir el paquete o regenera manifestos y verifica la configuración del paquete R2/public.
cannotUpdateViaPrivateChannel	La aplicación intentó cambiar a un canal privado que no permite auto-asignación.	Habilitar allow_device_self_set en el canal o cambia a un canal público/permitido.
channelMisconfigured	La regla de actualización automática del canal falta datos requeridos (version_number sin min_update_version).	Rellena la configuración faltante para esa regla o cambia a un modo de actualización automática más simple.
missingBundle	La compilación no tiene contenido de archivo descargable (falta external_url/r2_path Reconstruya/suba de nuevo la versión y verifique que la compilación tenga contenido de archivo real.	No se ha encontrado ningún canal que coincida con este dispositivo (no hay un valor por defecto de nube + no hay un valor por defecto de configuración + no hay un valor de sobrecarga).
NoChannelOrOverride	Establezca un valor por defecto de canal en la consola o mantenga una prueba	en esa compilación. defaultChannel Se han realizado demasiadas llamadas de actualización/canal en un corto período de tiempo (a menudo en el bucle de renderizado
rateLimited	Detenga las llamadas en el bucle de renderizado. Llame solo en acción del usuario. Use setChannel/getChannel).	en defaultChannel Las IDs de clave de la aplicación y la compilación difieren ( capacitor.config.
keyMismatch	vsdevice_key_id En la consola, compare las IDs de clave del dispositivo y la compilación. Si difieren, publique con la misma clave y la versión del plugin __CAPGO_KEEP_0__ que coincida; la codificación de la clave puede diferir entre versiones. bundle_key_id).	In the console, compare device and bundle key IDs. If they differ, publish with the same key and matching CLI/plugin version; key encoding can differ between versions.
disableDevice	A un teléfono/tableta real se le impidió funcionar porque este canal está configurado para bloquear dispositivos reales.	Si fue accidental, active las actualizaciones de dispositivos reales en ese canal. Si fue intencional, manténlo bloqueado y envía a dispositivos reales a otro canal.
disablePlatformElectron	Electron está bloqueado en este canal.	Si esto fue accidental, habilite Electron en este canal y vuelva a publicar la ruta. Si fue intencional, manténlo bloqueado y envíe a los usuarios de Electron a un canal dedicado.
customIdBlocked	Se envió un ID de dispositivo personalizado, pero esta aplicación no acepta IDs personalizados.	Desactive la envío de IDs personalizados o habilite solo los IDs personalizados si su flujo de trabajo lo requiere.
blocked_by_server_url	La aplicación está server.url configurada, por lo que Capacitor sirve una URL remota en lugar de archivos locales.	Eliminar/limpiar server.url para ediciones de producción y mantén los paquetes de actualización locales.
backend_refusal	El actualizador es v4, que el backend ya no acepta.	Actualice el plugin/CLI a v5+ (prever v8), con Capacitor v5+, luego reconstruya y vuelva a publicar los metadatos del paquete.
Configuración o bloque de políticas

Code(s)	¿Por qué se bloqueó la actualización?
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative	La estrategia de canal prohíbe esto Saltar semver
disablePlatformIos, disablePlatformAndroid	La plataforma está deshabilitada en el canal
disableDevBuild, disableEmulator	No se permiten construcciones de desarrollo o emuladores
disableProdBuild, disableDevice, disablePlatformElectron	Las construcciones de producción, dispositivos reales o Electron están bloqueados para este canal.
customIdBlocked	Los IDs de dispositivo personalizados no se aceptan para esta aplicación.
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured	Falló la selección o sobrescritura de canal
missingBundle, cannotGetBundle	El manifiesto se refiere a un conjunto de paquetes 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 conjunto de paquetes (error de red o de 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	El sistema de archivos o la validación de descomprimir 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_* con ningún evento posterior set	Se completó la descarga pero nunca se completó la fase de instalación

Eventos de tiempo de ejecución / plataforma

Code(s)	Significado
app_crash, app_crash_native	Los eventos de caída desde capas de tiempo de ejecución o nativas de JavaScript. El metadatos a menudo incluye pila, fuente y versión activa.
app_anr	Android informó que la aplicación no respondió.
app_killed_low_memory, app_killed_excessive_resource_usage	El proceso de la aplicación se detuvo debido a límites de memoria o recursos.
app_initialization_failure, app_memory_warning	El arranque se interrumpió o se observó presión de memoria antes del tiempo de ejecución normal.
webview_javascript_error, webview_unhandled_rejection, webview_resource_error, webview_security_policy_violation, webview_unclean_restart, webview_render_process_gone, webview_content_process_terminated	Errores de ciclo de vida de WebView y de renderizado/JS. Instale Sentry en ambos capas de JS y nativa para capturar rastros de pila, contexto de sesión/dispositivo y estado de URL para solucionar problemas más rápido.
os_version_changed, native_app_version_changed	Se cambió la versión del sistema operativo o de la aplicación nativa; esto ayuda a separar los efectos de la plataforma de los cambios en el paquete de la aplicación web.

➡️ ¿Necesitas más orientación sobre el code? Consulta Guía de Referencia y Depuración de Registros Code Completa.

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 el historial completo para ese dispositivo en particular, lo que puede ser muy útil para diagnosticar problemas específicos del dispositivo o entender su recorrido de actualizaciones.

Sigue adelante desde Registros

Si estás utilizando Registros para planificar la consola de dashboard y las operaciones de API API Overview API Resumen para obtener detalles de implementación en __CAPGO_KEEP_0__ Resumen Introducción API Keys API Claves para obtener detalles de implementación en __CAPGO_KEEP_0__ Claves Dispositivos para obtener detalles de implementación en Dispositivos Paquetes para el detalle de implementación en Paquetes.