Log

Capire i Log dell'Applicazione

La pagina dei Log fornisce una dettagliata storia degli eventi di aggiornamento e informazioni diagnostici 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 sul tuo app e poi cliccando sul pulsante “Log” (precedentemente denominato “aggiornamenti” in alcune schermate o documentazione più vecchie) Cliccando sul tuo app e poi Cliccando sul pulsante “Log” (precedentemente denominato “aggiornamenti” in alcune schermate o documentazione più vecchie).

Dalla pagina dei Log dovresti vedere una pagina simile a questa, che mostra una lista di voci di registro:

Panoramica della Pagina dei Log

L'interfaccia della pagina dei Log include:

1. Tab 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. Filtro di Intervallo di Tempo e Azioni - Filtra i log per intervallo di data e tipo di azione (vedi sezioni sottostanti)

Ogni riga mostra:

• Timestamp (UTC)
• ID del Dispositivo
• Azione code (cosa è accaduto)
• Nome della versione (pacchetto o builtin)

Clicca 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 delle date:

Filtro per Intervallo di Data

1. Presete veloci - Seleziona intervalli di tempo comuni: Ultimi 1h, 3h, 6h o 12h
2. Ora di Inizio - Imposta un'ora di inizio personalizzata per il range
3. Fine Tempo - Imposta un tempo di fine personalizzato per la fascia
4. Calendario - Scegli le date specifiche utilizzando la vista del calendario

Clicca su “Seleziona” per applicare la fascia di date scelta, o su “Annulla” per annullare il picker.

Filtra per Tipo di Azione

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

Filtro Azioni

Il filtro delle azioni disponibili includono:

• Ritmo cardiaco del dispositivo - Verifiche di salute periodiche dai dispositivi
• Richiesta di cancellazione della versione - Quando una versione di bundle viene cancellata
• Riprista alla versione predefinita - Quando un dispositivo torna alla bundle predefinita
• Versione installata con successo - Installazione di bundle riuscita
• Nuova versione inviata al dispositivo - Quando Capgo invia un aggiornamento a un dispositivo
• Installazione di versione fallita - Quando l'installazione di 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 traccia di log (dati fittizi)

Ora (UTC)	ID 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	Esecuzione del manifesto; SDK sta per scaricare i file
2025-01-14 10:00:07	A1B2C3	download_40	2.4.1	Il download del bundle è al 40%
2025-01-14 10:00:12	A1B2C3	download_zip_complete	2.4.1	Il file 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 dei dispositivi:

Flusso di Aggiornamento Riuscito

Questa è l'aggiornamento che si presenta in modo sano nei tuoi registri:

Tempo	ID dispositivo	Azione	Versione	Cosa significa
10:00:01	a1b2c3d4	get	1.2.0	Il dispositivo è stato controllato per le aggiornamenti e ha ricevuto le informazioni sulla versione 1.2.0
10:00:02	a1b2c3d4	download_10	1.2.0	L'aggiornamento è iniziato, 10% completato
10:00:03	a1b2c3d4	download_50	1.2.0	L'aggiornamento è al 50%
10:00:05	a1b2c3d4	download_complete	1.2.0	L'aggiornamento è stato completato con successo
10:00:06	a1b2c3d4	set	1.2.0	Il pacchetto è stato installato e attivato

Il dispositivo è già aggiornato

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

Tempo	ID dispositivo	Azione	Versione	Cos'è
14:30:00	e5f6g7h8	noNew	1.2.0	Il dispositivo è già alla versione più recente, non è necessario un aggiornamento

Aggiornamento fallito con rollback

Quando un aggiornamento fallisce e il dispositivo torna indietro:

Tempo	ID dispositivo	Azione	Versione	Cos'è
11:15:00	i9j0k1l2	get	1.3.0	Dispositivo ricevuto informazioni di aggiornamento
11:15:02	i9j0k1l2	download_complete	1.3.0	Scaricamento completato
11:15:03	i9j0k1l2	set	1.3.0	Pacco impostato
11:15:10	i9j0k1l2	update_fail	1.3.0	L'applicazione si è bloccata o notifyAppReady() non è stata chiamata - rollback attivato
11:15:11	i9j0k1l2	reset	integrato	Dispositivo ripristinato alla versione integrata

Azione necessariaVerifica che la tua app chiami notifyAppReady() dopo l'inizializzazione riuscita. Consulta la documentazione del plugin per i dettagli.

Fallimento del download

Quando problemi di rete impediscono il download:

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

Azioni necessarie: La dispositivo si riproverà automaticamente alla prossima avviamento dell'applicazione. Nessuna azione richiesta a meno che ciò non accada frequentemente.

Limite del Piano Raggiunto

Quando il tuo account raggiunge il limite dei dispositivi:

Tempo	ID del Dispositivo	Azione	Versione	Cosa significa
16:00:00	q7r8s9t0	needPlanUpgrade	-	Questo dispositivo non riceverà aggiornamenti fino a quando non sarai salito di livello o il ciclo di fatturazione si riavvierà

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

Blocco di Aggiornamenti per Configurazione del Canale

Quando le impostazioni del canale impediscono un aggiornamento:

Tempo	ID dispositivo	Azione	Versione	Cosa significa
12:00:00	u1v2w3x4	disableAutoUpdateToMajor	2.0.0	Il dispositivo su v1.x non può aggiornarsi automaticamente a v2.x (salto di versione maggiore bloccato)
12:05:00	y5z6a7b8	disableEmulator	1.2.0	Rilevato emulatore, e il canale blocca gli emulatori
12:10:00	c9d0e1f2	disableDevBuild	1.2.0	Costruzione di sviluppo rilevata, e il canale blocca le costruzioni di sviluppo

Azione necessaria: Questi sono protezioni intenzionali. Se desideri consentire queste aggiornamenti, modifica le impostazioni del canale Impostazioni del canale.

Codici log (Capgo enum backend)

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

Flusso di lavoro felice & ciclo di vita

Code(s)	Significato
get	Il dispositivo ha chiesto a Capgo il manifesto del canale corrente
download_manifest_start, download_manifest_complete	Il download del manifesto ha iniziato / terminato (per bundle delta o multi-file)
download_zip_start, download_zip_complete	Il download dell'archivio ZIP ha iniziato / terminato
download_10 … download_90	Miglie di avanzamento del download
download_complete	Tutto il bundle scaricato
set	Il bundle è pronto per il prossimo lancio
reset	Il dispositivo è stato ripristinato al bundle predefinito
delete	Il bundle è stato rimosso dalla memoria locale
uninstall	È stato rilevato l'installazione dell'app
app_moved_to_foreground, app_moved_to_background	Gli eventi di ciclo di vita dell'app sono stati registrati da SDK
ping	Il controllo di salute / pulsante cardiaco dal dispositivo
setChannel, getChannel	Il canale è stato sovrascritto o recuperato tramite SDK chiamata

Blocchi di configurazione o politica

Code(s)	Perché l'aggiornamento è stato bloccato
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative	La strategia del canale vieta questo salto di semver
disablePlatformIos, disablePlatformAndroid	La piattaforma è disabilitata sul canale
disableDevBuild, disableEmulator	I costruzioni di sviluppo o gli emulatori non sono consentiti
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured	La selezione o l'override del canale è fallita
missingBundle, cannotGetBundle	Il manifesto 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 pacchetto (errore di rete o risposta)
download_manifest_file_fail, download_manifest_checksum_fail, download_manifest_brotli_fail	Impossibile recuperare o validare il file di manifesto
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 validazione del sistema di file o dello scompattamento è fallita
decrypt_fail	La decrittografia è fallita (pacchetto crittografato)
update_fail	Il pacchetto è stato installato ma l'app non l'ha mai chiamato notifyAppReady()rollback attivato; non ci sono successive
download_zip_* con nessuna successiva set	Il download è terminato ma la fase di installazione non è mai stata completata

➡️ Hai bisogno di una guida più approfondita per il tuo code? Vedi Guida di riferimento e di debug del Log completo Code.

Ottenere Maggiori Dettagli su un Registro

Se clicchi su un registro specifico, ti porterà tipicamente alla pagina del __CAPGO_KEEP_0__. Ciò ti consente di visualizzare 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.