Lire les logs

Les logs répondent à deux questions : qu’est-ce que les visiteurs ont reçu, et qu’est-ce qui s’est passé pendant le build. Ce guide montre où les trouver et comment les filtrer.

Résultat attendu : tu identifies la requête ou la ligne de build à l’origine d’un problème.

Les requêtes servies

1. Ouvre l'onglet Logs du projet

   Les requêtes apparaissent en direct. Pour chacune, tu vois l’heure, le statut HTTP, la méthode, le domaine, le chemin, la durée de traitement et la taille de la réponse.

2. Isole les erreurs

   Clique Erreur pour ne garder que les réponses 5xx. Clique Alerte pour les réponses 4xx. La recherche lit le chemin et le domaine.

3. Garde la vue à jour

   Suivre garde les dernières requêtes en vue. Sous la liste, un compteur donne le nombre de réponses par classe : 2xx, 3xx, 4xx et 5xx.

4. Copie ce qui t'intéresse

   Tout copier copie toutes les requêtes reçues, une par ligne. L’icône de copie ne copie que les lignes affichées.

Les requêtes ne gardent ni adresse IP, ni en-têtes, ni paramètres d’URL (la partie après ?). Elles disparaissent après trois jours. Voir Confidentialité.

La sortie d’un build

La page de chaque déploiement affiche la sortie du build : installation, vercel build, puis publication.

• Avec l’intégration GitHub, les lignes arrivent en direct pendant le build.
• Cherche dans les lignes, ou filtre les erreurs et les alertes.
• Ouvre le run GitHub Actions pour la sortie complète, si ton build passe par GitHub.
• Tout copier copie la sortie entière. L’icône de copie ne copie que les lignes affichées.

Suivre un déploiement depuis le terminal

vercel deploy suit la publication jusqu’à la fin, pendant 9 minutes au plus, puis rend la main :

vercel --api https://api.host.hgdc.ch deploy --prod

Si ça ne marche pas

• Un build n’a pas de sortie : il est peut-être en file, ou il a été annulé avant de démarrer. Vérifie l’état du déploiement.
• Un problème de page n’apparaît pas dans les logs de requêtes : les requêtes sont gardées trois jours seulement. Reproduis le problème, puis regarde tout de suite.
• Pour une erreur de build, commence par la première ligne d’erreur du filtre Erreur, puis remonte la sortie jusqu’à elle. Voir Dépannage.