View a markdown version of this page

Bereitstellungsprotokolle für eine Elastic Beanstalk Beanstalk-Umgebung anzeigen - AWS Elastic Beanstalk
Unterstützte VorgängeInhalte protokollierenKonsoleInstanz-Protokolldateien

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Bereitstellungsprotokolle für eine Elastic Beanstalk Beanstalk-Umgebung anzeigen

Elastic Beanstalk generiert für jedes Deployment in Ihrer Umgebung ein Deployment-Log. Das Deployment-Log bietet eine konsolidierte, chronologische Ansicht dessen, was während einer Bereitstellung passiert ist, einschließlich der Installation von Abhängigkeiten, der Build-Ausgabe, des Anwendungsstarts und aller aufgetretenen Fehler. Mithilfe von Bereitstellungsprotokollen können Sie fehlgeschlagene Bereitstellungen schnell diagnostizieren, ohne dass Sie per SSH auf Instanzen zugreifen oder mehrere Protokolldateien korrelieren müssen.

Bereitstellungsprotokolle werden lokal in jede Instanz geschrieben. Bei Bereitstellungen, die über die Konsole, CLI, API oder verwaltete Updates ausgelöst werden, lädt eine Instance ihr Protokoll während der Bereitstellung kontinuierlich auf Amazon S3 hoch. Die Elastic Beanstalk Beanstalk-Konsole liest das Protokoll von Amazon S3, sodass Sie den Fortschritt überwachen können, ohne eine Verbindung zur Instance herstellen zu müssen.

Die Bereitstellungsprotokolle sind so konzipiert, dass sie präzise sind. Bei Erfolg zeigt das Protokoll nur zusammenfassende Meldungen an (z. B. welche Befehle ausgeführt und abgeschlossen wurden). Bei einem Fehler enthält das Protokoll bis zu 50 Zeilen mit der Ausgabe des fehlgeschlagenen Schritts, sodass Sie den Fehler erkennen können, ohne die ausführliche Ausgabe durchsuchen zu müssen.

Anmerkung

Bereitstellungsprotokolle sind auf den Plattformversionen Amazon Linux 2 und Amazon Linux 2023 verfügbar, die am oder nach dem 11. März 2026 veröffentlicht wurden. Windows-Plattformen werden derzeit nicht unterstützt.

Unterstützte Vorgänge

Deployment-Logs werden für die folgenden Operationen generiert:

  • Anwendungsbereitstellungen — Bereitstellung einer neuen Anwendungsversion in Ihrer Umgebung.

  • Konfigurationsupdates — Änderung der Umgebungskonfigurationseinstellungen, für die Instanzupdates erforderlich sind.

  • Erstellung einer Umgebung — Die erste Bereitstellung, wenn Sie eine neue Umgebung erstellen.

  • App-Server neu starten — Starten Sie den Anwendungsserver auf Ihren Instanzen neu.

Bei Vorgängen, die den Anwendungs- oder Konfigurationsstatus auf Instanzen nicht ändern, wie z. B. das Anfordern von Protokollen, das Austauschen CNAMEs oder Aktualisieren von Tags, werden keine Bereitstellungsprotokolle generiert.

Inhalt des Bereitstellungsprotokolls

Ein Bereitstellungsprotokoll erfasst die folgenden Informationen während einer Bereitstellung:

  • Bereitstellungslebenszyklus — Start- und Abschlussnachrichten für jede Bereitstellungsphase, z. B. Starting Application deployment undCompleted Application deployment.

  • .ebextensions-Ausgabe — Bei Erfolg die Namen der Befehle, die ausgeführt wurden. Bei einem Fehler die letzten 50 Zeilen der cfn-init Ausgabe, um das Problem zu diagnostizieren.

  • Plattform-Hooks-Ausgabe — Bei Erfolg die Namen der Hook-Skripte, die ausgeführt wurden. Bei einem Fehler werden die letzten 50 Zeilen der Hook-Ausgabe ausgegeben.

  • Installation von Abhängigkeiten — Ausgabe von Paketmanagern wie npm installpip install,composer install, undbundle install. Bei erfolgreicher Ausführung wird nur eine Abschlussmeldung protokolliert. Bei einem Fehler sind die letzten 50 Ausgabezeilen enthalten.

  • Build-Ausgabe — Ausgabe von Build-Befehlen wie docker buildgo build, und Java-Builds. Bei einem Fehler sind die letzten 50 Ausgabezeilen enthalten.

  • Ausgabe beim Start der Anwendung — Erste Ausgabe Ihrer Anwendung nach dem Start. Die Quelle hängt von Ihrer Plattform ab:

    • Docker — Container-Logs von oder docker logs docker compose logs

    • Java SE, Go, Node.js, Python, Ruby, .NET — Standardprotokolle verarbeiten

    • Tomcat — Catalina-Protokollausgabe

    • PHP — PHP-FPM-Master - und Pool-Fehlerprotokolle

    • ECS — Container-Protokolle aus jedem Task-Container

    Anmerkung

    Die Anwendungsausgabe wird ab 2 Sekunden nach dem Start der Anwendung erfasst. Es sind nur die ersten Startmeldungen enthalten. Wenn die Ausgabe Ihrer Anwendung länger dauert, werden sie nicht im Bereitstellungsprotokoll angezeigt. Um die vollständigen Anwendungsprotokolle einzusehen, fordern Sie Bundle-Logs an oder stellen Sie eine direkte Verbindung mit der Instance her. Weitere Informationen finden Sie unter Anzeigen von Instance-Protokollen.

Wenn ein Bereitstellungsschritt fehlschlägt, wird er im Protokoll mit [ERROR] bis zu 50 Zeilen mit der Ausgabe des fehlgeschlagenen Schritts gekennzeichnet. Wenn das Bereitstellungsprotokoll nicht genügend Details enthält, können Sie die vollständigen Instanzprotokolle (einschließlich eb-engine.logeb-hooks.log, und Anwendungsprotokolle) auf der Registerkarte Protokolle abrufen. Weitere Informationen finden Sie unter Protokolle von Amazon EC2-Instances in Ihrer Elastic Beanstalk Umgebung anzeigen.

Bereitstellungsprotokolle in der Konsole anzeigen

Die Elastic Beanstalk Beanstalk-Konsole bietet im Umgebungs-Dashboard einen Tab „Deployments“, auf dem Sie Ihren Bereitstellungsverlauf und Ihre Logs einsehen können.

Bereitstellungsverlauf anzeigen

Um den Bereitstellungsverlauf einzusehen

  1. Öffnen Sie die Elastic Beanstalk Beanstalk-Konsole und wählen Sie in der Liste Regionen Ihre aus. AWS-Region

  2. Wählen Sie im Navigationsbereich Environments (Umgebungen) aus und wählen Sie dann in der Liste den Namen Ihrer Umgebung aus.

  3. Wählen Sie im Umgebungs-Dashboard den Tab Deployments aus.

    Auf der Registerkarte Bereitstellungen wird eine Tabelle mit Bereitstellungen für die Umgebung angezeigt. Jede Zeile enthält die folgenden Informationen:

    • Anforderungs-ID — Die eindeutige Kennung für die Bereitstellung.

    • Status — Erfolgreich, Fehlgeschlagen oder In Bearbeitung.

    • Typ — Der Bereitstellungstyp, z. B. Umgebungserstellung, Anwendungsbereitstellung, Konfigurationsupdate, verwaltetes Plattform-Update, App Server neu starten, Umgebung neu aufbauen, Umgebung wiederherstellen, Umgebungsdomäne austauschen oder Umgebung beenden.

    • Startzeit — Wann die Bereitstellung begann.

    • Dauer — Wie lange es gedauert hat, bis die Bereitstellung abgeschlossen war.

Wenn eine Bereitstellung im Gange ist, fragt die Registerkarte automatisch nach Updates ab. Sie können auch die Schaltfläche „Aktualisieren“ wählen, um die Liste manuell neu zu laden.

Bereitstellungsdetails und -protokolle anzeigen

Um Bereitstellungsdetails anzuzeigen

  1. Wählen Sie auf der Registerkarte Bereitstellungen den Link Anforderungs-ID für die Bereitstellung aus, die Sie überprüfen möchten.

  2. Auf der Seite mit den Bereitstellungsdetails wird eine Zusammenfassung mit der Anforderungs-ID, dem Status, dem Bereitstellungstyp, der Startzeit, der Dauer und der Bereitstellungsrichtlinie angezeigt. Die Bereitstellungsrichtlinie (z. B. „Alles auf einmal“, „Rollend“, „Rollend“ mit zusätzlichem Batch, „Unveränderlich“ oder „Traffic Splitting“) wird angezeigt, wenn sie anhand der Bereitstellungsereignisse ermittelt werden kann.

  3. Wählen Sie unter der Zusammenfassung eine der folgenden Registerkarten aus:

    • Ereignisse — Eine Zeitleiste mit Ereignissen im Zusammenhang mit dieser Bereitstellung, die so gefiltert wurde, dass nur Ereignisse für die ausgewählte Bereitstellung angezeigt werden.

    • Bereitstellungsprotokolle — Das konsolidierte Bereitstellungsprotokoll der Instance. Sie können die Protokolldatei suchen, nach Protokollebene filtern und herunterladen.

Bei laufenden Bereitstellungen wird die Registerkarte „Protokolle“ automatisch aktualisiert, sodass neue Protokolleinträge angezeigt werden, während sie geschrieben werden. Nach Abschluss einer Bereitstellung ruft die Konsole den endgültigen Protokollstatus ab, um sicherzustellen, dass Sie die vollständige Ausgabe sehen.

Wichtig

Für das Anzeigen von Bereitstellungsprotokollen in der Konsole ist eine s3:GetObject Genehmigung für den Amazon S3 S3-Speicher-Bucket der Umgebung erforderlich (elasticbeanstalk-region-account-id). Wenn Ihre IAM-Richtlinie diese Berechtigung nicht beinhaltet, sind der Bereitstellungsverlauf und die Ereignisse weiterhin verfügbar, aber auf der Registerkarte „Protokolle“ wird ein Fehler angezeigt.

Bereitstellungsprotokolldateien auf Instanzen

Bereitstellungsprotokolle werden in das /var/log/deployments/ Verzeichnis jeder Instance geschrieben. Der Protokolldateiname hängt davon ab, wie die Bereitstellung ausgelöst wurde:

  • Workflow-gesteuerte Bereitstellungen (ausgelöst über die Konsole, CLI oder API) —eb-deployment-request-id.log, wo request-id ist die eindeutige Bereitstellungsanforderungs-ID.

  • Selbststartende Bereitstellungen (Instanzstart oder Neustart des App-Servers) —. eb-deployment-unix-timestamp.log

Elastic Beanstalk rotiert diese Dateien automatisch und behält die 50 neuesten Deployment-Logs für jede Instance bei.

Für Workflow-gesteuerte Bereitstellungen wird das Protokoll unter dem folgenden Pfad in Amazon S3 hochgeladen:

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

In Umgebungen mit mehreren Instanzen beansprucht die erste Instance, die mit dem Hochladen beginnt, die Rolle für die gesamte Bereitstellung. Diese Instance lädt ihr Protokoll für die Dauer der Bereitstellung auf Amazon S3 hoch. Alle Instances schreiben weiterhin Bereitstellungsprotokolle lokal.

Wichtig

Für das Hochladen von Bereitstellungsprotokollen auf Amazon S3 ist eine s3:PutObject Genehmigung für den Amazon S3-Speicher-Bucket der Umgebung im Instance-Profil erforderlich, und die VPC-Konfiguration muss die Konnektivität zu Amazon S3 zulassen.

Das Hochladen von Bereitstellungsprotokollen ist auf 1 MB pro Datei begrenzt. Wenn ein Bereitstellungsprotokoll diese Größe überschreitet, wird die hochgeladene Version gekürzt und es wird eine Meldung angezeigt, dass das vollständige Protokoll auf der Instanz verfügbar ist.

S3-Protokoll-Uploads deaktivieren

Um zu verhindern, dass Bereitstellungsprotokolle auf Amazon S3 hochgeladen werden, legen Sie die folgende Umgebungseigenschaft für Ihre Umgebung fest:

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

Wenn diese Umgebungseigenschaft festgelegt ist, werden Bereitstellungsprotokolle weiterhin lokal /var/log/deployments/ auf jeder Instance geschrieben, aber sie werden nicht auf Amazon S3 hochgeladen und sind nicht auf der Registerkarte Deployments in der Konsole verfügbar. Sie können diese Eigenschaft auch auf der Konfigurationsseite unter Software oder mithilfe der EB-CLI oder festlegen AWS CLI.