Registros

Registros y Log Insights

La aplicación Registros La pestaña se abre Log Insights 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 subpestaña cuando necesite los eventos del dispositivo subyacentes, filtros y fechas de timestamp descritos a continuación.

Entendiendo los Registros de Aplicación

La subpestaña de Registros brinda una historia detallada de eventos de actualización y información diagnóstica para su aplicación. Es útil para confirmar la evidencia del nivel de dispositivo detrás de una Insight, para depurar un camino de actualización y para comprender cómo los dispositivos interactúan con Capgo. Abra una aplicación, elija Registros, luego elija la Registros subpestaña.

Pestaña de Registros en bruto

La interfaz de registros brutos incluye:

1. Subtítulo 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 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 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. Configuraciones rápidas - Seleccionar rangos de tiempo comunes: Últimas 1h, 3h, 6h o 12h
2. Fecha 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 que ha elegido, o “Cancelar” para descartar el selector de fechas.

Filtrar por Tipo de Acción

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

Filtro de Acciones

Los filtros de acción disponibles incluyen:

• Pulso 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 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 muestra (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 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	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	Bundle instalado y marcado como el siguiente para ejecutar
2025-01-14 10:05:00	B9C8D7	disableAutoUpdateToMajor	1.9.0	La política del 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 entender 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 parece 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 realiza una revisión pero ya tiene la última versión:

Tiempo	ID de dispositivo	Acción	Versión	¿Qué significa esto?
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 retroceso

Cuando una actualización falla y el dispositivo vuelve a su versión anterior:

Tiempo	ID de 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	La descarga se completó
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	__CAPGO_KEEP_0__	El dispositivo se reversionó a la versión incorporada

Acción necesaria: Verifica que tu aplicación llame notifyAppReady() después de una inicialización exitosa. Consulta la documentación del plugin para 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	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 dispositivos:

Hora	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: Actualiza tu plan o espera 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 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 ves un nuevo code en la IU, fue emitido por el SDK o backend y se validó contra esta lista.

Ciclo de vida y camino feliz

Code(s)	Significado
get	El dispositivo solicitó Capgo para el manifiesto de canal actual
download_manifest_start, download_manifest_complete	Se inició/terminó la descarga del manifiesto (para deltas o paquetes multi-archivo)
download_zip_start, download_zip_complete	Se inició/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	Se descargó el conjunto de recursos completo
set	El conjunto de recursos se preparó para el próximo arranque
reset	El dispositivo se reemplazó con el conjunto de recursos incorporado
delete	El conjunto de recursos se eliminó de la memoria local
uninstall	Se detectó la desinstalación de la aplicación
app_moved_to_foreground, app_moved_to_background	Se registraron los eventos de ciclo de vida de la aplicación por SDK
ping	Verificación de salud/rasgo cardíaco desde el dispositivo
setChannel, getChannel	El canal se ha sobrescrito o se ha recuperado mediante una llamada SDK

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

Code	¿Por qué sucede esto?	¿Qué hacer a continuación?
invalidIp	Capgo detectó tráfico que parece ser de bots (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/dispositivo.	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 desactivado 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 desactivado 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 más antiguas que la base del dispositivo.	Envía una versión a o por encima de la base nativa, o deshabilita esa protección sub-nativa.
disableAutoUpdateMetadata	El canal requiere min_update_version __CAPGO_KEEP_0__ 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.	Mantenga las versiones principales en la misma estrategia de canal, o permita saltos de versión mayor para este track.
disableAutoUpdateToMinor	El canal bloquea saltos de versión menor.	Mantenga las versiones menores en la misma estrategia de canal, o permita saltos de versión menor para este track.
disableAutoUpdateToPatch	Los saltos de nivel de parche están bloqueados para este flujo.	Alinee su ritmo de lanzamiento, o abra saltos de parche en la política de canal para este track.
disableEmulator	Las actualizaciones del emulador no están permitidas para este canal.	Si esto fue accidental, active las actualizaciones del emulador en un canal de prueba donde valide los emuladores. Si es intencional, mantenga este canal bloqueado para emuladores y utilice 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 bloqueaba.	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 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 la asignación de sí mismo.	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 paqueta no tiene contenido descargable (falta external_url/r2_path Reconstruya/vuelva a subir la versión y verifique que la paqueta tenga contenido de archivo real.	No se encontró ningún canal que coincida con este dispositivo (no hay configuración de nube predeterminada + no hay configuración de fallback + no hay sobrescritura).
NoChannelOrOverride	Establezca una configuración de canal predeterminada en la consola o mantenga una prueba	en esa construcción. defaultChannel Se realizaron 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 paqueta difieren ( capacitor.config.
keyMismatch	vsdevice_key_id En la consola, compare las IDs de clave del dispositivo y la paqueta. Si difieren, publique con la misma clave y versión de plugin coincidente; la codificación de 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	Un teléfono/tableta real fue bloqueado 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 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 mantenga los payloads de actualización locales.
backend_refusal	El actualizador es v4, que ya no acepta el servidor.	Actualice el plugin/CLI a v5+ (prever v8), con Capacitor v5+, luego reconstruya y vuelva a publicar los metadatos del paquete.
Bloqueos de configuración o 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	Los builds de desarrollo o emuladores no están permitidos
disableProdBuild, disableDevice, disablePlatformElectron	Los builds de producción, dispositivos reales o Electron están bloqueados para este canal.
customIdBlocked	No se aceptan IDs de dispositivo 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

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 faltan sumas de verificación
unzip_fail, directory_path_fail, canonical_path_fail, windows_path_fail	Falló la validación del sistema de archivos o descompresión
decrypt_fail	Falló la desifrado (paquete cifrado)
update_fail	Paquete instalado pero la aplicación nunca se llamó notifyAppReady(); se desencadenó un rollback
download_zip_* sin eventos posteriores set	Se terminó 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 falla desde capas de tiempo de ejecución o de JavaScript. El metadatos a menudo incluye pila, fuente y versión activa.
app_anr	Se informó a Android que una aplicación no respondía.
app_killed_low_memory, app_killed_excessive_resource_usage	El proceso de la aplicación se terminó debido a límites de memoria o recursos.
app_initialization_failure, app_memory_warning	Se interrumpió el arranque 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	Vida del ciclo de la vista de navegador y errores de JS/rendezaje. Instale Sentry en capas JS y nativas 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 aplicación nativa; esto ayuda a separar los efectos de la versión de plataforma de la conducta del paquete de la web.

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

Obtener más detalles sobre un registro

Si hace clic en una entrada de registro específica, generalmente lo llevará a la página del dispositivo. Esto le 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 actualización.

Siga adelante desde Registros

Si está utilizando Registros para planificar la consola de dashboard y API operaciones, 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 los detalles de implementación en API Claves, Dispositivos para los detalles de implementación en Dispositivos, y Paquetes para los detalles de implementación en Paquetes.