# 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é](/docs/concepts/confidentialite/).

## 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 :

```bash
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](/docs/guides/depannage/).