Vai al contenuto

Log

La scheda App Log si apre Analisi dei log di default. Usa Insights per dare priorità a categorie, versioni e dispositivi per periodi di 1, 3, 7 o 30 giorni. Passa alla Log sottoscheda quando ti servono gli eventi del dispositivo, i filtri e i timestamp descritti di seguito.

La sottopagine Logs grezzi fornisce una cronologia dettagliata degli eventi di aggiornamento e informazioni diagnostiche per la tua applicazione. È utile per confermare le prove a livello di dispositivo dietro un Insight, risolvere i problemi di un percorso di aggiornamento e capire come i dispositivi interagiscono con Capgo. Apri un'app, scegli Log, poi scegli la Log sottopagine.

Panoramica della scheda Logs grezzi che mostra l'interfaccia principale
Scheda Logs grezzi

L'interfaccia Logs grezzi include:

  1. Sottopulsante Logs — il controllo di navigazione per le righe di log individuali.
  2. Pulsante Ricarica — aggiorna l'elenco dei log con i dati più recenti.
  3. Filtri per intervallo di tempo e azione — restringe il flusso di eventi per tempo e azione.

Ogni riga mostra:

  • Timestamp (UTC)
  • ID dispositivo
  • Azione code (cosa è successo)
  • Nome versione (bundle o builtin)

Clicca su una riga per aprire la pagina di dettaglio del dispositivo con la sua cronologia completa.

Puoi filtrare i log per un periodo specifico usando il selettore di date:

Selettore di intervallo di date per filtrare i log
Filtro per intervallo di date
  1. Preset rapidi - Seleziona intervalli di tempo comuni: ultime 1h, 3h, 6h o 12h
  2. Ora di inizio - Imposta un'ora di inizio personalizzata per l'intervallo
  3. Ora di fine - Set a custom end time for the range
  4. Calendario - Seleziona date specifiche usando la vista calendario

Fai clic su “Seleziona” per applicare l'intervallo di date scelto, oppure su “Annulla” per chiudere il selettore.

Il menu a tendina Actions consente di filtrare i log per tipi di evento specifici:

Menu a tendina per filtrare i log per tipo di evento
Filtro Actions

I filtri di azione disponibili includono:

  • Heartbeat del dispositivo - Controlli periodici di salute dai dispositivi
  • Cancellazione versione richiesta - Quando una versione del bundle viene cancellata
  • Reset alla versione predefinita - Quando un dispositivo torna al bundle integrato
  • Versione installata con successo - Installazione bundle riuscita
  • Nuova versione inviata al dispositivo - Quando Capgo invia un aggiornamento a un dispositivo
  • Installazione versione non riuscita - Quando l'installazione del bundle fallisce

Usa la casella di ricerca in alto per trovare rapidamente tipi di azione specifici. Puoi selezionare più azioni per mostrare i log che corrispondono a uno qualsiasi dei tipi selezionati.

Ora (UTC)ID dispositivoAzioneVersioneCosa ti dice
2025-01-14 10:00:01A1B2C3get2.4.1Il device ha chiesto a Capgo se è disponibile un aggiornamento
2025-01-14 10:00:03A1B2C3download_manifest_start2.4.1Download delta avviato; SDK sta per scaricare i file delta modificati
2025-01-14 10:00:07A1B2C3download_402.4.1Download del bundle completato al 40%
2025-01-14 10:00:12A1B2C3download_zip_complete2.4.1Download dello zip terminato
2025-01-14 10:00:13A1B2C3set2.4.1Bundle installato e impostato come prossimo da eseguire
2025-01-14 10:05:00B9C8D7disableAutoUpdateToMajor1.9.0La policy del canale ha bloccato un salto a 2.x
2025-01-14 10:05:05B9C8D7rateLimitedintegrataLimite di richieste raggiunto per il dispositivo; SDK attende il riavvio

Per aiutarti a interpretare i log, ecco alcune sequenze che mostrano i percorsi di aggiornamento reali dei dispositivi:

Ecco come appare un aggiornamento andato a buon fine nei tuoi log:

OraID dispositivoAzioneVersioneCosa significa
10:00:01a1b2c3d4get1.2.0Dispositivo controllato per aggiornamenti, ricevute info versione 1.2.0
10:00:02a1b2c3d4download_101.2.0Download avviato, completato al 10%
10:00:03a1b2c3d4download_501.2.0Download al 50%
10:00:05a1b2c3d4download_complete1.2.0Download completato con successo
10:00:06a1b2c3d4set1.2.0Bundle installato e attivato

Quando un dispositivo effettua il controllo ma ha già l'ultima versione:

OraID dispositivoAzioneVersioneCosa significa
14:30:00e5f6g7h8noNew1.2.0Il dispositivo è già all'ultima versione, nessun aggiornamento necessario

Quando un aggiornamento fallisce e il dispositivo esegue il rollback:

OraID dispositivoAzioneVersioneCosa significa
11:15:00i9j0k1l2get1.3.0Il dispositivo ha ricevuto le info dell'update
11:15:02i9j0k1l2download_complete1.3.0Download completato
11:15:03i9j0k1l2set1.3.0Bundle impostato
11:15:10i9j0k1l2update_fail1.3.0L'app è andata in crash o notifyAppReady() non è stata chiamata - rollback avviato
11:15:11i9j0k1l2resetintegrataIl dispositivo è tornato alla versione integrata

Azione richiesta: Verifica che la tua app chiami notifyAppReady() dopo l'inizializzazione riuscita. Vedi la documentazione del plugin per i dettagli.

Quando i problemi di rete impediscono il download:

OraID dispositivoAzioneVersioneCosa significa
09:45:00m3n4o5p6get1.2.0Il dispositivo ha ricevuto le info dell'update
09:45:01m3n4o5p6download_301.2.0Download avviato ma...
09:45:15m3n4o5p6download_fail1.2.0Download fallito (timeout di rete, connessione persa, ecc.)

Azione richiesta: Il dispositivo riproverà automaticamente al prossimo avvio dell'app. Nessuna azione necessaria, a meno che non accada spesso.

Quando il tuo account raggiunge il limite di dispositivi:

OraID dispositivoAzioneVersioneCosa significa
16:00:00q7r8s9t0needPlanUpgrade-Questo dispositivo non riceverà aggiornamenti finché non esegui l'upgrade o il ciclo di fatturazione non si azzera

Azione richiesta: Esegui l'upgrade del piano o attendi il prossimo ciclo di fatturazione.

Configurazione del canale che blocca gli aggiornamenti

Sezione intitolata “Configurazione del canale che blocca gli update”

Quando le impostazioni del canale impediscono un update:

OraID dispositivoAzioneVersioneCosa significa
12:00:00u1v2w3x4disableAutoUpdateToMajor2.0.0Il dispositivo su v1.x non può auto-aggiornarsi a v2.x (salto di major version bloccato)
12:05:00y5z6a7b8disableEmulator1.2.0Emulatore rilevato e il canale blocca gli emulatori
12:10:00c9d0e1f2disableDevBuild1.2.0Dev build rilevata e il canale blocca le dev build

Azione richiesta: Si tratta di protezioni intenzionali. Se vuoi consentire questi update, modifica il tuo impostazioni canale.

Questi codici provengono dall' stats_action enum usato dalla dashboard API (capgo/src/types/supabase.types.ts). Se vedi un nuovo code nella UI, è stato emesso da SDK o dal backend e validato in base a questa lista.

Happy path & ciclo di vita

Code(s)Significato
getIl dispositivo ha richiesto a Capgo il bundle associato al suo canale
download_manifest_start, download_manifest_completeDownload delta iniziato / terminato (per bundle caricati con file delta)
download_zip_start, download_zip_completeDownload archivio Zip iniziato / terminato
download_10 … download_90Milestone del download
download_0Indicatore 0% per il primo evento di avanzamento
download_completeBundle scaricato interamente
setBundle pronto per il prossimo avvio
resetDispositivo tornato al bundle integrato
deleteBundle rimosso dallo storage locale
uninstallRilevata disinstallazione app
app_moved_to_foreground, app_moved_to_backgroundEventi lifecycle app registrati da SDK
pingHealth check/heartbeat dal dispositivo
setChannel, getChannelChannel sovrascritto o recuperato tramite chiamata SDK
CodePerché succedeCosa fare ora
invalidIpCapgo ha rilevato traffico che sembra provenire da bot (IP di Google/infrastruttura cloud).Ignora se riguarda utenti reali; riprova da dispositivi reali e reti normali, o controlla dopo un po'.
needPlanUpgradeOrganization reached plan/device limit.Aggiorna il piano nella dashboard o attendi il prossimo ciclo di fatturazione.
semver_errorLa versione dell'app nativa nella config manca o non è un semver valido (x.y.z).Imposta plugins.CapacitorUpdater.version a un semver valido, quindi verificalo nella tester SemVer e rifai la build dell'app.
disablePlatformIosiOS è disabilitato nella policy del canale.Se è successo per errore, abilita iOS in quel canale e ripubblica il routing. Se invece blocchi iOS di proposito in questo track, lascialo disabilitato e sposta le build iOS su un canale separato.
disablePlatformAndroidAndroid è disabilitato nella policy del canale.Se è successo per errore, abilita Android in quel canale e ripubblica il routing. Se invece blocchi Android di proposito in questo track, lascialo disabilitato e sposta le build Android su un canale separato.
disableAutoUpdateLa modalità auto-update del canale blocca questo tipo di update.Modifica la policy di auto-update del canale (major/minor/patch/metadata/none) per consentire il rollout desiderato.
disableAutoUpdateUnderNativeIl canale è impostato per bloccare gli update precedenti alla baseline del dispositivo.Pubblica una versione pari o superiore alla baseline nativa, oppure disabilita la protezione sulle versioni native precedenti.
disableAutoUpdateMetadataIl canale richiede min_update_version metadata e l'app è più vecchia.Imposta min_update_version per il bundle o la release target da una versione nativa più recente.
disableAutoUpdateToMajorIl canale blocca i salti di versione major.Mantieni le versioni major nella stessa strategia del canale, oppure consenti i salti major per questa track.
disableAutoUpdateToMinorIl canale blocca i salti di versione minor.Mantieni le versioni minor nella stessa strategia del canale, oppure consenti i salti minor per questa track.
disableAutoUpdateToPatchIl canale impedisce i salti di patch-level in questo flusso.Allinea il ritmo dei tuoi rilasci o abilita i patch jump nella policy del canale per questo track.
disableEmulatorGli aggiornamenti da emulatore non sono consentiti per questo canale.Se è stato un errore, abilita gli aggiornamenti da emulatore in un canale di test dove validi gli emulatori. Se è intenzionale, mantieni questo canale bloccato per gli emulatori e usa un altro canale per le build da emulatore.
disableDevBuildLe build dev sono bloccate per questo canale.Se è stato un errore, abilita gli aggiornamenti dev o sposta questo dispositivo su un canale abilitato per dev. Se è intenzionale, mantieni questo canale limitato alle sole build di release.
disableProdBuildUna build del dispositivo in modalità production chiamata /updates, mentre il tuo canale l'ha bloccata.Se è stato un errore, consenti gli aggiornamenti di produzione in quel channel e ripubblica. Se è intenzionale, mantieni la restrizione e invia i build di produzione al channel/build corretto.
cannotGetBundleCapgo non è riuscito a creare un URL di download valido per il bundle selezionato.Ricarica il bundle (con --delta se vuoi i file delta) e controlla le impostazioni del bundle R2/pubblico.
cannotUpdateViaPrivateChannelL'app ha tentato di passare a un channel privato che non consente l'auto-assegnazione.Abilita allow_device_self_set sul channel o passa a un channel pubblico/consentito.
channelMisconfiguredRegola di auto-aggiornamento del canale: dati obbligatori mancanti (version_number senza min_update_version).Completa la configurazione mancante per quella regola o passa a una modalità di auto-update più semplice.
missingBundleIl bundle non ha un payload scaricabile (mancante external_url/r2_path e nessun file delta).Ricostruisci/ri-carica la versione e verifica che il bundle contenga file reali.
NoChannelOrOverrideNessun canale corrisponde a questo dispositivo (nessun default cloud + nessun fallback config + nessun override).Imposta un canale predefinito nel dashboard o mantieni un test defaultChannel in quella build.
rateLimitedTroppe chiamate update/canale in poco tempo (spesso render-loop setChannel/getChannel).Smetti di chiamare nel render. Chiama solo su azione utente. Usa defaultChannel nella capacitor.config.
keyMismatchThe app and bundle encryption key IDs differ (device_key_id vs bundle_key_id).Nella console, confronta gli ID delle chiavi del dispositivo e del bundle. Se differiscono, pubblica con la stessa chiave e la versione corrispondente di CLI/plugin; la codifica della chiave può variare tra le versioni.
disableDeviceUn telefono/tablet reale è stato bloccato perché questo channel è configurato per bloccare i dispositivi reali.Se è un errore, attiva gli aggiornamenti su dispositivo reale in quel channel. Se è intenzionale, tienilo bloccato e indirizza i dispositivi reali a un altro channel.
disablePlatformElectronElectron è bloccato in questo channel.Se è un errore, abilita Electron in questo channel e ripubblica il routing. Se è intenzionale, tienilo bloccato e indirizza gli utenti Electron su un channel dedicato.
customIdBlockedÈ stato inviato un ID dispositivo personalizzato, ma questa app non accetta ID personalizzati.Disattiva l'invio di ID personalizzati o abilita gli ID personalizzati solo se il tuo workflow lo richiede.
blocked_by_server_urlL'app ha server.url configurato, quindi Capacitor serve l'URL remoto invece dei file locali.Rimuovi/svuota server.url per le build di produzione e mantenere i payload degli update locali.
backend_refusalL'updater è v4, che il backend non accetta più.Aggiorna il plugin/CLI a v5+ (preferisci v8), con Capacitor v5+, quindi ricostruisci e ripubblica i metadati del bundle.
Blocchi di configurazione o policy
Code(s)Perché l'update è stato bloccato
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNativeLa strategia del channel lo vieta salto semver
disablePlatformIos, disablePlatformAndroidLa piattaforma è disabilitata sul channel
disableDevBuild, disableEmulatorBuild di dev o emulatori non consentiti
disableProdBuild, disableDevice, disablePlatformElectronBuild di produzione, dispositivi reali o Electron sono bloccati per questo channel.
customIdBlockedI device ID personalizzati non sono accettati per questa app.
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfiguredSelezione o override del channel fallito
missingBundle, cannotGetBundleIl canale punta a un bundle che Capgo non può fornire
needPlanUpgradeL'org ha raggiunto il limite di piano/dispositivi

Errori di download, integrità o installazione

Code(s)Significato
download_failDownload del bundle non riuscito (errore di rete o di risposta)
download_manifest_file_fail, download_manifest_checksum_fail, download_manifest_brotli_failImpossibile recuperare o validare un file delta
checksum_fail, checksum_requiredControllo di integrità non riuscito o checksum mancante
unzip_fail, directory_path_fail, canonical_path_fail, windows_path_failValidazione del file system o di unzip non riuscita
decrypt_failDecrittazione non riuscita (bundle crittografato)
update_failBundle installato ma l'app non ha mai fatto la chiamata notifyAppReady(); rollback attivato
download_zip_* senza eventi successivi setDownload completato ma fase di installazione mai terminata
Code(s)Significato
app_crash, app_crash_nativeEventi di crash dai layer JavaScript o runtime nativi. I metadati includono spesso stack, sorgente e informazioni sulla versione attiva.
app_anrAndroid ha segnalato un Application Not Responding.
app_killed_low_memory, app_killed_excessive_resource_usageTerminazione del processo dell'app a causa di limiti di memoria o risorse.
app_initialization_failure, app_memory_warningAvvio interrotto o pressione di memoria rilevata prima dell'esecuzione normale.
webview_javascript_error, webview_unhandled_rejection, webview_resource_error, webview_security_policy_violation, webview_unclean_restart, webview_render_process_gone, webview_content_process_terminatedCiclo di vita della WebView ed errori JS/rendering. Installa Sentry sia nel layer JS che in quello nativo per catturare stack trace, contesto di sessione/dispositivo e URL/stato per correzioni più rapide.
os_version_changed, native_app_version_changedVersione OS o app nativa modificata; utile a distinguere gli effetti del rollout a livello di piattaforma dal comportamento del web bundle.

➡️ Serve una guida più dettagliata per code? Consulta Riferimento completo ai log Code e guida alla debug.

Se fai clic su una voce di log specifica, di solito verrai reindirizzato alla pagina del dispositivo. Questo ti consente di visualizzare l'intero storico per quel dispositivo specifico, il che può essere molto utile per diagnosticare problemi specifici del dispositivo o per comprenderne il percorso di aggiornamento.

Se stai usando Log per pianificare le operazioni della dashboard e di API, collegalo a Panoramica API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli di implementazione in Introduzione, Chiavi API per i dettagli di implementazione delle chiavi API, Dispositivi per i dettagli di implementazione in Devices, e Bundle per il dettaglio di implementazione in Bundles.