Lire les logs d'aperçu
Suivez les logs d'installation, de construction et de démarrage pour comprendre exactement ce que fait votre aperçu.
Chaque aperçu diffuse ses logs en direct : la même sortie qu'un développeur suivrait dans un terminal. Pas besoin d'en être un pour en tirer profit : connaître les phases et quelques lignes repères vous dit où en est un aperçu, et où il s'est bloqué.
Les phases du démarrage d'un aperçu
Un aperçu qui démarre passe par des étapes prévisibles, et les logs annoncent chacune :
- Installation : les dépendances sont restaurées (« Preview starting… », sortie de restauration ou d'installation). Lent la première fois, rapide ensuite.
- Préparation de la base de données (aperçus d'API) : une base Postgres éphémère est créée, les migrations tournent, les données d'exemple sont chargées. Voir Bases de données d'aperçu.
- Construction : le projet compile. Les avertissements sont en général sans gravité ; les erreurs arrêtent le démarrage ici.
- Démarrage : l'app démarre et ouvre son port ; l'URL de l'aperçu devient active.
Une fois lancé, les logs passent à la sortie en direct de l'application : chaque requête, et chaque erreur, au moment où elles arrivent.
Comment lire un échec
-
Remontez à la première erreur, pas à la dernière. Les échecs s'enchaînent ; la plus ancienne est presque toujours la cause, le reste n'est que du bruit.
-
Notez la phase où elle s'est produite. Une erreur de construction veut dire que le code ne compile pas ; une erreur de base de données au démarrage veut souvent dire que les migrations et le schéma ne concordent pas ; une erreur après le démarrage est un bug de l'application.
-
Passez la main : Analyse & Fix lit les mêmes logs, identifie la cause et propose la correction ; vous n'avez pas à interpréter la pile d'appels vous-même.
Voir aussi
- Dépanner les aperçus : les échecs courants, symptôme par symptôme.
- Présentation du Preview Hub : là où vivent les logs.
Dernière mise à jour: 4 septembre 2026