Journaux

Journal et Log Insights

L'application Journal Ouvre la tab Analyse des journaux par défaut. Utilisez Insights pour donner la priorité aux catégories, aux versions et aux appareils pour une période de 1, 3, 7 ou 30 jours. Passer à la Journal Événements du périphérique sous-jacent, filtres et horodatages décrits ci-dessous.

Comprendre les journaux d'application

The raw Logs subtab provides a detailed history of update events and diagnostic information for your application. It is useful for confirming the device-level evidence behind an Insight, troubleshooting an update path, and understanding how devices interact with Capgo. Open an app, choose JournalSection intitulée “Comprendre les journaux d'application” Journal subtab.

Journal de Logs brut

L'interface de journaux bruts comprend :

1. Journal de logs — le contrôle de navigation pour les lignes de journaux individuelles.
2. Bouton de rechargement — actualise la liste des journaux avec les données les plus récentes.
3. Filtres de plage de temps et d'action étirer la file d'événements en fonction du temps et de l'action.

Chaque ligne affiche :

• Timestamp (UTC)
• ID du dispositif
• Action code (ce qui s'est passé)
• Nom de version (bundle ou) builtin)

Cliquez sur une ligne pour accéder à la page détails du dispositif pour son historique complet.

Filtrage par plage de dates

Vous pouvez filtrer les journaux par une période de temps spécifique à l'aide du sélecteur de date :

Filtre de plage de dates

1. Préférences rapides - Sélectionnez des plages de temps courantes : Dernières 1h, 3h, 6h ou 12h
2. Heure de début - Définir une date de début personnalisée pour la plage
3. Date de fin - Définir une date de fin personnalisée pour la plage
4. Calendrier Sélectionnez des dates spécifiques en utilisant la vue calendrier

Cliquez sur « Sélectionner » pour appliquer votre plage de dates choisie, ou sur « Annuler » pour fermer le sélecteur.

Filtrage par Type d'Action

Le menu Actions vous permet de filtrer les journaux en fonction de types d'événements spécifiques.

Filtre d'Actions

Les filtres d'actions disponibles incluent :

• Pulse du dispositif - Contrôles de santé périodiques des appareils
• Suppression de version demandée - Lorsqu'une version de bundle est supprimée
• Réinitialisation à la version par défaut - Lorsqu'un appareil revient à la version de bundle intégrée
• Version installée avec succès - Installation de bundle réussie
• Nouvelle version envoyée au dispositif - Lorsque Capgo envoie une mise à jour à un appareil
• Installation de version échouée - Lorsque l'installation de bundle faille

Utilisez la boîte de recherche en haut pour trouver rapidement les types d'actions spécifiques. Vous pouvez sélectionner plusieurs actions pour afficher les journaux correspondant à l'un quelconque des types sélectionnés.

Extrait de journal d'exemple (données fictives)

Heure (UTC)	ID de l'appareil	Action	Version	Ce qu'il vous dit
2025-01-14 10:00:01	A1B2C3	get	2.4.1	L'appareil a demandé Capgo si une mise à jour est disponible
2025-01-14 10:00:03	A1B2C3	download_manifest_start	2.4.1	La mise à jour delta a démarré ; SDK va télécharger les fichiers delta modifiés
2025-01-14 10:00:07	A1B2C3	download_40	2.4.1	La téléchargement du bundle est à 40 %
2025-01-14 10:00:12	A1B2C3	download_zip_complete	2.4.1	Le zip a terminé de télécharger
2025-01-14 10:00:13	A1B2C3	set	2.4.1	Bundle installé et marqué comme prochain à exécuter
2025-01-14 10:05:00	B9C8D7	disableAutoUpdateToMajor	1.9.0	La politique du canal a bloqué un saut vers 2.x
2025-01-14 10:05:05	B9C8D7	rateLimited	intégré	Le périphérique a atteint la limite de requête ; SDK se retire jusqu'au redémarrage

Scénarios d'exemple de journal

Pour vous aider à comprendre ce que les journaux vous disent, voici des séquences d'exemple montrant des parcours d'actualisation réels de l'appareil :

Flux de mise à jour réussie

Voici ce que ressemble une mise à jour saine dans vos journaux :

Heure	ID de l'appareil	Action	Version	Ce que cela signifie
10:00:01	a1b2c3d4	get	1.2.0	Appareil vérifié pour les mises à jour et a reçu la version 1.2.0 info
10:00:02	a1b2c3d4	download_10	1.2.0	Téléchargement commencé, 10% terminé
10:00:03	a1b2c3d4	download_50	1.2.0	Téléchargement à 50%
10:00:05	a1b2c3d4	download_complete	1.2.0	Téléchargement terminé avec succès
10:00:06	a1b2c3d4	set	1.2.0	Bundle installé et activé

Le dispositif est déjà à jour

Lorsqu'un dispositif vérifie mais a déjà la dernière version :

Heure	ID de l'appareil	Action	Version	Ce que cela signifie
14:30:00	e5f6g7h8	noNew	1.2.0	L'appareil est déjà à la dernière version, aucune mise à jour n'est nécessaire

Mise à jour échouée avec redémarrage

Lorsqu'une mise à jour échoue et que l'appareil redémarre :

Heure	ID de l'appareil	Action	Version	Ce que cela signifie
11:15:00	i9j0k1l2	get	1.3.0	Le dispositif a reçu les informations d'actualisation
11:15:02	i9j0k1l2	download_complete	1.3.0	Téléchargement terminé
11:15:03	i9j0k1l2	set	1.3.0	Le paquet a été configuré
11:15:10	i9j0k1l2	update_fail	1.3.0	App crashé ou notifyAppReady() n'a pas été appelé - rollback déclenché
11:15:11	i9j0k1l2	reset	builtin	L'appareil a été réinitialisé vers la version intégrée.

Vérifiez que votre application appelleaprès une initialisation réussie. Consultez notifyAppReady() la documentation du plugin la documentation du plugin Pour plus de détails.

Échec du téléchargement

Lorsque des problèmes de réseau empêchent le téléchargement :

Temps	ID de l'appareil	Action	Version	Ce que cela signifie
09:45:00	m3n4o5p6	get	1.2.0	L'appareil a reçu des informations d'actualisation
09:45:01	m3n4o5p6	download_30	1.2.0	Le téléchargement a commencé mais…
09:45:15	m3n4o5p6	download_fail	1.2.0	Le téléchargement a échoué (délai de connexion perdu, etc.)

Action nécessaireLe dispositif réessayera automatiquement à la prochaine mise à jour de l'application. Aucune action requise à moins que cela se produise fréquemment.

Plan Limit atteint

Lorsque votre compte atteint sa limite de dispositifs :

Durée	ID du dispositif	Action	Version	Ce que cela signifie
16:00:00	q7r8s9t0	needPlanUpgrade	-	This device won’t receive updates until you upgrade or the billing cycle resets

Action nécessaire: Mettez à niveau votre abonnement ou attendez le prochain cycle de facturation.

Configuration du canal Blocage des mises à jour

Lorsque les paramètres du canal empêchent une mise à jour :

Temps	ID de l'appareil	Action	Version	Ce que cela signifie
12:00:00	u1v2w3x4	disableAutoUpdateToMajor	2.0.0	Device on v1.x can’t auto-update to v2.x (major version jump blocked)
12:05:00	y5z6a7b8	disableEmulator	1.2.0	Un émulateur détecté, et le canal bloque les émulateurs
12:10:00	c9d0e1f2	disableDevBuild	1.2.0	Dev build detected, and channel blocks dev builds

Action nécessaire: Ces protections sont intentionnelles. Si vous souhaitez autoriser ces mises à jour, modifiez vos paramètres de canal.

Codes de journal (Capgo enum backend)

Ces codes proviennent de stats_action l'enum utilisé par le tableau de bord API (capgo/src/types/supabase.types.tsSi vous voyez un nouveau code dans l'interface utilisateur, il a été émis par le SDK ou backend et validé contre cette liste.

Parcours heureux & cycle de vie

Code(s)	Signification
get	Le dispositif a demandé Capgo pour le bundle lié à son canal
download_manifest_start, download_manifest_complete	Téléchargement delta commencé / terminé (pour les bundles téléchargés avec des fichiers delta)
download_zip_start, download_zip_complete	Téléchargement d'archive zip commencé / terminé
download_10 … download_90	Milles de progression de téléchargement
download_0	Marqueur de progression 0% pour le premier événement de progression
download_complete	Tout le bundle téléchargé
set	Bundle prêt pour le lancement suivant
reset	Le dispositif est revenu au bundle intégré
delete	Bundle supprimé de la mémoire locale
uninstall	Détection d'une désinstallation d'application
app_moved_to_foreground, app_moved_to_background	Événements de cycle d'application enregistrés par SDK
ping	Vérification de santé/heartbeat du dispositif
setChannel, getChannel	Canal surchargé ou récupéré via l'appel SDK

Nouvelle politique de blocage / ralentissement rapide

Code	Pourquoi cela se produit	Qu'est-ce qu'il faut faire ensuite
invalidIp	Capgo a détecté un trafic qui ressemble à du trafic bot (IP d'infrastructure Google/Cloud).	Ignorez les utilisateurs réels; réessayez depuis des appareils réels et des réseaux normaux, ou vérifiez après quelques instants.
needPlanUpgrade	La société a atteint la limite de plan appareil.	Upgrade plan in dashboard or wait for next billing cycle.
semver_error	La version native de l'application dans la configuration est manquante ou non valide (x.y.z).	Set plugins.CapacitorUpdater.version à validité de SemVer, puis vérifiez-le dans le Testeur de SemVer et reconstruisez l'application.
disablePlatformIos	iOS est désactivé dans la politique de canal.	Si cela était accidentel, activez iOS dans ce canal et républiez la configuration de routage. Si vous bloquez intentionnellement iOS dans cette piste, gardez-l’éteint et déplacez les builds iOS vers un canal séparé.
disablePlatformAndroid	Android est désactivé dans la politique de canal.	Si cela était accidentel, activez Android dans ce canal et républiez la configuration de routage. Si vous bloquez intentionnellement Android dans cette piste, gardez-l’éteint et déplacez les builds Android vers un canal séparé.
disableAutoUpdate	Mode de mise à jour automatique du canal bloque ce style d'actualisation.	Changer la politique d'actualisation automatique du canal (majeur/minor/patch/métadonnées/aucune) pour permettre votre lancement prévu.
disableAutoUpdateUnderNative	Channel is set to block updates older than the device baseline.	Envoie une version à au moins la base native, ou désactivez cette protection sous-naturelle.
disableAutoUpdateMetadata	Le canal exige min_update_version les métadonnées et l'application est plus ancienne.	Configurez min_update_version pour le bundle ou la version de sortie cible à partir d'une version native plus récente.
disableAutoUpdateToMajor	La chaîne bloque les sauts de version majeure.	Conserver les versions majeures dans la même stratégie de canal, ou permettre des sauts majeurs pour cette piste.
disableAutoUpdateToMinor	La chaîne bloque les sauts de version mineure.	Conserver les versions mineures dans la même stratégie de canal, ou permettre des sauts mineurs pour cette piste.
disableAutoUpdateToPatch	Le canal bloque les sauts de niveau de correctif pour ce flux.	La stratégie de canal bloque les sauts de niveau de correctif pour ce flux.
disableEmulator	Mises à jour de l'émulateur non autorisées pour ce canal.	If this was accidental, turn on emulator updates in a test channel where you validate emulators. If intentional, keep this channel emulator-blocked and use another channel for emulator builds.
disableDevBuild	Les builds de développement sont bloqués pour ce canal.	If this was accidental, allow dev updates or move this device to a dev-enabled channel. If this is intentional, keep this channel locked to release builds only.
disableProdBuild	Un appareil construit en mode production appelé /updatestandis que votre canal l'a bloqué.	Si c'était une erreur, autorisez les mises à jour de production dans ce canal et républiez. Si c'est intentionnel, maintenez la restriction et envoyez les builds de production au canal/build approprié.
cannotGetBundle	Capgo n'a pas pu construire une URL de téléchargement valide pour le bundle sélectionné.	Ré-uploadez le bundle (avec --delta si vous voulez des fichiers delta) et vérifiez les paramètres du bundle R2/public.
cannotUpdateViaPrivateChannel	L'application a tenté de se connecter à un canal privé qui ne permet pas la réaffectation automatique.	Activez allow_device_self_set sur le canal ou basculez vers un canal public/autorisé.
channelMisconfigured	La règle d'actualisation automatique du canal manque de données requises (version_number sans min_update_version).	Complétez la configuration manquante pour cette règle ou passez à un mode d'auto-mise à jour plus simple.
missingBundle	Le bundle n'a pas de contenu téléchargeable (manquant) external_url/r2_path et pas de fichiers delta).	Reconstruire/republier la version et vérifiez que le bundle a un contenu de fichier réel.
NoChannelOrOverride	Aucun canal ne correspond à cet appareil (pas de cloud par défaut + pas de fallback de configuration + pas de surcharge).	Définir un canal par défaut sur le tableau de bord ou conserver un test defaultChannel dans cette build.
rateLimited	Trop de requêtes d'actualisation/canal en un court laps de temps (souvent boucle de rendu) setChannel/getChannel).	Stop calling in render. Only call on user action. Use defaultChannel en capacitor.config.
keyMismatch	The app and bundle encryption key IDs differ (device_key_id vs bundle_key_id).	In le console, comparez les clés ID de l'appareil et du bundle. Si elles diffèrent, publiez avec la même clé et la même version du plugin CLI; l'encodage de la clé peut différer entre les versions.
disableDevice	Un téléphone/tablette réel a été bloqué car ce canal est configuré pour bloquer les appareils réels.	Si c'est une erreur, activez les mises à jour de dispositifs réels dans ce canal. Si c'est intentionnel, maintenez-le bloqué et redirigez les appareils réels vers un autre canal.
disablePlatformElectron	Electron est bloqué dans ce canal.	Si cela était accidentel, activez Electron dans ce canal et républiez la configuration de routage. Si cela était intentionnel, maintenez-le bloqué et dirigez les utilisateurs Electron vers un canal dédié.
customIdBlocked	A custom device ID was sent, but this app does not accept custom IDs.	Désactivez l'envoi de l'ID personnalisé ou activez les ID personnalisés uniquement si votre flux de travail le nécessite.
blocked_by_server_url	Le logiciel a server.url configuré, donc Capacitor sert une URL distante au lieu de fichiers locaux.	Supprimer/effacer server.url pour les builds de production et maintenez les payloads d'actualisation locaux.
backend_refusal	Le metteur à jour est v4, qui n'est plus accepté par le serveur backend.	Mettez à jour le plugin/CLI en v5+ (prefer v8), avec Capacitor v5+, puis rebuild et republiez les métadonnées du bundle.
Les blocs de configuration ou de politique

Code(s)	Pourquoi l'update a été bloqué
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative	La stratégie de canal interdit cela semver jump
disablePlatformIos, disablePlatformAndroid	La plateforme est désactivée sur le canal
disableDevBuild, disableEmulator	Dev builds or emulators not allowed
disableProdBuild, disableDevice, disablePlatformElectron	Les builds de production, les appareils réels ou Electron sont bloqués pour ce canal.
customIdBlocked	Custom device IDs are not accepted for this app.
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured	La sélection ou la surcharge du canal a échoué
missingBundle, cannotGetBundle	Le canal pointe vers un bundle Capgo ne peut pas servir
needPlanUpgrade	L'organisation a atteint sa limite de plan/appareil.

Les échecs de téléchargement / intégrité / installation.

Code(s)	Signification
download_fail	Le téléchargement du bundle a échoué (erreur de réseau ou de réponse).
download_manifest_file_fail, download_manifest_checksum_fail, download_manifest_brotli_fail	Un fichier delta ne pouvait pas être récupéré ou validé.
checksum_fail, checksum_required	Vérification d'intégrité échouée ou absence de checksum
unzip_fail, directory_path_fail, canonical_path_fail, windows_path_fail	File system or unzip validation failed
decrypt_fail	Échec de la décryptage (bundle chiffré)
update_fail	L'application n'a jamais appelé le bundle installé. notifyAppReady(); le rollback a été déclenché
download_zip_* with no subsequent set	Téléchargement terminé mais phase d'installation jamais terminée

Événements du runtime / plateforme

Code(s)	Signification
app_crash, app_crash_native	Événements de panne provenant des couches JavaScript ou natives. Les métadonnées incluent souvent des informations sur la pile, la source et la version active.
app_anr	L'Android a signalé un Application Not Responding.
app_killed_low_memory, app_killed_excessive_resource_usage	Arrêt du processus d'application en raison de limites de mémoire ou de ressources.
app_initialization_failure, app_memory_warning	L'exécution a été interrompue ou une pression de mémoire a été observée avant une exécution normale.
webview_javascript_error, webview_unhandled_rejection, webview_resource_error, webview_security_policy_violation, webview_unclean_restart, webview_render_process_gone, webview_content_process_terminated	Les erreurs de cycle de vie de WebView et de rendu JS. Installez Sentry dans les deux couches JS et natives pour capturer les traces de pile, le contexte de session/ appareil et l'URL/état pour des corrections plus rapides.
os_version_changed, native_app_version_changed	La version de l'OS ou de l'application native a changé ; cela aide à séparer les effets de déploiement au niveau du plateforme des comportements du paquet web.

➡️ Need deeper per-code guidance? See Guide de référence et de débogage complet des journaux Code.

Obtenir plus d'informations sur un journal

Si vous cliquez sur une entrée de journal spécifique, cela vous emmène généralement à la page de l'appareil. Cela vous permet de voir l'ensemble de l'historique pour cet appareil en particulier, ce qui peut être très utile pour diagnostiquer les problèmes spécifiques à l'appareil ou comprendre son parcours d'actualisation.

Continuez de la page des journaux

If vous utilisez Journal pour planifier le tableau de bord et les opérations API, connectez-l’à API Vue d'ensemble pour les détails d'implémentation dans API Vue d'ensemble, Introduction pour les détails d'implémentation dans Introduction, API Clés pour les détails d'implémentation dans API Clés, Appareils pour les détails d'implémentation dans Appareils, et Ensembles pour les détails d'implémentation dans les Bundles.