Log

Capire i Log dell'Applicazione

La pagina dei Log fornisce una dettagliata storia degli eventi di aggiornamento e informazioni diagnostiche per la tua applicazione. Ciò è cruciale per monitorare il processo di aggiornamento, risolvere problemi e capire come i tuoi dispositivi interagiscono con Capgo. Puoi accedervi cliccando su il tuo app e poi cliccando sul pulsante “Log” (precedentemente denominato “aggiornamenti” in alcune schermate o documentazione più vecchie).

Dal lì dovresti vedere una pagina simile, che mostra una lista di voci di registro:

Panoramica della Pagina dei Log

L'interfaccia della pagina dei log include:

1. Tabella dei Log - Il pulsante di navigazione per accedere alla vista dei log
2. Pulsante di Ricarica - Aggiorna la lista dei log con i dati più recenti
3. Filtri di Intervallo di Tempo e Azioni - Filtra i log per intervallo di data e tipo di azione (vedi le sezioni di seguito)

Ogni riga mostra:

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

Clicca su una riga per saltare alla pagina dei dettagli del dispositivo per la storia completa.

Filtra per Intervallo di Data

Puoi filtrare i log per un periodo di tempo specifico utilizzando il calendario:

Filtro per Intervallo di Data

1. Preset Veloci - Seleziona intervalli di tempo comuni: Ultimi 1h, 3h, 6h o 12h
2. Ora di Inizio - Imposta un'ora di inizio personalizzata per l'intervallo
3. Ora di Fine - Imposta un'ora di fine personalizzata per l'intervallo
4. Calendario - Seleziona date specifiche utilizzando la vista del calendario

Seleziona "Seleziona" per applicare il intervallo di date scelto, o "Annulla" per dismettere il picker.

Filtra per Tipo di Azione

Il menu a discesa "Azioni" consente di filtrare i log per tipi di eventi specifici:

Filtra per Azioni

Sono disponibili i seguenti filtri per azioni:

• Ritmo cardiaco del dispositivo - Verifiche di salute periodiche da parte dei dispositivi
• Richiesta di cancellazione della versione - Quando una versione di bundle viene cancellata
• Riprista la versione predefinita - Quando un dispositivo torna alla bundle predefinita
• Versione installata con successo - Installazione bundle riuscita
• Nuova versione inviata al dispositivo - Quando Capgo invia un aggiornamento a un dispositivo
• Installazione versione fallita - Quando l'installazione della bundle fallisce

Utilizza la casella di ricerca in alto per trovare velocemente i tipi di azione specifici. Puoi selezionare più azioni per visualizzare i log che corrispondono a qualsiasi dei tipi selezionati.

Esempio di frammento di log (dati fittizi)

Ora (UTC)	ID del dispositivo	Azione	Versione	Cosa ti dice
2025-01-14 10:00:01	A1B2C3	get	2.4.1	Il dispositivo ha chiesto a Capgo se è disponibile un aggiornamento
2025-01-14 10:00:03	A1B2C3	download_manifest_start	2.4.1	E' stato avviato il recupero del manifesto; SDK sta per scaricare i file
2025-01-14 10:00:07	A1B2C3	download_40	2.4.1	La download del bundle è al 40%
2025-01-14 10:00:12	A1B2C3	download_zip_complete	2.4.1	Il zip è stato scaricato
2025-01-14 10:00:13	A1B2C3	set	2.4.1	Il bundle è stato installato e contrassegnato come prossimo da eseguire
2025-01-14 10:05:00	B9C8D7	disableAutoUpdateToMajor	1.9.0	La politica del canale ha bloccato un salto a 2.x
2025-01-14 10:05:05	B9C8D7	rateLimited	integrato	Il dispositivo ha raggiunto il limite delle richieste; SDK si ferma fino al riavvio

Esempi di Scenari di Registro

Per aiutarti a capire cosa i registri ti dicono, ecco sequenze di esempio che mostrano viaggi di aggiornamento reali del dispositivo:

Flusso di Aggiornamento Riuscito

Questo è come dovrebbe apparire un aggiornamento sano nei tuoi registri:

Tempo	ID del Dispositivo	Azione	Versione	Cosa significa
10:00:01	a1b2c3d4	get	1.2.0	Il dispositivo ha controllato le aggiornamenti e ricevuto la versione 1.2.0 info
10:00:02	a1b2c3d4	download_10	1.2.0	Scarica iniziata, 10% completato
10:00:03	a1b2c3d4	download_50	1.2.0	Scarica al 50%
10:00:05	a1b2c3d4	download_complete	1.2.0	Scarica completata con successo
10:00:06	a1b2c3d4	set	1.2.0	Bundle installato e attivato

Dispositivo già aggiornato

Quando un dispositivo controlla ma già ha la versione più recente:

Tempo	ID del dispositivo	Azione	Versione	Cosa significa
14:30:00	e5f6g7h8	noNew	1.2.0	Dispositivo già aggiornato, non è necessario un aggiornamento

Aggiornamento fallito con rollback

Quando un aggiornamento fallisce e il dispositivo torna indietro:

Tempo	ID dispositivo	Azione	Versione	Cosa significa
11:15:00	i9j0k1l2	get	1.3.0	Dispositivo riceve informazioni sull'aggiornamento
11:15:02	i9j0k1l2	download_complete	1.3.0	Download completato
11:15:03	i9j0k1l2	set	1.3.0	Bundle impostato
11:15:10	i9j0k1l2	update_fail	1.3.0	App è stato bloccato o non è stato chiamato - rollback attivato notifyAppReady() integrato
11:15:11	i9j0k1l2	reset	Dispositivo ripristinato alla versione integrata	Operazione necessaria

: Controlla che la tua app chiamidopo l'inizializzazione riuscita. Vedi notifyAppReady() la documentazione del plugin per i dettagli. Fallimento del download

Sezione intitolata “Fallimento del download”

Section titled “Download Failure” When network issues prevent the download:

Tempo	ID dispositivo	Azione	Versione	Cosa significa
09:45:00	m3n4o5p6	get	1.2.0	Il dispositivo ha ricevuto informazioni di aggiornamento
09:45:01	m3n4o5p6	download_30	1.2.0	Iniziato il download ma…
09:45:15	m3n4o5p6	download_fail	1.2.0	Fallito il download (timeout di rete, connessione persa, ecc.)

Azione necessaria: Il dispositivo si riproverà automaticamente alla prossima avviamento dell'app. Nessuna azione richiesta a meno che ciò accada frequentemente.

Limite del piano raggiunto

When il tuo account raggiunge il limite dei dispositivi:

Tempo	ID dispositivo	Azione	Versione	Cosa significa:
16:00:00	q7r8s9t0	needPlanUpgrade	-	Questo dispositivo non riceverà aggiornamenti fino a quando non aggiorni o il ciclo di fatturazione si riavvia

Azione necessaria: Aggiorna il tuo piano o aspetta il prossimo ciclo di fatturazione.

Configurazione del canale che blocca gli aggiornamenti

When impostazioni del canale impedono un aggiornamento:

Tempo	ID dispositivo	Azione	Versione	Cosa significa
12:00:00	u1v2w3x4	disableAutoUpdateToMajor	2.0.0	Un dispositivo su v1.x non può aggiornarsi automaticamente a v2.x (salto di versione maggiore bloccato)
12:05:00	y5z6a7b8	disableEmulator	1.2.0	Un emulatore è stato rilevato, e il canale blocca gli emulatori
12:10:00	c9d0e1f2	disableDevBuild	1.2.0	Un build di sviluppo è stato rilevato, e il canale blocca i build di sviluppo

Azione necessaria: Queste sono protezioni intenzionali. Se desideri consentire questi aggiornamenti, modifica le tue impostazioni del canale.

Log codici (Capgo backend enum)

Questi codici provengono dall' stats_action enum utilizzato dal dashboard API (capgo/src/types/supabase.types.ts). Se vedete un nuovo code nella UI, è stato emesso dal SDK o backend e validato contro questa lista.

Happy path & lifecycle

Code(s)	Significato
get	Dispositivo ha chiesto a Capgo il manifesto del canale corrente
download_manifest_start, download_manifest_complete	Manifesto di download iniziato / terminato (per delta o pacchetti multi-file)
download_zip_start, download_zip_complete	Download di archivio zip iniziato / terminato
download_10 … download_90	Migliaia di progresso del download
download_complete	Scarica interamente il bundle
set	Bundle pronto per il prossimo avvio
reset	Dispositivo ripristinato al bundle predefinito
delete	Bundle eliminato dalla memoria locale
uninstall	Detettato l'installazione dell'app
app_moved_to_foreground, app_moved_to_background	Eventi di ciclo di vita dell'app registrati da SDK
ping	Controllo di salute/heartbeat dal dispositivo
setChannel, getChannel	Canale sovrascritto o recuperato tramite SDK

Configurazioni o politiche bloccanti

Code(s)	Perché l'aggiornamento è stato bloccato
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative	La strategia del canale vieta questo salto semver
disablePlatformIos, disablePlatformAndroid	La piattaforma è disabilitata sul canale
disableDevBuild, disableEmulator	Costruzioni di sviluppo o emulatori non consentiti
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured	Fallito la selezione o sovrascrittura del canale
missingBundle, cannotGetBundle	La manifestazione si riferisce a un bundle Capgo non può servire
needPlanUpgrade	L'organizzazione ha raggiunto il limite di piano/dispositivo
rateLimited	Troppi richieste; SDK limita fino al riavvio
blocked_by_server_url, backend_refusal, InvalidIp	La regola del server ha bloccato la richiesta

Fallimenti di download / integrità / installazione

Code(s)	Significato
download_fail	Fallito il download del bundle (errore di rete o di risposta)
download_manifest_file_fail, download_manifest_checksum_fail, download_manifest_brotli_fail	Il file di manifesto non è stato recuperato o validato
checksum_fail, checksum_required	La verifica dell'integrità è fallita o manca il checksum
unzip_fail, directory_path_fail, canonical_path_fail, windows_path_fail	La verifica del sistema di file o dell'unzip è fallita
decrypt_fail	La decrittografia è fallita (bundle crittografato)
update_fail	Il bundle è stato installato ma l'app non l'ha mai chiamato notifyAppReady(); il rollback è stato attivato
download_zip_* senza alcun subsequente set	La download è terminata ma la fase di installazione non è mai stata completata

➡️ Hai bisogno di ulteriori indicazioni per il percorso code? Vedi Guida di riferimento e di debug per il Log Code completo.

Ottenere Maggiori Dettagli su un Log

If clicchi su una specifica voce di registro, ti porterà tipicamente alla pagina del dispositivo. pagina del dispositivoQuesto ti consente di vedere la storia completa per quel dispositivo specifico, che può essere molto utile per diagnosticare problemi specifici del dispositivo o comprendere il suo percorso di aggiornamento.

Continua da Logs

Se stai utilizzando Logs per pianificare dashboard e operazioni API , connettilo con API Overview per i dettagli di implementazione in API Overview, Introduzione per i dettagli di implementazione in Introduzione, API Chiavi per i dettagli di implementazione in API Chiavi, Dispositivi per i dettagli di implementazione in Dispositivi, e Pacchetti per i dettagli di implementazione in Pacchetti.