Consulter les journaux

Les journaux sont ce que ton site écrit en tournant. C'est le seul endroit qui explique pourquoi un déploiement a échoué, pourquoi une page renvoie une erreur, ou pourquoi une application redémarre en boucle.

Les journaux d'un site

Ouvre la fiche du site depuis le Tableau de bord ou depuis son projet.
Section Opérations, tout en haut : lien Voir les logs live.
Tu arrives sur une page Logs qui affiche le journal sur fond sombre, la ligne la plus récente en bas.

Sur cette page :

La case Auto-refresh 3s est cochée par défaut : le journal se recharge tout seul toutes les trois secondes, et la mention « rafraîchissement » clignote à chaque lecture. Décoche-la pour figer l'affichage, par exemple le temps de copier une erreur.
Tu vois les dernières lignes, une centaine en pratique, pas l'historique du site. C'est une fenêtre glissante : ce qui sort par le haut n'est pas conservé.
Le lien ← nom du site en haut de page ramène à la fiche.

Astuce

Quand tu traques un problème qui ne se produit qu'au démarrage, ouvre la page des journaux avant de cliquer sur Deploy, dans un autre onglet. Avec le rafraîchissement automatique, tu vois la construction se dérouler au lieu d'arriver après la bataille.

Lire une erreur de déploiement

Un déploiement qui échoue se manifeste d'abord par un écran, pas par un changement d'état : le clic sur Deploy ouvre la page « Quelque chose s'est mal passé », avec le message brut renvoyé par la plateforme dans un encadré gris. Le site, lui, reste affiché dans l'état où il était.

Par où commencer

Lis le message de l'écran d'erreur. Il suffit dans la plupart des cas. Un message qui commence par compose up failed veut dire que la construction du site s'est arrêtée : la suite du message est la sortie de cette construction.
Cherche la première ligne en erreur, pas la dernière. Une construction qui échoue empile ensuite des lignes qui ne sont que des conséquences. La cause est en haut.
Ouvre les journaux du site si le message ne suffit pas, ou si le déploiement a réussi mais que le site répond mal : à ce stade, ce n'est plus la construction qui parle, c'est l'application.
Corrige, puis reclique sur Deploy. Rien ne se répare tout seul entre deux tentatives.

Trois causes qui reviennent souvent

Ce que tu vois	Cause probable	Correction
La construction s'arrête et le message cite le dossier `public`.	Un site `nextjs` sans dossier `public/` dans son code.	Ajoute un dossier `public/`, même vide, et redéploie.
Le déploiement réussit, mais la page est blanche et les journaux ne signalent rien.	Mauvais runtime : le site a été créé en `static` alors que son code doit être construit avant d'être servi.	Passe le site en `frontend-static`. Voir Runtimes.
Les journaux répètent le démarrage de l'application en boucle.	L'application écoute sur une adresse qu'Iridflow ne peut pas joindre.	Fais écouter ton application sur `0.0.0.0` et sur le port du runtime, puis redéploie.

Les journaux d'un preview

Un preview a ses propres journaux, séparés de ceux du site. Ils ne sont pas sur la page Logs mais sur la fiche du site :

Fiche du site, section Previews par commit.
Sur la ligne du preview qui t'intéresse, clique sur journaux. Le journal s'ouvre juste en dessous de la ligne.
Le lien rafraîchir recharge le contenu. Il n'y a pas de rafraîchissement automatique ici, contrairement à la page des journaux d'un site.
Recliquer sur masquer les journaux referme le bloc.

Deux cas particuliers valent d'être connus :

Preview en échec. La cause courte est déjà affichée en rouge sur sa ligne, sans avoir à ouvrir les journaux. Ouvre-les quand cette phrase ne suffit pas.
« Journaux illisibles ». Iridflow n'a pas pu lire le journal, en général parce que le conteneur du preview n'existe plus : c'est le cas d'un preview recyclé ou supprimé. Redéploie le commit si tu as encore besoin de l'examiner.

Ce que les journaux ne contiennent pas

Qui a fait quoi sur la plateforme. Les créations, suppressions et déploiements sont consignés dans le journal d'audit, réservé aux administrateurs. Voir Administration de la plateforme.
L'historique ancien. Seules les dernières lignes sont conservées. Copie une erreur quelque part avant de relancer un déploiement, sinon elle est perdue.
Les journaux d'un site en production. L'interface expose les journaux de la préproduction et des previews. Ceux d'un conteneur de production se lisent sur la grappe, ce qui relève de l'administration de la plateforme.

En complément, par le MCP

logs_site({ site_id: "site_xxxxxxxx", lines: 200 })
preview_logs({ preview_id: "pd_xxxxxxxx", lines: 200 })

lines accepte de 1 à 1000, et vaut 100 si tu ne le précises pas. Utile pour remonter plus loin que ce que l'interface affiche. Voir MCP et Claude Desktop.