eb logs

Description

La commande eb logs a deux finalités distinctes : activer ou désactiver le streaming de journaux vers CloudWatch Logs, et récupérer les journaux d'instance ou les journaux CloudWatch Logs. Avec l'option --cloudwatch-logs (-cw), la commande active ou désactive le streaming de journaux. Sans cette option, elle récupère les journaux.

En cas de récupération des journaux, spécifiez l'option --all ou --zip, --stream pour récupérer les journaux complets. Si vous ne spécifiez aucune de ces options, Elastic Beanstalk récupère les journaux de queue.

La commande traite les journaux associés à l'environnement par défaut ou l'environnement spécifié. Les journaux concernés varient selon le type de conteneur. Si le répertoire racine contient un fichier platform.yaml spécifiant une plateforme personnalisée, cette commande traite également les journaux associés à l'environnement de génération.

Pour de plus amples informations, veuillez consulter Utilisation d'Elastic Beanstalk avec Amazon CloudWatch Logs.

Syntaxe

Pour activer ou désactiver le streaming de journaux dans CloudWatch Logs :

eb logs --cloudwatch-logs [enable | disable] [--cloudwatch-log-source instance | environment-health | all] [environment-name]

Pour récupérer des journaux d'instance :

eb logs [-all | --zip | --stream] [--cloudwatch-log-source instance] [--instance instance-id] [--log-group log-group] [environment-name]

Pour extraire les journaux d'intégrité de l'environnement :

eb logs [-all | --zip | --stream] --cloudwatch-log-source environment-health [environment-name]

Options

Name (Nom)	Description
-cw [enable | disable] ou --cloudwatch-logs [enable | disable]	Active ou désactive le streaming de journaux dans CloudWatch Logs. Si aucun argument n'est fourni, le streaming de journaux est activé. Si l'option --cloudwatch-log-source (-cls) n'est pas ajoutée, le streaming des journaux d'instance est activé ou désactivé.
-cls instance | environment-health | all ou --cloudwatch-log-source instance | environment-health | all	Spécifie la source des journaux lors de l'utilisation de CloudWatch Logs. Si l'on utilise l'option d'activation ou de désactivation de la commande, ce sont les journaux pour lesquels vous activez ou désactivez le streaming dans CloudWatch Logs. Si l'on utilise l'option d'extraction de la commande, ce sont les journaux qui sont récupérés à partir de CloudWatch Logs. Valeurs valides : Avec --cloudwatch-logs (activation ou désactivation) - instance | environment-health | all Sans --cloudwatch-logs (extraction) - instance | environment-health Significations des valeurs : instance (valeur par défaut) - Journaux d'instance environment-health - Journaux d'intégrité d'environnement (uniquement pris en charge lorsque la fonction d'intégrité améliorée est activée dans l'environnement) all - Les deux sources de journaux
-a ou --all	Récupère les journaux complets et les enregistre dans le répertoire .elasticbeanstalk/logs.
-z ou --zip	Récupère les journaux complets, les compresse dans un fichier .zip, puis enregistre le fichier dans le répertoire .elasticbeanstalk/logs.
--stream	Diffuse (sorties en continu) les journaux complets. Avec cette option, la commande poursuit son exécution jusqu'à ce que vous l'interrompiez (appuyez sur Ctrl+C).
-i instance-id ou --instance instance-id	Extrait les journaux de l'instance spécifiée uniquement.
-g log-group ou --log-group log-group	Spécifie le groupe de journaux CloudWatch Logs à partir duquel extraire les journaux. L'option est valide uniquement lorsque le streaming des journaux d'instance dans CloudWatch Logs est activé. Si le streaming des journaux d'instance est activé et que vous ne spécifiez pas l'option --log-group, le groupe de journaux par défaut est l'un des suivants : Amazon Linux 2 : /aws/elasticbeanstalk/environment-name/var/log/eb-engine.log Plateformes Windows – /aws/elasticbeanstalk/environment-name/EBDeploy-Log AMI Amazon Linux (AL1) : /aws/elasticbeanstalk/environment-name/var/log/eb-activity.log Note Le 18 juillet 2022, Elastic Beanstalk définira les statuts de toutes les branches de plateforme basées sur une AMI Amazon Linux (AL1) sur mise hors service. Pour plus d'informations sur la migration vers une branche de plateforme Amazon Linux 2023 actuelle et entièrement prise en charge, consultez Migration de votre application Elastic Beanstalk Linux vers Amazon Linux 2023 ou Amazon Linux 2. Pour plus d'informations sur le groupe de journaux correspondant à chaque fichier journal, consultez Méthode de configuration de CloudWatch Logs par Elastic Beanstalk.
Options courantes

Sortie

Par défaut, affiche les journaux directement sur le terminal. Utilise un programme de pagination pour afficher la sortie. Appuyez sur Q ou q pour quitter.

Avec --stream, affiche les journaux existants sur le terminal et poursuit son exécution. Appuyez sur Ctrl+C pour quitter.

Avec --all et --zip, enregistre les journaux dans des fichiers locaux et affiche l'emplacement des fichiers.

Exemples

L'exemple suivant active le streaming des journaux d'instance dans CloudWatch Logs.

$ eb logs -cw enable
Enabling instance log streaming to CloudWatch for your environment
After the environment is updated you can view your logs by following the link:
https://console.aws.amazon.com/cloudwatch/home?region=us-east-1#logs:prefix=/aws/elasticbeanstalk/environment-name/
Printing Status:
2018-07-11 21:05:20    INFO: Environment update is starting.
2018-07-11 21:05:27    INFO: Updating environment environment-name's configuration settings.
2018-07-11 21:06:45    INFO: Successfully deployed new configuration to environment.

L'exemple suivant extrait les journaux d'instance dans un fichier .zip.

$ eb logs --zip
Retrieving logs...
Logs were saved to /home/workspace/environment/.elasticbeanstalk/logs/150622_173444.zip