View a markdown version of this page

Afficher les journaux de déploiement pour un environnement Elastic Beanstalk - AWS Elastic Beanstalk
Opérations prises en chargeContenu des journauxConsoleFichiers journaux d'instance

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Afficher les journaux de déploiement pour un environnement Elastic Beanstalk

Elastic Beanstalk génère un journal de déploiement pour chaque déploiement dans votre environnement. Le journal de déploiement fournit une vue chronologique consolidée de ce qui s'est passé au cours d'un déploiement, notamment de l'installation des dépendances, des résultats de compilation, du démarrage de l'application et des éventuelles erreurs rencontrées. Vous pouvez utiliser les journaux de déploiement pour diagnostiquer rapidement les échecs des déploiements sans avoir à vous connecter aux instances par SSH ou à corréler plusieurs fichiers journaux.

Les journaux de déploiement sont écrits localement sur chaque instance. Pour les déploiements déclenchés via la console, la CLI, l'API ou les mises à jour gérées, une instance télécharge en permanence son journal sur Amazon S3 pendant le déploiement. La console Elastic Beanstalk lit le journal depuis Amazon S3, ce qui vous permet de suivre les progrès sans vous connecter à l'instance.

Les journaux de déploiement sont conçus pour être concis. En cas de succès, le journal affiche uniquement des messages récapitulatifs (par exemple, quelles commandes ont été exécutées et terminées). En cas d'échec, le journal inclut jusqu'à 50 lignes de sortie de l'étape ayant échoué, de sorte que vous pouvez voir l'erreur sans passer au crible les résultats détaillés.

Note

Les journaux de déploiement sont disponibles sur les versions des plateformes Amazon Linux 2 et Amazon Linux 2023 publiées le 11 mars 2026 ou après cette date. Les plateformes Windows ne sont actuellement pas prises en charge.

Opérations prises en charge

Les journaux de déploiement sont générés pour les opérations suivantes :

  • Déploiements d'applications — Déploiement d'une nouvelle version d'application dans votre environnement.

  • Mises à jour de configuration : modification des paramètres de configuration de l'environnement qui nécessitent des mises à jour d'instance.

  • Création d'un environnement : déploiement initial lorsque vous créez un nouvel environnement.

  • Redémarrer le serveur d'applications : redémarrez le serveur d'applications sur vos instances.

Les opérations qui ne modifient pas l'état de l'application ou de la configuration sur les instances, telles que la demande de journaux, l'échange CNAMEs ou la mise à jour de balises, ne génèrent pas de journaux de déploiement.

Contenu du journal de déploiement

Un journal de déploiement enregistre les informations suivantes lors d'un déploiement :

  • Cycle de vie du déploiement : messages de début et de fin pour chaque phase de déploiement, tels que Starting Application deployment etCompleted Application deployment.

  • Sortie .ebextensions — En cas de succès, les noms des commandes exécutées. En cas d'échec, les 50 dernières lignes de cfn-init sortie pour aider à diagnostiquer le problème.

  • Sortie des hooks de la plateforme : en cas de succès, les noms des scripts d'accroche exécutés. En cas d'échec, les 50 dernières lignes du hook sont sorties.

  • Installation des dépendances : sortie des gestionnaires de packages tels que npm installpip install,composer install, etbundle install. En cas de succès, seul un message de fin est enregistré. En cas de panne, les 50 dernières lignes de sortie sont incluses.

  • Sortie de construction : sortie à partir de commandes de génération telles que docker buildgo build, et les versions Java. En cas de panne, les 50 dernières lignes de sortie sont incluses.

  • Sortie de démarrage de l'application : sortie initiale de votre application après son démarrage. La source dépend de votre plateforme :

    • Docker — Journaux de conteneurs provenant de ou docker logs docker compose logs

    • Java SE, Go, Node.js, Python, Ruby, .NET — Procédez aux journaux stdout

    • Tomcat — Catalina enregistre les résultats

    • PHP — Journaux d'erreurs du master et du pool PHP-FPM

    • ECS — Journaux de conteneur de chaque conteneur de tâches

    Note

    La sortie de l'application est capturée 2 secondes après le démarrage de l'application. Seuls les messages de démarrage initiaux sont inclus. Si votre application met plus de temps à produire une sortie, celle-ci n'apparaîtra pas dans le journal de déploiement. Pour consulter les journaux complets des applications, demandez des journaux de bundle ou connectez-vous directement à l'instance. Pour de plus amples informations, veuillez consulter Affichage des journaux d'instance.

Lorsqu'une étape de déploiement échoue, le journal la marque [ERROR] et inclut jusqu'à 50 lignes de sortie de l'étape échouée. Si le journal de déploiement ne contient pas suffisamment de détails, vous pouvez récupérer les journaux d'instance complets (y compris eb-engine.logeb-hooks.log, et les journaux d'application) à partir de l'onglet Logs. Pour de plus amples informations, veuillez consulter Affichage des journaux des instances Amazon EC2 dans votre environnement Elastic Beanstalk.

Afficher les journaux de déploiement dans la console

La console Elastic Beanstalk propose un onglet Déploiements sur le tableau de bord de l'environnement où vous pouvez consulter l'historique et les journaux de vos déploiements.

Afficher l'historique des déploiements

Pour consulter l'historique des déploiements

  1. Ouvrez la console Elastic Beanstalk, puis dans la liste des régions, sélectionnez votre. Région AWS

  2. Dans le panneau de navigation, choisissez Environments (Environnements), puis choisissez le nom de votre environnement dans la liste.

  3. Dans le tableau de bord de l'environnement, choisissez l'onglet Déploiements.

    L'onglet Déploiements affiche un tableau des déploiements pour l'environnement. Chaque ligne inclut les informations suivantes :

    • ID de demande : identifiant unique pour le déploiement.

    • État — Succès, échec ou en cours.

    • Type : type de déploiement, tel que création d'environnement, déploiement d'applications, mise à jour de configuration, mise à jour de plate-forme gérée, redémarrage du serveur d'applications, environnement de reconstruction, environnement de restauration, domaine d'environnement d'échange ou fin d'environnement.

    • Heure de début : date à laquelle le déploiement a commencé.

    • Durée : durée du déploiement.

Lorsqu'un déploiement est en cours, l'onglet interroge automatiquement les mises à jour. Vous pouvez également cliquer sur le bouton d'actualisation pour recharger manuellement la liste.

Afficher les détails et les journaux du déploiement

Pour consulter les détails du déploiement

  1. Dans l'onglet Déploiements, choisissez le lien Request ID pour le déploiement que vous souhaitez inspecter.

  2. La page détaillée du déploiement présente une section récapitulative avec l'ID de demande, le statut, le type de déploiement, l'heure de début, la durée et la politique de déploiement. La politique de déploiement (par exemple, Tout en une fois, Rolling, Rolling with additional batch, Immuable ou Traffic Splitting) est affichée lorsqu'elle peut être déterminée à partir des événements de déploiement.

  3. Sous le résumé, choisissez l'un des onglets suivants :

    • Événements : chronologie des événements liés à ce déploiement, filtrée pour n'afficher que les événements relatifs au déploiement sélectionné.

    • Journaux de déploiement : journal de déploiement consolidé de l'instance. Vous pouvez effectuer une recherche, filtrer par niveau de journal et télécharger le fichier journal.

Pour les déploiements en cours, l'onglet journaux est automatiquement actualisé pour afficher les nouvelles entrées de journal au fur et à mesure qu'elles sont écrites. Une fois le déploiement terminé, la console récupère l'état final du journal pour s'assurer que vous voyez le résultat complet.

Important

L'affichage des journaux de déploiement dans la console nécessite une s3:GetObject autorisation sur le compartiment de stockage Amazon S3 de l'environnement (elasticbeanstalk-region-account-id). Si votre politique IAM n'inclut pas cette autorisation, l'historique et les événements du déploiement seront toujours disponibles, mais l'onglet journaux affichera une erreur.

Fichiers journaux de déploiement sur les instances

Les journaux de déploiement sont écrits /var/log/deployments/ dans le répertoire de chaque instance. Le nom du fichier journal dépend de la manière dont le déploiement a été déclenché :

  • Déploiements contrôlés par le flux de travail (déclenchés via la console, la CLI ou l'API) —eb-deployment-request-id.log, où request-id est l'ID unique de demande de déploiement.

  • Déploiements à démarrage automatique (lancement d'instance ou redémarrage du serveur d'applications) —. eb-deployment-unix-timestamp.log

Elastic Beanstalk fait automatiquement pivoter ces fichiers, en conservant les 50 journaux de déploiement les plus récents sur chaque instance.

Pour les déploiements contrôlés par le flux de travail, le journal est chargé sur Amazon S3 via le chemin suivant :

s3://elasticbeanstalk-region-account-id/resources/environments/logs/deployments/environment-id/log-filename

Dans les environnements multi-instances, la première instance à commencer le téléchargement revendique le rôle pour l'ensemble du déploiement. Cette instance télécharge son journal sur Amazon S3 pendant toute la durée du déploiement. Toutes les instances continuent d'écrire des journaux de déploiement localement.

Important

Le téléchargement des journaux de déploiement vers Amazon S3 nécessite une s3:PutObject autorisation sur le compartiment de stockage Amazon S3 de l'environnement dans le profil d'instance, et la configuration du VPC doit autoriser la connectivité à Amazon S3.

Les téléchargements du journal de déploiement sont plafonnés à 1 Mo par fichier. Si un journal de déploiement dépasse cette taille, la version téléchargée est tronquée avec un message indiquant que le journal complet est disponible sur l'instance.

Désactiver les téléchargements de journaux S3

Pour empêcher le chargement des journaux de déploiement sur Amazon S3, définissez la propriété d'environnement suivante sur votre environnement :

option_settings:
  - namespace:  aws:elasticbeanstalk:application:environment
    option_name:  EB_DEPLOYMENT_LOG_S3_DISABLED
    value:  true

Lorsque cette propriété d'environnement est définie, les journaux de déploiement sont toujours écrits localement /var/log/deployments/ sur chaque instance, mais ils ne sont pas téléchargés sur Amazon S3 et ne seront pas disponibles dans l'onglet Déploiements de la console. Vous pouvez également définir cette propriété dans la page Configuration sous Logiciel, ou à l'aide de l'EB CLI ou AWS CLI.