eb logs

Beschreibung

Der eb logs-Befehl hat zwei verschiedene Zwecke: zum Aktivieren oder Deaktivieren von Protokoll-Streaming nach CloudWatch Logs und zum Abrufen von Instance-Protokollen oder CloudWatch Logs-Protokollen. Mit der Option --cloudwatch-logs (-cw) aktiviert oder deaktiviert der Befehl das Protokoll-Streaming. Ohne diese Option werden Protokolle abgerufen.

Beim Abrufen der Protokolle geben Sie die Option --all, --zip oder --stream an, um vollständige Protokolle abzurufen. Wenn Sie keine dieser Optionen angeben, ruft Elastic Beanstalk Protokollfragmente ab.

Der Befehl verarbeitet Protokolle für die angegebene oder die Standardumgebung. Die entsprechenden Protokolle sind je nach Containertyp unterschiedlich. Falls im Stammverzeichnis eine platform.yaml-Datei enthalten ist, die eine benutzerdefinierte Plattform angibt, verarbeitet dieser Befehl auch die Protokolle für die Builder-Umgebung.

Weitere Informationen finden Sie unter Verwenden von Elastic Beanstalk mit Amazon CloudWatch Logs.

Syntax

So aktivieren oder deaktivieren Sie das Protokoll-Streaming in CloudWatch Logs:

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

So rufen Sie Instance-Protokolle ab:

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

So rufen Sie Umgebungszustand-Protokolle ab:

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

Optionen

Name	Beschreibung
-cw [enable | disable] oder --cloudwatch-logs [enable | disable]	Aktiviert oder deaktiviert das Streaming von Protokollen in CloudWatch Logs. Falls kein Argument angegeben wird, ist das Streaming der Protokolle aktiviert. Wenn die Option --cloudwatch-log-source (-cls) nicht zusätzlich angegeben ist, ist das Instance-Protokoll-Streaming aktiviert oder deaktiviert.
-cls instance | environment-health | all oder --cloudwatch-log-source instance | environment-health | all	Gibt die Quelle für Protokolle bei der Arbeit mit CloudWatch Logs an. Mit der Aktivierungs- oder Deaktivierungsform des Befehls sind dies die Protokolle, für die das CloudWatch Logs-Streaming aktiviert oder deaktiviert werden soll. Mit der Abrufform des Befehls sind dies die Protokolle, die aus CloudWatch Logs abgerufen werden sollen. Zulässige Werte: Mit --cloudwatch-logs (Aktivieren oder Deaktivieren) – instance | environment-health | all Ohne --cloudwatch-logs (Abrufen) – instance | environment-health Bedeutungen der Werte: instance (Standard) – Instance-Protokolle environment-health – Umgebungszustand-Protokolle (wird nur unterstützt, wenn erweiterte Zustandsberichte in der Umgebung aktiviert sind) all – Beide Protokollquellen
-a oder --all	Ruft vollständige Protokolle ab und speichert sie im Verzeichnis .elasticbeanstalk/logs.
-z oder --zip	Ruft vollständige Protokolle ab, komprimiert sie in einer .zip-Datei und speichert diese im Verzeichnis .elasticbeanstalk/logs.
--stream	Streamt vollständige Protokolle (fortlaufende Ausgaben). Mit dieser Option wird der Befehl ausgeführt, bis Sie ihn abbrechen (drücken Sie hierzu Ctrl+C).
-i instance-id oder --instance instance-id	Ruft nur Protokolle für die angegebene Instance ab.
-g log-group oder --log-group log-group	Gibt die CloudWatch Logs-Protokollgruppe an, aus der Protokolle abgerufen werden sollen. Die Option ist nur gültig, wenn das Instance-Protokoll-Streaming in CloudWatch Logs aktiviert ist. Wenn das Instance-Protokoll-Streaming aktiviert ist und Sie nicht die --log-group-Option angeben, ist die Standard-Protokollgruppe eine der folgenden: Amazon Linux 2 – /aws/elasticbeanstalk/environment-name/var/log/eb-engine.log Windows-Plattform – /aws/elasticbeanstalk/environment-name/EBDeploy-Log Amazon Linux AMI (AL1) – /aws/elasticbeanstalk/environment-name/var/log/eb-activity.log Anmerkung Am 18. Juli 2022 stellte Elastic Beanstalk den Status aller Plattformzweige auf Basis von Amazon-Linux-AMI (AL1) auf außer Betrieb genommen. Weitere Informationen zur Migration zu einem aktuellen und vollständig unterstützten Plattformzweig für Amazon Linux 2023 finden Sie unter Migrieren der Elastic-Beanstalk-Linux-Anwendung zu Amazon Linux 2023 oder Amazon Linux 2. Weitere Informationen über die Protokollgruppe für jede Protokolldatei finden Sie unter Wie Elastic Beanstalk CloudWatch Logs einrichtet.
Allgemeine Optionen

Ausgabe

Standardmäßig werden die Protokolle direkt im Terminal angezeigt. Verwendet ein Paginierungs-Programm, um die Ausgabe anzuzeigen. Drücken Sie zum Beenden Q oder q.

Zeigt mit --stream vorhandene Protokolle im Terminal an und führt sie weiterhin aus. Drücken Sie Ctrl+C zum Beenden.

Speichert mit --all und --zip die Protokolle in lokalen Dateien und zeigt den Speicherort der Datei.

Beispiele

Das folgende Beispiel aktiviert das Streaming von Instance-Protokollen in 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.

Das folgende Beispiel ruft die Instance-Protokolle in eine .zip Datei ab.

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