Journaux
Comprendre les journaux d’application
Section titled “Comprendre les journaux d’application”La page Journaux fournit un historique détaillé des événements de mise à jour et des informations de diagnostic pour votre application. Ceci est crucial pour surveiller le processus de mise à jour, résoudre les problèmes et comprendre comment vos appareils interagissent avec Capgo. Vous pouvez y accéder en cliquant sur votre application puis en cliquant sur l’onglet “Journaux” (anciennement appelé “mises à jour” dans certaines captures d’écran ou documentations plus anciennes).
De là, vous devriez voir une page similaire à celle-ci, affichant une liste d’entrées de journal :
L’interface de la page des journaux comprend :
- Onglet Journaux - L’onglet de navigation pour accéder à la vue des journaux
- Bouton Recharger - Actualise la liste des journaux avec les dernières données
- Filtres de plage de temps et d’actions - Filtrez les journaux par plage de dates et type d’action (voir les sections ci-dessous)
Chaque ligne affiche :
- Horodatage (UTC)
- ID de l’appareil
- Code d’action (ce qui s’est passé)
- Nom de version (bundle ou
builtin)
Cliquez sur une ligne pour accéder à la page de détails de l’appareil pour l’historique complet.
Filtrer par plage de dates
Section titled “Filtrer par plage de dates”Vous pouvez filtrer les journaux par une période spécifique en utilisant le sélecteur de dates :
- Préréglages rapides - Sélectionnez des plages de temps courantes : Dernière 1h, 3h, 6h ou 12h
- Heure de début - Définissez une heure de début personnalisée pour la plage
- Heure de fin - Définissez une heure de fin personnalisée pour la plage
- Calendrier - Choisissez des dates spécifiques à l’aide de la vue calendrier
Cliquez sur “Sélectionner” pour appliquer votre plage de dates choisie, ou “Annuler” pour fermer le sélecteur.
Filtrer par type d’action
Section titled “Filtrer par type d’action”Le menu déroulant Actions vous permet de filtrer les journaux par types d’événements spécifiques :
Les filtres d’action disponibles incluent :
- Battement de cœur de l’appareil - Vérifications de santé périodiques des appareils
- Suppression de version demandée - Quand une version de bundle est supprimée
- Réinitialisation à la version par défaut - Quand un appareil revient au bundle intégré
- Version installée avec succès - Installation réussie du bundle
- Nouvelle version envoyée à l’appareil - Quand Capgo envoie une mise à jour à un appareil
- Échec de l’installation de la version - Quand l’installation du bundle échoue
Utilisez la boîte de recherche en haut pour trouver rapidement des types d’action spécifiques. Vous pouvez sélectionner plusieurs actions pour afficher les journaux correspondant à l’un des types sélectionnés.
Extrait de journal exemple (données fictives)
Section titled “Extrait de journal exemple (données fictives)”| Heure (UTC) | ID Appareil | Action | Version | Ce que cela signifie |
|---|---|---|---|---|
| 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 | Téléchargement du manifeste lancé ; le SDK est sur le point de télécharger les fichiers |
| 2025-01-14 10:00:07 | A1B2C3 | download_40 | 2.4.1 | Le téléchargement du bundle est à 40% |
| 2025-01-14 10:00:12 | A1B2C3 | download_zip_complete | 2.4.1 | Téléchargement du zip terminé |
| 2025-01-14 10:00:13 | A1B2C3 | set | 2.4.1 | Bundle installé et marqué pour le prochain lancement |
| 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 | builtin | L’appareil a atteint la limite de requêtes ; le SDK attend jusqu’au redémarrage |
Scénarios de journaux exemples
Section titled “Scénarios de journaux exemples”Pour vous aider à comprendre ce que les journaux vous indiquent, voici des séquences exemples montrant de vrais parcours de mise à jour d’appareils :
Flux de mise à jour réussi
Section titled “Flux de mise à jour réussi”Voici à quoi ressemble une mise à jour saine dans vos journaux :
| Heure | ID Appareil | Action | Version | Ce que cela signifie |
|---|---|---|---|---|
| 10:00:01 | a1b2c3d4 | get | 1.2.0 | L’appareil a vérifié les mises à jour et reçu les infos de la version 1.2.0 |
| 10:00:02 | a1b2c3d4 | download_10 | 1.2.0 | Téléchargement démarré, 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é |
Appareil déjà à jour
Section titled “Appareil déjà à jour”Quand un appareil vérifie mais a déjà la dernière version :
| Heure | ID Appareil | Action | Version | Ce que cela signifie |
|---|---|---|---|---|
| 14:30:00 | e5f6g7h8 | noNew | 1.2.0 | L’appareil est déjà sur la dernière version, pas de mise à jour nécessaire |
Mise à jour échouée avec retour arrière
Section titled “Mise à jour échouée avec retour arrière”Quand une mise à jour échoue et l’appareil revient en arrière :
| Heure | ID Appareil | Action | Version | Ce que cela signifie |
|---|---|---|---|---|
| 11:15:00 | i9j0k1l2 | get | 1.3.0 | L’appareil a reçu les infos de mise à jour |
| 11:15:02 | i9j0k1l2 | download_complete | 1.3.0 | Téléchargement terminé |
| 11:15:03 | i9j0k1l2 | set | 1.3.0 | Le bundle a été défini |
| 11:15:10 | i9j0k1l2 | update_fail | 1.3.0 | L’app a planté ou notifyAppReady() n’a pas été appelé - retour arrière déclenché |
| 11:15:11 | i9j0k1l2 | reset | builtin | L’appareil est revenu à la version intégrée |
Action nécessaire : Vérifiez que votre app appelle notifyAppReady() après une initialisation réussie. Voir la documentation du plugin pour plus de détails.
Échec de téléchargement
Section titled “Échec de téléchargement”Quand des problèmes réseau empêchent le téléchargement :
| Heure | ID Appareil | Action | Version | Ce que cela signifie |
|---|---|---|---|---|
| 09:45:00 | m3n4o5p6 | get | 1.2.0 | L’appareil a reçu les infos de mise à jour |
| 09:45:01 | m3n4o5p6 | download_30 | 1.2.0 | Téléchargement démarré mais… |
| 09:45:15 | m3n4o5p6 | download_fail | 1.2.0 | Téléchargement échoué (timeout réseau, connexion perdue, etc.) |
Action nécessaire : L’appareil réessaiera automatiquement au prochain lancement de l’app. Aucune action requise sauf si cela arrive fréquemment.
Limite du plan atteinte
Section titled “Limite du plan atteinte”Quand votre compte atteint sa limite d’appareils :
| Heure | ID Appareil | Action | Version | Ce que cela signifie |
|---|---|---|---|---|
| 16:00:00 | q7r8s9t0 | needPlanUpgrade | - | Cet appareil ne recevra pas de mises à jour tant que vous n’aurez pas mis à niveau ou que le cycle de facturation ne sera pas réinitialisé |
Action nécessaire : Mettez à niveau votre plan ou attendez le prochain cycle de facturation.
Configuration du canal bloquant les mises à jour
Section titled “Configuration du canal bloquant les mises à jour”Quand les paramètres du canal empêchent une mise à jour :
| Heure | ID Appareil | Action | Version | Ce que cela signifie |
|---|---|---|---|---|
| 12:00:00 | u1v2w3x4 | disableAutoUpdateToMajor | 2.0.0 | L’appareil sur v1.x ne peut pas se mettre à jour automatiquement vers v2.x (saut de version majeure bloqué) |
| 12:05:00 | y5z6a7b8 | disableEmulator | 1.2.0 | Émulateur détecté, et le canal bloque les émulateurs |
| 12:10:00 | c9d0e1f2 | disableDevBuild | 1.2.0 | Build de développement détecté, et le canal bloque les builds de développement |
Action nécessaire : Ce sont des protections intentionnelles. Si vous voulez autoriser ces mises à jour, modifiez vos paramètres de canal.
Codes de journal (enum backend Capgo)
Section titled “Codes de journal (enum backend Capgo)”Ces codes proviennent de l’enum stats_action utilisé par l’API du tableau de bord (capgo/src/types/supabase.types.ts). Si vous voyez un nouveau code dans l’UI, il a été émis par le SDK ou le backend et validé contre cette liste.
Chemin heureux et cycle de vie
| Code(s) | Signification |
|---|---|
get | L’appareil a demandé à Capgo le manifeste du canal actuel |
download_manifest_start, download_manifest_complete | Téléchargement du manifeste commencé / terminé (pour les bundles delta ou multi-fichiers) |
download_zip_start, download_zip_complete | Téléchargement de l’archive zip commencé / terminé |
download_10 … download_90 | Jalons de progression du téléchargement |
download_complete | Bundle entier téléchargé |
set | Bundle préparé pour le prochain lancement |
reset | L’appareil est revenu au bundle intégré |
delete | Bundle supprimé du stockage local |
uninstall | Désinstallation de l’app détectée |
app_moved_to_foreground, app_moved_to_background | Événements du cycle de vie de l’app enregistrés par le SDK |
ping | Vérification de santé/battement de cœur de l’appareil |
setChannel, getChannel | Canal remplacé ou récupéré via appel SDK |
Blocages de configuration ou de politique
| Code(s) | Pourquoi la mise à jour a été bloquée |
|---|---|
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative | La stratégie du canal interdit ce saut de semver |
disablePlatformIos, disablePlatformAndroid | La plateforme est désactivée sur le canal |
disableDevBuild, disableEmulator | Builds de développement ou émulateurs non autorisés |
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured | La sélection du canal ou le remplacement a échoué |
missingBundle, cannotGetBundle | Le manifeste fait référence à un bundle que Capgo ne peut pas servir |
needPlanUpgrade | L’organisation a atteint sa limite de plan/appareils |
rateLimited | Trop de requêtes ; le SDK limite jusqu’au redémarrage |
blocked_by_server_url, backend_refusal, InvalidIp | Une règle côté serveur a bloqué la requête |
Échecs de téléchargement / intégrité / installation
| Code(s) | Signification |
|---|---|
download_fail | Échec du téléchargement du bundle (erreur réseau ou de réponse) |
download_manifest_file_fail, download_manifest_checksum_fail, download_manifest_brotli_fail | Le fichier manifeste n’a pas pu être récupéré ou validé |
checksum_fail, checksum_required | La vérification d’intégrité a échoué ou la somme de contrôle manque |
unzip_fail, directory_path_fail, canonical_path_fail, windows_path_fail | La validation du système de fichiers ou de la décompression a échoué |
decrypt_fail | Le déchiffrement a échoué (bundle chiffré) |
update_fail | Bundle installé mais l’app n’a jamais appelé notifyAppReady() ; retour arrière déclenché |
download_zip_* sans set subséquent | Téléchargement terminé mais la phase d’installation n’a jamais été complétée |
➡️ Besoin d’un guide plus approfondi par code ? Voir Référence complète des codes de journal et guide de débogage.
Obtenir plus de détails sur un journal
Section titled “Obtenir plus de détails sur un journal”Si vous cliquez sur une entrée de journal spécifique, cela vous amènera généralement à la page de l’appareil. Cela vous permet de voir l’historique complet de cet appareil particulier, ce qui peut être très utile pour diagnostiquer des problèmes spécifiques à l’appareil ou comprendre son parcours de mise à jour.