Registros

Registros y Log Insights

La aplicación Registros abre la pestaña Insights de Log por defecto. Utilice Insights para priorizar categorías, versiones y dispositivos durante un período de 1, 3, 7 o 30 días. Cambie a la Registros contexto: Página/área: Capgo Builder / página de producto de compilación nativa en la nube. Rol: Etiqueta de UI corta o elemento de navegación. Visto en: página native-build.astro. Clave de mensaje `native_build_v2_trust_logs_lbl` (Native Build V2 Trust Logs Lbl).

subpestaña cuando necesite los eventos de dispositivo subyacentes, filtros y fechas de timestamp descritos a continuación.

The raw Logs subtab provides a detailed history of update events and diagnostic information for your application. It is useful for confirming the device-level evidence behind an Insight, troubleshooting an update path, and understanding how devices interact with Capgo. Open an app, choose La pestaña de Registros proporciona una historia detallada de eventos de actualización y información diagnóstica para su aplicación. Es útil para confirmar la evidencia de nivel de dispositivo detrás de un Insight, para depurar un camino de actualización y para comprender cómo los dispositivos interactúan con __CAPGO_KEEP_0__. Abra una aplicación, elijaRegistros contexto: Página/área: Capgo Builder / página de producto de compilación nativa en la nube. Rol: Etiqueta de UI corta o elemento de navegación. Visto en: página native-build.astro. Clave de mensaje `native_build_v2_trust_logs_lbl` (Native Build V2 Trust Logs Lbl). , luego elija la pestaña de ‘Registros’.

Pestaña de registros brutos

La interfaz de registros brutos incluye:

1. Subpestaña de registros — el control de navegación para filas de registros individuales.
2. Botón de recarga — refresca la lista de registros con los datos más recientes.
3. Filtros de rango de tiempo y acción — estrecha el flujo de eventos por tiempo y acción.

Cada fila muestra:

• Fecha de tiempo (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 su 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. Preestablecidos rápidos - Seleccionar rangos de tiempo comunes: Última hora, 3 horas, 6 horas o 12 horas
2. Hora de Inicio - Establecer un tiempo de inicio personalizado para el rango
3. Hora de Fin - Establecer un tiempo de fin personalizado para el rango
4. Calendario - Seleccionar 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ú Desarrollar Acciones te permite filtrar los registros por tipos de eventos específicos:

Acciones Filtro

Las acciones de filtro disponibles incluyen:

• Latido del dispositivo - Verificaciones de salud periódicas de los dispositivos
• Eliminación de versión solicitada - Cuando una versión de paquete es eliminada
• Restablecer 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
• Falló la instalación de la versión - 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 ejemplo (datos falsos)

Hora (UTC)	ID del 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 una actualización disponible
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	Descarga de paquete es del 40% completo
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	Se ha instalado el paquete y se ha marcado 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 ha alcanzado el límite de solicitudes; SDK se detiene 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 cómo se ve una actualización saludable 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 info
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 verifica pero ya tiene la versión más reciente:

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

: Verifica que tu aplicación llame a: Verifica que tu aplicación llame a 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:

Hora	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	Comenzó 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 siguiente arranque 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	-	This device won’t receive updates until you upgrade or the billing cycle resets

Necesario una acción: 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	Se detectó emulador, y el canal bloquea emuladores
12:10:00	c9d0e1f2	disableDevBuild	1.2.0	Se detectó compilación de desarrollo, y el canal bloquea compilaciones de desarrollo

Acción necesaria: Estos son protecciones intencionales. Si desea permitir estas actualizaciones, modifique los ajustes 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 ve un nuevo code en la interfaz de usuario, 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	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	Marcadores de progreso de descarga
download_0	0% del marcador de progreso para el primer evento de progreso
download_complete	Se descargó todo el conjunto de archivos
set	El conjunto de archivos se preparó para la próxima ejecución
reset	El dispositivo se reversionó al conjunto de archivos incorporado
delete	Se eliminó el conjunto de archivos 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/rastreo de latido desde el dispositivo
setChannel, getChannel	Canal sobrescrito o recuperado mediante SDK llamada

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

Code	¿Por qué sucede esto?	¿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 alcanzó el límite de plan/dispositivo.	Actualiza el plan en la consola o espera al próximo ciclo de facturación.
semver_error	Versión de la aplicación nativa en la configuración está faltando o no es válida semver (x.y.z).	Establecer plugins.CapacitorUpdater.version a semver válido, luego verifique 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 bloqueó intencionalmente iOS en este track, manténgalo desactivado 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 bloqueó intencionalmente Android en este track, manténgalo desactivado 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 más antiguas que la base del dispositivo.	Envíe una versión a partir de la base nativa o desactive la protección bajo-nativa.
disableAutoUpdateMetadata	Requiere el canal min_update_version El canal requiere	metadata y la aplicación es más antigua. min_update_version Establecer
disableAutoUpdateToMajor	para el paquete o versión de destino desde una versión nativa más nueva.	El canal bloquea saltos de versión mayor.
disableAutoUpdateToMinor	Mantenga las versiones principales en la misma estrategia de canal, o permita saltos de versión mayor para este track.	El canal bloquea saltos de versión menor.
disableAutoUpdateToPatch	Mantenga las versiones menores en la misma estrategia de canal, o permita saltos de versión menor para este track.	El canal bloquea saltos de nivel de parche para este flujo.
disableEmulator	Alinee su ritmo de lanzamiento, o abra saltos de parche en la política de canal para este track.	If esto fue accidental, enciende las actualizaciones del emulador en un canal de prueba donde validas emuladores. Si es intencional, mantén este canal bloqueado para emuladores y utiliza otro canal para construir emuladores.
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 a solo builds de lanzamiento.
disableProdBuild	Un build de dispositivo en modo de producción llamado /updates, mientras que 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 manifestos y verifica los ajustes de paquete R2/public.
cannotUpdateViaPrivateChannel	La aplicación intentó cambiar a un canal privado que no permite autoasignació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	El paquete no tiene contenido descargable (falta external_url/r2_path y no tiene un manifiesto).	Reconstruya/vuelva a subir la versión y verifique que el paquete tenga contenido de archivo real.
NoChannelOrOverride	No se encontró ningún canal que coincida con este dispositivo (no hay un valor por defecto de nube + no hay una configuración de fallback + no hay una sobrescritura).	Establezca un valor por defecto de canal en la consola o mantenga una prueba defaultChannel en esa construcción.
rateLimited	Se están realizando demasiadas llamadas de actualización/canal en un corto período de tiempo (a menudo en el bucle de renderizado) setChannel/getChannel).	Detenga las llamadas en el renderizado. Solo llame a la acción del usuario. Utilice defaultChannel en capacitor.config.
keyMismatch	Las IDs de clave de cifrado de la aplicación y el paquete difieren (device_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 coincidente CLI; 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 tu flujo de trabajo lo requiere.
blocked_by_server_url	La aplicación tiene server.url configurado, por lo que Capacitor sirve una URL remota en lugar de archivos locales.	Eliminar/limpiar server.url para ediciones de producción y mantener los payloads de actualización locales.
backend_refusal	El actualizador es v4, que el backend ya no acepta.	Actualizar el plugin/CLI a v5+ (preferir 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 del canal prohíbe esto Saltar semver
disablePlatformIos, disablePlatformAndroid	La plataforma está deshabilitada en el canal
disableDevBuild, disableEmulator	Edificios de desarrollo o emuladores no están permitidos
disableProdBuild, disableDevice, disablePlatformElectron	Los 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 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 plan/dispositivo

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	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	Fallido la validación del sistema de archivos o descomprimir
decrypt_fail	Fallido la descifrado (paquete cifrado)
update_fail	Se instaló el paquete pero nunca se llamó la aplicación notifyAppReady(); se desencadenó el rollback
download_zip_* sin ninguna 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	Eventos de caída desde capas de tiempo de ejecución JavaScript o nativo. 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 de JavaScript. Instale Sentry en capas de JavaScript y nativas 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	El sistema operativo o la versión nativa del aplicativo cambió; esto ayuda a separar los efectos de la plataforma de los cambios en el paquete de la web.

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

Obtener más detalles sobre un registro

Si haces clic en una entrada de registro específica, generalmente 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 to plan dashboard and API operations, connect it with API Overview for the implementation detail in API Overview, Introducción para obtener detalles de implementación en Introducción API Keys for the implementation detail in API Keys, Dispositivos para obtener detalles de implementación en Dispositivos Paquetes para los detalles de implementación en Paquetes.