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-Umgebung anzeigen

Elastic Beanstalk generiert für jede Bereitstellung in Ihrer Umgebung ein Bereitstellungsprotokoll. Das Bereitstellungsprotokoll bietet einen konsolidierten Überblick darüber, was während einer Bereitstellung passiert ist, sodass Sie einen Fehler diagnostizieren können, ohne selbst mehrere Protokolle sammeln zu müssen. Was das Protokoll enthält und wann es verfügbar ist, hängt davon ab, ob es sich bei der Umgebung um eine Beanstalk Standard-Umgebung oder eine Beanstalk Cluster-Umgebung handelt.

Bei Beanstalk Standard werden Bereitstellungsprotokolle 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-Konsole liest das Protokoll von Amazon S3, sodass Sie den Fortschritt überwachen können, ohne eine Verbindung zur Instance herstellen zu müssen.

Standard-Bereitstellungsprotokolle sind so konzipiert, dass sie übersichtlich 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 Ausgabezeilen des fehlgeschlagenen Schritts, sodass Sie den Fehler sehen können, ohne sich die ausführliche Ausgabe ansehen zu müssen.

Bei Beanstalk Cluster erfasst Elastic Beanstalk das Bereitstellungsprotokoll, nachdem der Vorgang abgeschlossen ist. Es sammelt die Container-Protokolle aller Pods in der Umgebung zusammen mit den Kubernetes-Ereignissen für den Namespace der Umgebung und lädt sie als einzelne ZIP-Datei in den Amazon S3-Speicher-Bucket Ihrer Umgebung hoch. Die Elastic Beanstalk-Konsole liest die ZIP-Datei aus Amazon S3 und zeigt ihren Inhalt an, sodass Sie sie lesen können, ohne eine Verbindung zu Ihrem Cluster herzustellen. Die Verfügbarkeit hängt nicht von der Plattformversion ab, und Elastic Beanstalk schreibt keine Bereitstellungsprotokolldatei auf Ihre Knoten.

Unterstützte Vorgänge

Für Beanstalk Standard-Umgebungen werden Bereitstellungsprotokolle für die folgenden Vorgänge generiert:

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

Für Beanstalk Cluster-Umgebungen werden Bereitstellungsprotokolle für die Umgebungserstellung, Anwendungsbereitstellungen, Konfigurationsupdates, den Neustart des Anwendungsservers und das Beenden der Umgebung generiert. Beim Beenden einer Umgebung wird ein Bereitstellungsprotokoll erstellt, was bei Beanstalk Standard nicht der Fall ist. Verwaltete Plattformupdates gelten nicht, da in einer Beanstalk Cluster-Umgebung Container-Images statt einer Plattformversion ausgeführt werden.

Elastic Beanstalk erfasst nach dem Bereitstellungsschritt das Bereitstellungsprotokoll einer Beanstalk-Cluster-Umgebung. Wenn ein Vorgang vor diesem Schritt fehlschlägt, beispielsweise beim Erstellen des Container-Images, beim Erstellen des Clusters, beim Bereitstellen von Ressourcen oder beim Generieren der Kubernetes-Spezifikation, gibt es kein Bereitstellungsprotokoll, und die Ereignisse der Umgebung beschreiben, was passiert ist. Weitere Informationen finden Sie unter Ereignis-Stream einer Elastic Beanstalk-Umgebung anzeigen.

Inhalt des Bereitstellungsprotokolls

In Beanstalk Standard-Umgebungen erfasst ein Bereitstellungsprotokoll die folgenden Informationen während einer Bereitstellung:

Wenn ein Bereitstellungsschritt fehlschlägt, wird er im Protokoll mit [ERROR] bis zu 50 Ausgabezeilen 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.

Inhalt des Bereitstellungsprotokolls für Beanstalk-Cluster-Umgebungen

Für eine Beanstalk Cluster-Umgebung ist das Bereitstellungsprotokoll eine Zip-Datei. Es enthält eine umgebungsweite Ereignisdatei und eine Datei pro Pod in einem Verzeichnis: 1-environment/

1-environment/
  _k8Events.txt
  pod-name.txt

_k8Events.txtenthält die Kubernetes-Ereignisse im Namespace der Umgebung, die nicht an einen einzelnen Pod gebunden sind, wie z. B. Scheduling-, Volume-, Skalierungs- und Load Balancer-Ereignisse. Der führende Unterstrich sortiert es zuerst.

Jeder Block pod-name.txt beginnt mit einem =====EVENTS===== Block, der die Ereignisse dieses Pods enthält, wobei der älteste zuerst steht, gefolgt von einem =====LOGS===== Block, der die Protokolle der einzelnen Container im Pod enthält. Init-Container werden als eigene Container-Blöcke angezeigt. Wenn also ein Init-Container ausfällt, wird eher ein leeres Protokoll für den Anwendungscontainer erwartet als ein zweites Problem.

Für einen Container, der neu gestartet wird, benennt der =====EVENTS===== Block dieses Pods den Grund (zum BeispielBackOff), und der =====LOGS===== Block enthält das Protokoll des Containers zum Zeitpunkt der Erfassung. Das Protokoll einer früheren Instanz des Containers ist nicht enthalten.

Das Protokoll jedes Containers ist auf 5 MiB begrenzt, es gibt keine Zeilenbegrenzung. Ein Protokoll, das die Obergrenze erreicht, wird als gekürzt markiert. Abgesehen von dieser Obergrenze wird nichts aus dem Protokoll entfernt, unabhängig davon, ob der Vorgang erfolgreich war oder fehlschlägt. Wenn Elastic Beanstalk die Logs eines Containers nicht lesen kann, wird die Erfassung fortgesetzt und der Block dieses Containers zeichnet den Fehler auf.

Die Installation einer Abhängigkeit und die Build-Ausgabe sind nicht im Bereitstellungsprotokoll einer Beanstalk-Cluster-Umgebung enthalten. Diese passieren, wenn Elastic Beanstalk Ihr Container-Image erstellt. Weitere Informationen finden Sie unter Erstellen von Container-Images für Beanstalk Cluster-Umgebungen.

Bereitstellungsprotokolle in der Konsole anzeigen

Die Elastic Beanstalk-Konsole bietet im Umgebungs-Dashboard die Registerkarte „Bereitstellungen“, auf der Sie Ihren Bereitstellungsverlauf und Ihre Protokolle einsehen können. Der Bereitstellungsverlauf zeigt Bereitstellungen der letzten 42 Tage (6 Wochen).

Bereitstellungsverlauf anzeigen

Wenn eine Bereitstellung im Gange ist, fragt der Tab automatisch nach Updates. Sie können auch auf die Schaltfläche „Aktualisieren“ klicken, um die Liste manuell neu zu laden.

Bereitstellungsdetails und Protokolle anzeigen

Bei laufenden Bereitstellungen in einer Beanstalk Standardumgebung wird die Registerkarte „Protokolle“ automatisch aktualisiert und zeigt neue Protokolleinträge an, sobald sie geschrieben werden. Nach Abschluss einer Bereitstellung ruft die Konsole den endgültigen Protokollstatus ab, um sicherzustellen, dass Sie die vollständige Ausgabe sehen.

In einer Beanstalk Cluster-Umgebung wird das Bereitstellungsprotokoll nach Abschluss des Vorgangs angezeigt, sodass die Registerkarte „Protokolle“ während der Ausführung des Vorgangs nicht aktualisiert wird. Die umgebungsweite Ereignisdatei wird zuerst angezeigt, gefolgt von den Dateien pro Pod. Wenn die komprimierte ZIP-Datei größer als 5 MiB ist, werden Sie von der Konsole aufgefordert, sie von Amazon S3 herunterzuladen, anstatt sie anzuzeigen. Dieses Limit gilt für das gesamte Archiv, nicht für das Protokoll eines einzelnen Containers.

Wo werden Bereitstellungsprotokolle gespeichert

Bereitstellungsprotokolldateien auf Beanstalk Standard-Instances

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

Elastic Beanstalk rotiert diese Dateien automatisch und speichert die 50 neuesten Bereitstellungsprotokolle für jede Instance.

Für workflowgesteuerte Bereitstellungen wird das Protokoll unter dem folgenden Pfad auf Amazon S3 hochgeladen:

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

Bei Bereitstellungen mit Eigenstart wird das Protokoll in einem Unterverzeichnis auf Amazon S3 hochgeladen: selfstartup/

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

Bei workflowgesteuerten Bereitstellungen beansprucht die erste Instanz, 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. Bei Selbststartbereitstellungen lädt jede Instance unabhängig ihr eigenes Protokoll hoch. Alle Instanzen schreiben weiterhin lokal Bereitstellungsprotokolle.

Das Hochladen von Bereitstellungsprotokollen ist auf 1 MB pro Datei begrenzt. Wenn ein Bereitstellungsprotokoll diese Größe überschreitet, wird die hochgeladene Version mit einer Meldung gekürzt, die darauf hinweist, dass das vollständige Protokoll auf der Instance verfügbar ist.

S3-Log-Uploads werden deaktiviert

Um zu verhindern, dass Bereitstellungsprotokolle in Amazon S3 hochgeladen werden, legen Sie für Beanstalk Standard-Umgebungen die folgende Umgebungseigenschaft in Ihrer Umgebung fest:

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

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

Die EB_DEPLOYMENT_LOG_S3_DISABLED Eigenschaft wird auf Ihren Instances gelesen, sodass sie keine Auswirkung auf eine Beanstalk Cluster-Umgebung hat. Derzeit gibt es keine Möglichkeit, Elastic Beanstalk daran zu hindern, das Bereitstellungsprotokoll einer Beanstalk-Cluster-Umgebung hochzuladen.

Bereitstellungsprotokolldateien für Beanstalk Cluster-Umgebungen

Für eine Beanstalk-Cluster-Umgebung lädt Elastic Beanstalk das Bereitstellungsprotokoll unter dem folgenden Pfad in den Amazon S3-Speicher-Bucket Ihrer Umgebung hoch:

s3://elasticbeanstalk-region-account-id/resources/environments/logs/deployments/environment-id/deployment-environment-name-request-id.zip

Elastic Beanstalk führt den Upload selbst durch und verwendet dabei die Betriebsrolle der Umgebung, sodass keine Berechtigung für das Instance-Profil erforderlich ist und nichts Amazon S3 von Ihren Knoten aus erreichen muss.

Der Upload erfolgt nach bestem Wissen und Gewissen. Wenn der Vorgang nicht erfolgreich ist, wird der Vorgang trotzdem abgeschlossen, es wird kein Umgebungsereignis generiert, und die Konsole meldet, dass das Bereitstellungsprotokoll nicht verfügbar ist.