Registros

Registros y Percepción de Registros

La aplicación Registros abre la pestaña Insights de Registro 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 de dispositivo subyacentes, filtros y fechas de timestamp descritos a continuación.

Entendiendo los Registros de la Aplicación

La pestaña Registros proporciona una historia detallada de eventos de actualización y información diagnóstica para tu aplicación. Es útil para confirmar la evidencia de 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, seleccione RegistrosEntonces, elija el Registros subtab.

Registro de Logs

Pestaña Registros en bruto

1. Logs subtab El control de navegación para filas de registro individuales.
2. — el control de navegación para filas de registro individuales. Actualiza la lista de registros con los datos más recientes.
3. Rango de tiempo y filtros de acción Filtros de rango de tiempo y acción

Cada fila muestra:

• Timestamp (UTC)
• ID de dispositivo
• Acción code (qué sucedió)
• Nombre de la versión (paquete o builtin)

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

Filtrado por rango de fechas

Puede filtrar los registros por un período de tiempo específico utilizando el calendario de fechas:

Filtro de fecha

1. Preestablecidos rápidos - Selecciona rangos de tiempo comunes: Últimas 1h, 3h, 6h o 12h
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 - Selecciona fechas específicas utilizando la vista de calendario

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

Filtrar por tipo de acción

La lista 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 se elimina una versión de paquete
• Reestablecer a la versión predeterminada - Cuando un dispositivo regresa a la versión predeterminada
• 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
• 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 de dispositivo	Acción	Versión	¿Qué te dice
2025-01-14 10:00:01	A1B2C3	get	2.4.1	Device asked Capgo if an update is available
2025-01-14 10:00:03	A1B2C3	download_manifest_start	2.4.1	Se inició la descarga delta; SDK está a punto de descargar los archivos delta modificados
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	Paquete 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 comprender qué te dicen los registros, aquí tienes secuencias de ejemplo que muestran viajes de actualización de dispositivos reales:

Flujo de Actualización Exitosa

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

Fecha y Hora	ID de Dispositivo	Acción	Versión	¿Qué significa?
10:00:01	a1b2c3d4	get	1.2.0	Dispositivo verificado para 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	Descarga finalizada con éxito
10:00:06	a1b2c3d4	set	1.2.0	Paquete instalado y activado

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

When an update fails and the device rolls back:

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	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	App crashó o notifyAppReady() No se llamó - se desencadenó un rollback
11:15:11	i9j0k1l2	reset	built-in	El dispositivo se ha reversionado a la versión incorporada

Acción necesaria: Verifica que tu aplicación invoque notifyAppReady() después de una inicialización exitosa. Consulta 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	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 necesariaLa dispositivo intentará de nuevo automáticamente al lanzar la próxima aplicación. No es necesario realizar ninguna acción a menos que esto suceda con frecuencia.

Límite de plan alcanzado

Cuando tu cuenta alcance su límite de dispositivos:

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

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	Dispositivo en v1.x no puede actualizarse 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	Dev build detected, and channel blocks dev builds

Acción necesariaEstas son protecciones intencionales. Si desea permitir estas actualizaciones, modifique los ajustes de canal.

Códigos de registro (Capgo enum de backend)

Estos códigos provienen de stats_action enum utilizado por la consola API (capgo/src/types/supabase.types.tsSi ve un nuevo code en la interfaz de usuario, fue emitido por el SDK o backend y validado contra esta lista.

Happy path & lifecycle

Code(s)	Significado
get	El dispositivo solicitó Capgo el paquete vinculado a su canal
download_manifest_start, download_manifest_complete	Comenzó o terminó la descarga delta (para paquetes subidos con archivos delta)
download_zip_start, download_zip_complete	Comenzó o terminó la descarga de 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ó todo el paquete
set	El paquete se preparó para la próxima ejecución
reset	Dispositivo reversionado a la paquete de la plataforma.
delete	Paquete eliminado de almacenamiento local
uninstall	Se detectó la desinstalación de la aplicación
app_moved_to_foreground, app_moved_to_background	App lifecycle events recorded by SDK
ping	Verificación de salud/ratazón desde el dispositivo
setChannel, getChannel	Canal sobrescrito o recuperado mediante la llamada a SDK.

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

Code	¿Por qué sucede esto?	¿Qué hacer a continuación?
invalidIp	Capgo se detectó tráfico que parece ser de bots (IP de Google/infraestructura en la nube).	Ignora a los usuarios reales; vuelve a intentarlo desde dispositivos 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	La versión nativa de la aplicación en la configuración está faltando o no es válida (x.y.z).	Establecer plugins.CapacitorUpdater.version valido para semver, luego verifíquelo en el SemVer tester Verificador de SemVer
disablePlatformIos	y reconstruye la aplicación.	If this was accidental, enable iOS in that channel and republish routing. If you intentionally block iOS in this track, keep it off and move iOS builds to a separate channel.
disablePlatformAndroid	Android está deshabilitado en la política de canal.	If this was accidental, enable Android in that channel and republish routing. If you intentionally block Android in this track, keep it off and move Android builds to a separate channel.
disableAutoUpdate	Channel auto-update mode blocks this update style.	Cambie la política de actualización automática del canal (mayor/minor/patch/metadata/no) para permitir su lanzamiento previsto.
disableAutoUpdateUnderNative	El canal está configurado para bloquear actualizaciones anteriores a la base de dispositivo.	Envía una versión a partir de la base nativa del dispositivo, o desactiva la protección sub-nativa.
disableAutoUpdateMetadata	El canal requiere min_update_version metadata y la aplicación es más antigua.	Establece min_update_version para el paquete o versión de lanzamiento objetivo desde una versión nativa más reciente.
disableAutoUpdateToMajor	El canal bloquea saltos de versión mayor.	Mantenga las versiones principales en la misma estrategia de canal, o permita saltos principales para este track.
disableAutoUpdateToMinor	El canal bloquea los saltos de versión menor.	Mantenga las versiones menores en la misma estrategia de canal, o permita saltos menores para este track.
disableAutoUpdateToPatch	El canal bloquea los 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 track.
disableEmulator	No se permiten actualizaciones de emulador para este canal.	Si esto fue accidental, activa 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 builds 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 a builds de lanzamiento solo.
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	No se pudo construir una URL de descarga válida para el paquete seleccionado Capgo.	Vuelve a subir el paquete (con --delta si deseas archivos delta) 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 cambiar 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 hay archivos delta).	Reconstruya/vuelva a subir la versión y verifique que el paquete tenga contenido de archivo real.
NoChannelOrOverride	No channel matched this device (no cloud default + no config fallback + no override).	Establecer un canal por defecto en la consola o mantener una prueba defaultChannel en esa construcción.
rateLimited	Too many update/channel calls in a short time (often render-loop setChannel/getChannel).	No llamar en el renderizado. Llamar solo en acción del usuario. Utilice defaultChannel en capacitor.config.
keyMismatch	Las claves de cifrado de la aplicación y el paquete difierendevice_key_id vs 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 es accidental, activa las actualizaciones de dispositivos reales en ese canal. Si es intencional, manténlo bloqueado y dirige los 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éngalo 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 de dispositivo personalizados o habilite solo si su flujo de trabajo lo requiere.
blocked_by_server_url	La aplicación tiene server.url configurada, por lo que Capacitor sirve una URL remota en lugar de archivos locales.	Eliminar/clear server.url for production builds and keep update payloads local.
backend_refusal	El actualizador es v4que el backend ya no acepta.	Actualizar plugin/CLI a v5 (+ preferir v8), con Capacitor v5Reconstruye y vuelve a publicar los metadatos del paquete.
La configuración o política bloquea

Code(s)	Why el update fue bloqueado
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative	La estrategia del canal prohíbe esto salto de semver
disablePlatformIos, disablePlatformAndroid	La plataforma está deshabilitada en el canal
disableDevBuild, disableEmulator	No se permiten builds de desarrollo ni emuladores
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 del canal
missingBundle, cannotGetBundle	El canal apunta 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	Fallo al descargar el paquete (error de red o respuesta)
download_manifest_file_fail, download_manifest_checksum_fail, download_manifest_brotli_fail	No se pudo recuperar o validar un archivo delta
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	Validación de sistema de archivos o unzip fallida
decrypt_fail	La descifrado falló (paquete cifrado)
update_fail	Paquete instalado pero la aplicación nunca se llamó notifyAppReady(); se activó el rollback
download_zip_* sin una fase posterior set	La descarga terminó pero la fase de instalación nunca se completó

Eventos de tiempo de ejecución / plataforma

Code(s)	Significado
app_crash, app_crash_native	Eventos de crash desde capas de JavaScript o tiempo de ejecución nativo. La metadata a menudo incluye pila, fuente y versión activa.
app_anr	Android informó que la aplicación no respondía.
app_killed_low_memory, app_killed_excessive_resource_usage	El proceso de la aplicación terminó 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	La versión del sistema operativo o de la aplicación nativa cambió; esto ayuda a separar los efectos de la plataforma de los comportamientos de la paquete de la web.
os_version_changed, native_app_version_changed	OS or native app version changed; this helps separate platform-level rollout effects from web bundle behavior.

Guía completa de code y Referencia de Depuración Guía de Referencia y Depuración Completa del Registro Code.

Sección titulada “Obtener más detalles sobre un registro”

If 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 actualización.

Sigue adelante desde Registros

Si estás utilizando Registros planificar el panel de control y API operaciones, conectarlo con Resumen de API Para la información detallada de implementación en API Resumen. Introduction para los detalles de implementación en __CAPGO_KEEP_0__ Resumen, Claves API para el detalle de implementación en Claves API Dispositivos para el detalle de implementación en Dispositivos, y Paquetes para el detalle de implementación en Paquetes.