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 monitorear el proceso de actualización, resolver problemas y comprender 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 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 - 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 (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

Calendario de fechas para filtrar registros

Configuraciones rápidas

1. - Seleccionar rangos de tiempo comunes: Últimas 1h, 3h, 6h o 12h Filtrar por rango de fechas
2. Hora de Inicio - Establece un tiempo de inicio personalizado para el rango
3. Hora 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 de fechas.

Filtrar por Tipo de Acción

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

Filtro de Acciones

Disponibles filtros de acciones incluyen:

• Pulso 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 reemplaza la versión de paquete incorporada
• Instalación de versión exitosa - Instalación exitosa de paquete
• Nueva versión enviada al dispositivo - Cuando Capgo envía una actualización a un dispositivo
• Instalación de versión fallida - Cuando falla la instalación del paquete

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)

Fecha y hora (UTC)	ID de dispositivo	Acción	Versión	¿Qué le 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 manifestos; 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	Zip terminó descargándose
2025-01-14 10:00:13	A1B2C3	set	2.4.1	Bundle instalado y marcado 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	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 reales que muestran viajes de actualización de dispositivos:

Flujo de actualización exitoso

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

Tiempo	ID del 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ó la versión 1.2.0 de información
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 versión más reciente:

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 se deshace:

Tiempo	ID de 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 ha llamado - se ha activado el rollback
11:15:11	i9j0k1l2	reset	integrado	Dispositivo reversionado a la versión integrada

Acción necesaria: Verifica que tu aplicación llame notifyAppReady() después de una inicialización exitosa. Consulta la documentación del plugin para 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	Descarga fallida (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 o se reinicie el ciclo de facturación

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

Configuración de canal Bloqueando Actualizaciones

Cuando los ajustes de canal impiden una actualización:

Hora	ID de dispositivo	Acción	Versión	¿Qué significa?
12:00:00	u1v2w3x4	disableAutoUpdateToMajor	2.0.0	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	Detectado emulador, y el canal bloquea emuladores
12:10:00	c9d0e1f2	disableDevBuild	1.2.0	Detectado build de desarrollo, y el canal bloquea builds de desarrollo

Acción necesariaEstos son protecciones intencionales. Si deseas permitir estas actualizaciones, modifica tus configuraciones 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 validado contra esta lista

Ciclo de vida y camino feliz

Code(s)	Significado
get	El dispositivo solicitó a Capgo el manifiesto de canal actual
download_manifest_start, download_manifest_complete	Comenzó/terminó la descarga del manifiesto (para deltas o conjuntos de archivos múltiples)
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 conjunto de archivos completo
set	El conjunto de archivos se ha preparado para la próxima ejecución
reset	El dispositivo se ha reversionado al conjunto de archivos incorporado
delete	El conjunto de archivos se ha eliminado de la memoria caché
uninstall	Detectada 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 fueron registrados por SDK
ping	Verificación de salud/pulso del dispositivo
setChannel, getChannel	SDK se ha sobrescrito o se ha recuperado mediante una llamada a SDK

Nueva política de bloqueo/tarifa rápida de solución

Code	¿Por qué sucede esto?	¿Qué hacer a continuación?
invalidIp	Capgo ha detectado tráfico que parece ser de bots (direcciones IP de Google/infraestructura en la nube).	Ignorar en usuarios reales; intentar de nuevo desde dispositivos reales y redes normales, o verificar después de algún tiempo.
needPlanUpgrade	La organización ha alcanzado el límite de plan/dispositivo.	Actualice el plan en la consola o espere 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 (semver)x.y.z).	Establecer plugins.CapacitorUpdater.version a una versión válida de semver, luego verifíquelo en el prueba de SemVer y reconstruya 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 intencionalmente bloqueó iOS en este track, manténgalo apagado y mueva 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 intencionalmente bloqueó Android en este track, manténgalo apagado y mueva las compilaciones de Android a un canal separado.
disableAutoUpdate	El modo de actualización automática del canal bloquea este estilo de actualización.	Cambie 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íe una versión a o por encima de la base de línea nativa, o desactive esa protección sub-nativa.
disableAutoUpdateMetadata	El canal requiere min_update_version metadata 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 mayores en la misma estrategia de canal, o permite saltos de versión mayor para este seguimiento.
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 seguimiento.
disableAutoUpdateToPatch	El canal bloquea saltos de nivel de parche para este flujo.	Alinea tu ritmo de lanzamiento, o abre saltos de parche en la política de canal para este seguimiento.
disableEmulator	No se permiten actualizaciones de emulador 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	Los builds de desarrollo están bloqueados para este canal.	Si esto fue accidental, permite actualizaciones de desarrollo o mueve este dispositivo a un canal habilitado para desarrollo. Si esto es intencional, mantén este canal bloqueado solo para builds de lanzamiento.
disableProdBuild	Un dispositivo con un build en modo de producción llamado /updates, mientras tu canal lo bloqueó.	Si 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 builds de producción al canal/build correcto.
cannotGetBundle	Capgo no pudo construir una URL de descarga válida para el paquete seleccionado.	Vuelve a subir el paquete o regenera los manifiestos y verifica los ajustes de R2/public bundle.
cannotUpdateViaPrivateChannel	La aplicación intentó cambiar a un canal privado que no permite auto-asignación.	Habilita 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).	Rellene la configuración faltante para esa regla o cambie a un modo de actualización automática más simple.
missingBundle	La rama no tiene contenido descargable (falta external_url/r2_path Reconstruya/vuelva a subir la versión y verifique que la rama tenga contenido de archivo real.	No se encontró ningún canal que coincida con este dispositivo (no hay un valor por defecto de la nube + no hay una configuración de fallback + no hay una sobrescritura).
NoChannelOrOverride	Establezca un valor por defecto de canal en la consola o mantenga una prueba	Demasiadas llamadas de actualización/canal en un corto período de tiempo (a menudo defaultChannel Detenga las llamadas en el bucle de renderizado. Solo llame a la acción del usuario. Use
rateLimited	Las IDs de clave de cifrado de la aplicación y la rama difieren ( setChannel/getChannel).	vs defaultChannel vs capacitor.config.
keyMismatch	vsdevice_key_id vs bundle_key_id).	In la consola, compara las IDs de clave de dispositivo y paquete. Si difieren, publica con la misma clave y versión de plugin CLI que coincida; la codificación de clave puede diferir entre versiones.
disableDevice	Un teléfono/tableta real fue bloqueado porque este canal está configurado para bloquear dispositivos reales.	Si fue accidental, activa las actualizaciones de dispositivos reales en ese canal. Si fue intencional, manténlo bloqueado y envía dispositivos reales a otro canal.
disablePlatformElectron	Electron está bloqueado en este canal.	Si esto fue accidental, habilita Electron en este canal y vuelve a publicar la ruta. Si fue intencional, manténlo bloqueado y envía 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.	Desactiva la envío de IDs personalizados o habilita 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 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 v4que el backend ya no acepta.	Actualice el plugin/CLI a v5(+ preferir v8), con Capacitor v5+, luego reconstruya y vuelva a publicar los metadatos del paquete.
bloques de configuración o políticas

Code(s)	¿Por qué la actualización fue bloqueada?
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative	La estrategia de canal prohíbe esto salto de semver
disablePlatformIos, disablePlatformAndroid	La plataforma está deshabilitada en el canal
disableDevBuild, disableEmulator	No se permiten compilaciones de desarrollo o emuladores
disableProdBuild, disableDevice, disablePlatformElectron	Edificios de producción, dispositivos reales o Electron están bloqueados para este canal.
customIdBlocked	No se aceptan IDs de dispositivos personalizados para esta aplicación.
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured	Falló la selección o sobrescritura de 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	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 de respuesta)
download_manifest_file_fail, download_manifest_checksum_fail, download_manifest_brotli_fail	El archivo de manifiesto no se pudo recuperar o validar
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 descomprimir falló
decrypt_fail	La descifrado falló (paquete cifrado)
update_fail	El paquete se instaló pero la aplicación nunca llamó notifyAppReady(); se desencadenó el rollback
download_zip_* con no eventos posteriores 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	Eventos de caída desde capas de tiempo de ejecución o de plataforma de JavaScript o nativo. El metadatos a menudo incluye información de pila, fuente y versión activa.
app_anr	Android informó que la aplicación no responde.
app_killed_low_memory, app_killed_excessive_resource_usage	La terminación del proceso de la aplicación se debió 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 de la 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. Instale Sentry en ambos capas de JS y nativa para capturar rastros de pila, contexto de sesión/dispositivo y URL/estado 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 versión de plataforma de la ejecución del paquete web.

➡️ ¿Necesita orientación más profunda 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 lo llevará a la página del dispositivo. Esto le 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 la consola y las operaciones de API API Overview Resumen de API para obtener detalles de implementación en Resumen de __CAPGO_KEEP_0__ Introducción API Keys Claves de API para obtener detalles de implementación en Claves de __CAPGO_KEEP_0__ para el detalle de implementación en Dispositivos, y Paquetes para el detalle de implementación en Paquetes.