

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.

# Fehlerbehebung in Ihrer Elastic Beanstalk Beanstalk-Umgebung
<a name="troubleshooting"></a>

Dieses Kapitel enthält Anleitungen zur Behebung von Problemen mit Ihrer Elastic-Beanstalk-Umgebung. Diese umfasst das Folgende:
+ Eine Einführung in AWS Systems Manager, einschließlich eines Verfahrens zur Ausführung vordefinierter Elastic Beanstalk Beanstalk-Runbooks, die Schritte und Empfehlungen zur Fehlerbehebung ausgeben.
+ Allgemeine Hinweise zu Aktionen und Ressourcen, die Sie verwenden können, wenn sich der Status Ihrer Umgebung verschlechtert.
+ Spezifische Tipps zur Fehlerbehebung, geordnet nach Kategorien.

**Wenn sich der Zustand Ihrer Umgebung auf Rot ändert, empfehlen wir Ihnen, zunächst das AWS Systems Manager Tool zu** verwenden, das vordefinierte Runbooks enthält, um Probleme mit Elastic Beanstalk zu beheben. Weitere Informationen finden Sie unter [ Verwenden des Systems-Manager-Tools](#troubleshooting-systems-manager).

**Testen Sie Amazon Q Developer CLI für KI-gestützte Problembehebung**  
 Amazon Q Developer CLI kann Ihnen helfen, Umgebungsprobleme schnell zu beheben. Die Q CLI bietet Lösungen, indem sie den Umgebungsstatus überprüft, Ereignisse überprüft, Protokolle analysiert und klärende Fragen stellt. Weitere Informationen und detaillierte Anleitungen finden Sie in den Blogs unter [Troubleshooting Elastic Beanstalk Environments with Amazon Q Developer CLI](https://aws.amazon.com/blogs/devops/troubleshooting-elastic-beanstalk-environments-with-amazon-q-developer-cli/). AWS 

**Topics**
+ [Mithilfe von KI-gestützter Umgebungsanalyse](#troubleshooting-ai-analysis)
+ [AWS Systems Manager Elastic Beanstalk Beanstalk-Runbooks verwenden](#troubleshooting-systems-manager)
+ [Allgemeine Hinweise zur Fehlerbehebung in Ihrer Elastic Beanstalk Beanstalk-Umgebung](#troubleshooting-general)
+ [Umgebungen, die mit Umgebungsvariablen auf Geheimnisse und Parameter zugreifen](#troubleshooting-secrets-env-variables)
+ [Umgebungserstellung und Instance-Starts](#troubleshooting-envcreate)
+ [Bereitstellungen](#troubleshooting-deployments)
+ [Gesundheit](#troubleshooting-health)
+ [Umgebungen mit konfigurierten Dual-Stack-Load Balancern](#troubleshooting-dual-stack-load-balancer)
+ [Konfiguration](#troubleshooting-configuration)
+ [Fehlerbehebung bei Docker-Containern](#troubleshooting-docker)
+ [Häufig gestellte Fragen](#troubleshooting-faq)
+ [Häufige Fehler](#common-errors)
+ [Fehler bei der Bereitstellung](#python-common-troubleshooting)

## Mithilfe von KI-gestützter Umgebungsanalyse
<a name="troubleshooting-ai-analysis"></a>

Elastic Beanstalk bietet KI-gestützte Analysen, um die Grundursachen zu identifizieren und Lösungen für umweltbedingte Gesundheitsprobleme zu empfehlen. Sie können auf diese Funktion über die **KI-Analyseschaltfläche** der Konsole zugreifen, indem Sie die Elastic Beanstalk Beanstalk-API über die oder durch die AWS CLI Ausführung **eb logs --analyze** mit der EB-CLI verwenden. Bei der Analyse werden die Protokolle, Ereignisse und der Instanzstatus Ihrer Umgebung untersucht, um kritische Probleme zu identifizieren und Empfehlungen step-by-step zur Fehlerbehebung zu geben.

Weitere Informationen finden Sie unter [KI-gestützte Umgebungsanalyse](health-ai-analysis.md).

## AWS Systems Manager Elastic Beanstalk Beanstalk-Runbooks verwenden
<a name="troubleshooting-systems-manager"></a>

Sie können Systems Manager verwenden, um Probleme in Ihren Elastic-Beanstalk-Umgebungen zu beheben. Um Ihnen den Einstieg zu erleichtern, stellt Systems Manager vordefinierte Automatisierungs-Runbooks für Elastic Beanstalk bereit. Ein Automatisierungs-Runbook ist eine Art von Systems-Manager-Dokument, das Aktionen definiert, die auf den Instances und anderen AWS -Ressourcen Ihrer Umgebung ausgeführt werden sollen.

Bei dem Dokument `AWSSupport-TroubleshootElasticBeanstalk` handelt es sich um ein Automatisierungs-Runbook, mit dem Sie eine Reihe gängiger Probleme identifizieren können, die Ihre Elastic-Beanstalk-Umgebung beeinträchtigen können. Zu diesem Zweck werden Komponenten Ihrer Umgebung überprüft, darunter die folgenden: EC2-Instances, die VPC, der CloudFormation Stack, Load Balancer, Auto Scaling Scaling-Gruppen und die Netzwerkkonfiguration, die mit Sicherheitsgruppenregeln, Routentabellen und verknüpft ist. ACLs

Es gibt auch die Möglichkeit, gebündelte Protokolldateien aus Ihrer Umgebung zu  AWS -Support hochzuladen.

Weitere Informationen finden Sie unter [https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-awssupport-troubleshoot-elastic-beanstalk.html](https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-awssupport-troubleshoot-elastic-beanstalk.html) in der *Referenz zum AWS Systems Manager -Automation-Runbook*.

**Verwenden Sie Systems Manager, um `AWSSupport-TroubleshootElasticBeanstalk` Runbook auszuführen**
**Anmerkung**  
Führen Sie dieses Verfahren in derselben Umgebung aus, in der AWS-Region sich Ihre Elastic Beanstalk Beanstalk-Umgebung befindet.

1. Öffnen Sie die [AWS Systems Manager-Konsole](https://console.aws.amazon.com/systems-manager/home). 

1. Wählen Sie im Navigationsbereich im Abschnitt **Änderungsmanagement** **Automatisierung** aus.

1. Wählen Sie **Automatisierung ausführen**.

1. Auf der Registerkarte **Owned by Amazon** geben Sie in das Suchfeld für **Automatisierungsdokumente** `AWSSupport-TroubleshootElasticBeanstalk` ein.

1. **Wählen Sie die **AWSSupport-TroubleshootElasticBeanstalk**Karte aus und klicken Sie dann auf Weiter.**

1. Wählen Sie **Ausführen aus**.

1. Im Abschnitt **Eingabeparameter**:

   1. Wählen Sie aus der **AutomationAssumeRole**Dropdownliste den ARN der Rolle aus, mit der Systems Manager Aktionen in Ihrem Namen ausführen kann.

   1. Geben Sie für **ApplicationName**den Namen der Elastic Beanstalk Beanstalk-Anwendung ein.

   1. Geben Sie als **Umgebungsname** die Elastic-Beanstalk-Umgebung ein.

   1. (Optional) Geben Sie für **S3** einen Link einUploaderLink, wenn Ihnen ein AWS Support-Techniker einen S3-Link für die Protokollerfassung zur Verfügung gestellt hat.

1. Wählen Sie **Ausführen**.

   Wenn einer der Schritte fehlschlägt, wählen Sie den Link in der Spalte **Schritt-ID** für den Schritt aus, der fehlgeschlagen ist. Daraufhin wird eine **Ausführungsdetailseite** für den Schritt angezeigt. In **VerificationErrorMessage**diesem Abschnitt wird eine Zusammenfassung der Schritte angezeigt, die Aufmerksamkeit erfordern. `IAMPermissionCheck` könnte zum Beispiel eine Warnmeldung anzeigen. In diesem Fall könnten Sie überprüfen, ob die in der **AutomationAssumeRole**Dropdownliste ausgewählte Rolle über die erforderlichen Berechtigungen verfügt.

Nachdem alle Schritte erfolgreich abgeschlossen wurden, enthält die Ausgabe Schritte zur Fehlerbehebung und Empfehlungen, mit denen Sie Ihre Umgebung wieder in einen einwandfreien Zustand versetzen können.

## Allgemeine Hinweise zur Fehlerbehebung in Ihrer Elastic Beanstalk Beanstalk-Umgebung
<a name="troubleshooting-general"></a>

Fehlermeldungen können auf der Seite Ereignisse in der Konsole, in Protokollen oder auf der Seite Zustand erscheinen. Sie können auch Maßnahmen ergreifen, um eine beeinträchtigte Umgebung wiederherzustellen, die durch eine kürzlich erfolgte Änderung verursacht wurde. Ändert sich der Zustand der Umgebung zu Rot, führen Sie die folgenden Schritte aus:
+ Fordern Sie eine KI-gestützte Analyse Ihrer Umgebung an. Weitere Informationen finden Sie unter [KI-gestützte Umgebungsanalyse](health-ai-analysis.md).
+ Wenn bei einem Vorgang in Ihrer Umgebung ein Fehler zurückgegeben wird, der den Text enthält`The stack stack_id associated with environment environment-ID is in stack-status state`, finden Sie Hilfe [Wiederherstellung Ihrer Elastic Beanstalk Beanstalk-Umgebung aus einem ungültigen Zustand](environment-management-invalid-stack.md) zur Fehlerbehebung unter.
+ Wenn ein Vorgang in Ihrer Umgebung einen Fehler zurückgibt, der den Text enthält`Environment environment-name associated CloudFormation stack stack_arn does not exist`, beenden Sie Ihre Umgebung und erstellen Sie eine neue.
+ Überprüfen Sie die letzten [Ereignisse](using-features.events.md) in der Umgebung. Hier finden Sie häufig Meldungen von Elastic Beanstalk zu Bereitstellungs-, Auslastungs- und Konfigurationsproblemen.
+ Überprüfen Sie den aktuellen [Umweltänderungsverlauf](using-features.changehistory.md). Der Änderungsverlauf listet alle Konfigurationsänderungen auf, die an Ihren Umgebungen vorgenommen wurden, und enthält weitere Informationen, z. B. welche IAM-Benutzer Änderungen vorgenommen hat und welche Konfigurationsparameter festgelegt wurden.
+ [Rufen Sie die Protokolle auf](using-features.logging.md) und sehen Sie sich die letzten Protokolldateieinträge an. Die Webserverprotokolle können Informationen zu eingehenden Anforderungen und Fehlern enthalten.
+ [Stellen Sie die Verbindung zu einer Instance](using-features.ec2connect.md) her und überprüfen Sie die Systemressourcen.
+ Stellen Sie eine vorherige funktionierende Version der Anwendung [wieder her](using-features.deploy-existing-version.md).
+ Machen Sie die letzten Konfigurationsänderungen rückgängig oder stellen Sie eine [gespeicherte Konfiguration](environment-configuration-methods-before.md#configuration-options-before-savedconfig) wieder her.
+ Stellen Sie eine neue Umgebung bereit. Wenn diese Umgebung stabil wirkt, führen Sie einen [CNAME-Austausch](using-features.CNAMESwap.md) durch, um den Datenverkehr in die neue Umgebung umzuleiten, und setzen Sie die Fehlerbehebung in der vorherigen Umgebung fort.

## Umgebungen, die mit Umgebungsvariablen auf Geheimnisse und Parameter zugreifen
<a name="troubleshooting-secrets-env-variables"></a>

**Ereignis: Bei** der *Instanzbereitstellung konnten ein oder mehrere Geheimnisse nicht abgerufen* werden

Diese Meldung weist darauf hin, dass Elastic Beanstalk eines oder mehrere der während der Anwendungsbereitstellung angegebenen Geheimnisse nicht abrufen konnte.
+ Überprüfen Sie, ob die durch die ARN-Werte in Ihrer Umgebungsvariablenkonfiguration angegebenen Ressourcen vorhanden sind. 
+ Vergewissern Sie sich, dass Ihre Elastic Beanstalk EC2-Instance-Profilrolle über die [erforderlichen IAM-Berechtigungen für](AWSHowTo.secrets.IAM-permissions.md#AWSHowTo.secrets.IAM-permissions.secrets-manager) den Zugriff auf die Ressourcen verfügt. 
+ Wenn dieses Ereignis durch den `RestartAppServer` Vorgang ausgelöst wurde, versuchen Sie nach der Behebung des Problems erneut, den `RestartAppServer` Anruf zu starten, um das Problem zu lösen. 
+ Wenn das Ereignis durch einen `UpdateEnvironment` Anruf ausgelöst wurde, wiederholen Sie den `UpdateEnvironment` Vorgang. 

Beispiele für diese Befehle finden Sie unter [https://docs.aws.amazon.com//cli/latest/userguide/cli_elastic-beanstalk_code_examples.html](https://docs.aws.amazon.com//cli/latest/userguide/cli_elastic-beanstalk_code_examples.html). Weitere Informationen zu den API-Aktionen für diese Operationen finden Sie in der *[AWS Elastic Beanstalk API-Referenz](https://docs.aws.amazon.com/elasticbeanstalk/latest/api/)*.

**Ereignis: Bei** der *Instanzbereitstellung wurden ein oder mehrere mehrzeilige Umgebungswerte erkannt, die für diese Plattform nicht unterstützt werden*

Mehrzeilige Variablen werden für Amazon Linux 2-Plattformen nicht unterstützt, ausgenommen Docker- und ECS-verwaltete Docker-Plattformen. Die verfügbaren Optionen, um fortzufahren, finden Sie unter. [Mehrzeilige Werte](AWSHowTo.secrets.env-vars.md#AWSHowTo.secrets.multiline)

**Ereignis: CreateEnvironment ** *schlägt fehl, wenn ein Geheimnis angegeben wird*

Wenn ein `CreateEnvironment` Fehler auftritt und Sie Geheimnisse als Umgebungsvariablen haben, müssen Sie das zugrundeliegende Problem beheben und es dann verwenden`UpdateEnvironment`, um das Umgebungs-Setup abzuschließen. Verwenden Sie es nicht`RestartAppServer`, da es in dieser Situation nicht ausreicht, um die Umgebung zum Laufen zu bringen. Beispiele für diese Befehle finden Sie unter [https://docs.aws.amazon.com//cli/latest/userguide/cli_elastic-beanstalk_code_examples.html](https://docs.aws.amazon.com//cli/latest/userguide/cli_elastic-beanstalk_code_examples.html). Weitere Informationen zu den API-Aktionen für diese Operationen finden Sie in der *[AWS Elastic Beanstalk API-Referenz](https://docs.aws.amazon.com/elasticbeanstalk/latest/api/)*.

## Umgebungserstellung und Instance-Starts
<a name="troubleshooting-envcreate"></a>

**Ereignis:** *Umgebung konnte nicht gestartet werden*

Dieses Ereignis tritt auf, wenn Elastic Beanstalk versucht, eine Umgebung zu starten und es dabei zu Fehlern kommt. Die vorherigen Ereignisse auf der Seite **Events (Ereignisse)** weisen auf die Ursache des Problems hin.

**Ereignis:** *Die Erstellung der Umgebung wurde mit Befehls-Timeouts abgeschlossen. Versuchen Sie, die Timeout-Zeit zu erhöhen.*

Falls Sie Konfigurationsdateien einsetzen, mit denen Befehle auf der Instance ausgeführt, große Dateien heruntergeladen oder Pakete installiert werden, kann die Anwendungsbereitstellung langwierig sein. Erhöhen Sie den [Timeout-Wert für Befehle](using-features.rolling-version-deploy.md#environments-cfg-rollingdeployments-console), damit die Anwendung im Rahmen der Bereitstellungen mehr Zeit zum Ausführen hat.

**Ereignis:** *Die folgenden Ressourcen konnten nicht erstellt werden: [AWSEBInstanceLaunchWaitCondition]*

Diese Nachricht gibt an, dass die Amazon EC2-Instances der Umgebung Elastic Beanstalk nicht über den erfolgreichen Start informiert haben. Das kann passieren, wenn die Instances keine Verbindung zum Internet haben. Wenn die Umgebungskonfiguration das Starten der Instances in einem privaten VPC-Subnetz vorsieht, [stellen Sie sicher, dass das Subnetz über NAT verfügt](vpc.md), damit die Instances eine Verbindung zu Elastic Beanstalk herstellen können.

**Ereignis:** *In dieser Region ist eine Servicerolle erforderlich. Bitte fügen Sie der Umgebung eine Servicerolle-Option hinzu.*

Elastic Beanstalk nutzt eine Servicerolle zur Überwachung der Ressourcen in Ihrer Umgebung und zur Unterstützung von [verwalteten Plattformaktualisierungen](environment-platform-update-managed.md). Weitere Informationen finden Sie unter [Rollen von Elastic Beanstalk Service verwalten](iam-servicerole.md).

## Bereitstellungen
<a name="troubleshooting-deployments"></a>

**Problem:** *Anwendung steht während Bereitstellungen nicht zur Verfügung*

Da Elastic Beanstalk ein Drop-in-Upgrade ausführt, kann es zu einer Ausfallzeit von einigen Sekunden kommen. Setzen Sie [fortlaufende Bereitstellungen](using-features.rolling-version-deploy.md) ein, um die Beeinträchtigung der Produktionsumgebungen aufgrund von Bereitstellungen zu minimieren.

**Ereignis:** *Die AWS Elastic Beanstalk Beanstalk-Anwendungsversion konnte nicht erstellt* werden

Möglicherweise ist das Quell-Bundle der Anwendung zu umfangreich oder das [Anwendungsversionskontingent](applications-versions.md) wurde erreicht.

**Ereignis:** *Umgebungsaktualisierung wurde mit Befehls-Timeouts abgeschlossen. Versuchen Sie, die Timeout-Zeit zu erhöhen.*

Falls Sie Konfigurationsdateien einsetzen, mit denen Befehle auf der Instance ausgeführt, große Dateien heruntergeladen oder Pakete installiert werden, kann die Anwendungsbereitstellung langwierig sein. Erhöhen Sie den [Timeout-Wert für Befehle](using-features.rolling-version-deploy.md#environments-cfg-rollingdeployments-console), damit die Anwendung im Rahmen der Bereitstellungen mehr Zeit zum Ausführen hat.

## Gesundheit
<a name="troubleshooting-health"></a>

**Ereignis:** *CPU-Auslastung Über 95 %*

Versuchen Sie, [mehr Instances auszuführen](using-features.managing.as.md), oder [wählen Sie einen anderen Instance-Typ aus](using-features.managing.ec2.md).

**Ereignis:** *Elastic Load Balancer awseb — *myapp* Hat Zero Healthy Instances*, *ELB-Prozesse sind auf *X* Out-of-Instances nicht* fehlerfrei. *Y* , *ELB-Prozesse sind nicht auf allen Instances fehlerfrei*.

Diese Meldungen weisen darauf hin, dass Ihre Load Balancer-Zustandsprüfungen bei einer oder mehreren Instances fehlschlagen. Wenn Ihre Anwendung zu funktionieren scheint, stellen Sie sicher, dass die URL für die Integritätsprüfung Ihrer Anwendung korrekt konfiguriert ist. Falls nicht, versuchen Sie Folgendes:
+ Überprüfen Sie Ihre Anwendungsprotokolle (z. B.`/var/log/web.stdout.log`) und `/var/log/eb-engine.log` auf Fehler, Startfehler oder Bereitstellungsprobleme.
+ Überprüfen Sie die Proxyprotokolle in `/var/log/nginx/` (nginx) oder `/var/log/httpd/` (Apache) auf Verbindungsfehler.
+ Stellen Sie sicher, dass Ihre Anwendung mit HTTP 200 auf den konfigurierten Health Check-Pfad reagiert und den erwarteten Port abhört.
+ Stellen Sie sicher, dass Sicherheitsgruppen eingehenden Datenverkehr vom Load Balancer zu Instances am Health Check-Port zulassen. Überprüfen Sie in der EC2-Konsole die Regeln für eingehenden Datenverkehr in der Sicherheitsgruppe der Instance, um sicherzustellen, dass der Health Check-Port für die Sicherheitsgruppe des Load Balancers geöffnet ist.
+ Überprüfen Sie die CPU- und Speicherauslastung anhand von CloudWatch Metriken (`CPUUtilization`,). `EnvironmentHealth` Eine Erschöpfung der Ressourcen kann zu Timeouts bei der Integritätsprüfung führen.

[Rufen Sie für weitere Informationen die vollständigen Paketprotokolle](using-features.logging.md) ab oder [aktivieren CloudWatch Sie das Protokollstreaming](AWSHowTo.cloudwatchlogs.md). Sie können auch das [https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-awssupport-troubleshoot-elastic-beanstalk.html](https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-awssupport-troubleshoot-elastic-beanstalk.html)Automatisierungs-Runbook ausführen, um das Problem zu diagnostizieren.

**Ereignis:** *Elastic Load Balancer awseb- *myapp** kann nicht gefunden werden

Der Load Balancer Ihrer Umgebung wurde möglicherweise entfernt. out-of-band Nehmen Sie Änderungen an den Umgebungsressourcen nur mit den von Elastic Beanstalk bereitgestellten Konfigurationsoptionen und [Erweiterungen](ebextensions.md) vor. Erstellen Sie Ihre Umgebung erneut oder starten Sie eine neue Umgebung.

**Ereignis:** *EC2-Instance konnte nicht gestartet werden. Warten auf den Start einer neuen EC2 Instance ...*

Möglicherweise sind derzeit keine Instance-Typen für die Umgebung verfügbar oder das Instance-Kontingent für Ihr Konto wurde erreicht. Überprüfen Sie in der [Übersicht zum Servicestatus-](https://status.aws.amazon.com/), ob der Elastic Compute Cloud (Amazon EC2)-Service den Status "Grün" aufweist, oder [fordern Sie eine Kontingenterhöhung an](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-ec2-instances).

**Ereignis:** *Keine der Instanzen sendet Daten*.

Elastic Beanstalk empfängt von keiner Ihrer Instances Gesundheitsdaten. Dies kann durch Netzwerkverbindungsprobleme, Probleme mit Health Agents oder Ausfälle auf Systemebene verursacht werden.
+ Überprüfen Sie die Netzwerkkonnektivität. Vergewissern Sie sich, dass Sicherheitsgruppen ausgehendes HTTPS (Port 443) zulassen. Stellen Sie für Instances in privaten Subnetzen sicher, dass ein NAT-Gateway oder VPC-Endpunkte konfiguriert sind. Überprüfen Sie die Routentabellen auf korrekte ausgehende Routen und stellen Sie sicher, dass die DNS-Auflösung in Ihrer VPC ordnungsgemäß funktioniert.
+ Überprüfen Sie den Health Monitoring Agent. Suchen Sie nach Fehlern bei `/var/log/healthd/daemon.log` Health Agents und `/var/log/messages` nach Fehlern auf Systemebene. Stellen Sie sicher, dass der Healthd-Dienst ausgeführt wird, indem Sie sich über SSH mit der Instanz verbinden und ihn ausführen. `systemctl status healthd`
+ Prüfen Sie, ob Probleme auf Systemebene vorliegen, wie z. B. Ressourcenerschöpfung (Arbeitsspeicher, CPU, Festplattenspeicher), NTP/system Uhrsynchronisierung und Konnektivität des Instanz-Metadatendienstes.

[Rufen Sie für weitere Informationen die vollständigen Paketprotokolle](using-features.logging.md) ab oder [aktivieren CloudWatch ](AWSHowTo.cloudwatchlogs.md) Sie das Protokollstreaming. Sie können auch das [https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-awssupport-troubleshoot-elastic-beanstalk.html](https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-awssupport-troubleshoot-elastic-beanstalk.html)Automatisierungs-Runbook ausführen, um das Problem zu diagnostizieren.

## Umgebungen mit konfigurierten Dual-Stack-Load Balancern
<a name="troubleshooting-dual-stack-load-balancer"></a>

**Ereignis:** In der *VPC sind *vpc\$1id* keine IPv6 CIDR-Blöcke konfiguriert. IPv6 CIDR-Blöcke sind für den Dual-Stack-Load Balancer erforderlich. Bitte ordnen Sie Ihrer VPC einen IPv6 CIDR-Block zu, bevor Sie den Dual-Stack-Modus verwenden.*

Ihrer VPC und allen Subnetzen müssen IPv6 CIDR-Blöcke zugeordnet sein. Dies ist eine der VPC-Voraussetzungen, die Sie erfüllen müssen, bevor Sie Ihren Load Balancer für die Dual-Stack-Unterstützung konfigurieren können. Weitere Informationen zur Ausführung dieser Aufgabe finden Sie weiter [Voraussetzungen für Amazon VPC](environments-cfg-elbv2-ipv6-dualstack.md#environments-cfg-elbv2-ipv6-dualstack.prereqs) oben in diesem Thema.

 **Ereignis:** In *einem oder mehreren Subnetzen für VPC sind *vpc\$1id* keine IPv6 CIDR-Blöcke konfiguriert. IPv6 CIDR-Blöcke sind für die Subnetze erforderlich, die mit dem Dualstack Load Balancer verwendet werden. Bitte ordnen Sie IPv6 CIDR-Blöcke allen erforderlichen Subnetzen zu, bevor Sie den Dual-Stack-Modus verwenden.* 

Allen Subnetzen für Ihre VPC müssen IPv6 CIDR-Blöcke zugeordnet sein. Dies ist eine der VPC-Voraussetzungen, die Sie erfüllen müssen, bevor Sie Ihren Load Balancer für die Dual-Stack-Unterstützung konfigurieren können. Weitere Informationen zur Ausführung dieser Aufgabe finden Sie weiter [Voraussetzungen für Amazon VPC](environments-cfg-elbv2-ipv6-dualstack.md#environments-cfg-elbv2-ipv6-dualstack.prereqs) oben in diesem Thema.

 **Fehler:** *Die `IpAddressType` Option kann nur auf Elastic Beanstalk Beanstalk-Umgebungen angewendet werden, die mit einem Application Load Balancer oder Network Load Balancer konfiguriert* sind. 

Diese Meldung weist darauf hin, dass es sich bei Ihrer Elastic Beanstalk Beanstalk-Umgebung möglicherweise um eine Single-Instance-Umgebung handelt oder dass sie einen Classic Load Balancer verwendet. Nur Umgebungen, die mit einem Application Load Balancer oder Network Load Balancer konfiguriert sind, können konfiguriert werden. `IpAddressType`

## Konfiguration
<a name="troubleshooting-configuration"></a>

**Ereignis:** *Der der Umgebung `stack_id` zugeordnete Stack `environment-ID` befindet sich* im Status `stack-status`

Der zugrunde liegende CloudFormation Stack Ihrer Umgebung befindet sich möglicherweise im Status *\$1\$1FAILED*. Dieser Status muss behoben werden, um den Elastic Beanstalk Beanstalk-Betrieb in Ihrer Umgebung fortsetzen zu können. Weitere Informationen finden Sie unter [Wiederherstellung Ihrer Elastic Beanstalk Beanstalk-Umgebung aus einem ungültigen Zustand](environment-management-invalid-stack.md).

**Ereignis:** *Es kann keine Elastic Beanstalk-Umgebung konfiguriert werden, die Werte für die Optionen "Elastic Load Balancing Target (Elastic Load Balancing-Ziel)" und "Application Healthcheck URL (URL für die Zustandsprüfung der Anwendung)" enthält.*

Die Option `Target` im Namespace `aws:elb:healthcheck` ist veraltet. Entfernen Sie die Namespace-Option `Target` aus der Umgebung und führen Sie die Aktualisierung erneut aus.

**Ereignis:** *ELB kann nicht an mehrere Subnetze in derselben AZ angehängt werden*

Diese Meldung wird angezeigt, wenn Sie einen Load Balancer zwischen Subnetzen in derselben Availability Zone verschieben möchten. Sollen die Subnetze des Load Balancers geändert werden, muss dieser aus den ursprünglichen Availability Zones entfernt und mit den gewünschten Subnetzen wieder in diese eingefügt werden. Während des Vorgangs werden alle Ihre Instances zwischen diesen migriert AZs, was zu erheblichen Ausfallzeiten führt. Ziehen Sie stattdessen in Betracht, eine neue Umgebung zu erstellen und einen [CNAME-Austausch durchzuführen](using-features.CNAMESwap.md).

## Fehlerbehebung bei Docker-Containern
<a name="troubleshooting-docker"></a>

**Ereignis:** *Docker-Image :latest: konnte nicht abgerufen werden. Ungültiger Repository-Name (), nur [a-z0-9-] sind zulässig. Weitere Details finden Sie in den Protokollfragmenten.*

Prüfen Sie die Syntax der `dockerrun.aws.json`-Datei mit einer JSON-Validierung. Verifizieren Sie außerdem den dockerfile-Inhalt hinsichtlich der Anforderungen in [Vorbereiten Ihres Docker-Images für die Bereitstellung auf Elastic Beanstalk](single-container-docker-configuration.md).

**Ereignis:** *Keine EXPOSE-Anweisung in Dockerfile gefunden, Bereitstellung abbrechen*

Die `Dockerfile` oder `dockerrun.aws.json`-Datei deklariert den Container-Port nicht. Verwenden Sie die `EXPOSE`-Anweisung (`Dockerfile`) oder den `Ports`-Block (`dockerrun.aws.json`-Datei), um einen Port für eingehenden Datenverkehr verfügbar zu machen.

**Ereignis:** *Authentifizierungsdaten *repository* konnten nicht heruntergeladen* werden von *bucket name*

Der `dockerrun.aws.json` stellt ein ungültiges EC2-Schlüsselpaar and/or S3-Bucket für die `.dockercfg` Datei bereit. Oder das Instance-Profil hat keine GetObject Autorisierung für den S3-Bucket. Überprüfen Sie, ob die `.dockercfg`-Datei einen gültigen S3-Bucket und ein gültiges EC2-Schlüsselpaar enthält. Erteilen Sie Berechtigungen für die Aktion `s3:GetObject` für die IAM-Rolle im Instance-Profil. Details finden Sie unter [Elastic Beanstalk Instance-Profile verwalten](iam-instanceprofile.md).

**Ereignis:** *Aktivitätsausführung wegen Warnmeldung zur ungültigen "auth"-Konfigurationsdatei fehlgeschlagen*

Die Authentifizierungsdatei (`config.json`) ist nicht ordnungsgemäß formatiert. Siehe [Authentifizierung mit Image-RepositorysBenutzen AWS Secrets Manager](docker-configuration.remote-repo.md)

## Häufig gestellte Fragen
<a name="troubleshooting-faq"></a>

**Frage:** *Wie kann ich meine Anwendungs-URL von myapp.us-west-2.elasticbeanstalk.com in www.myapp.com ändern?*

Registrieren Sie bei einem DNS-Server einen CNAME-Datensatz, wie z. B. **www.mydomain.com CNAME mydomain.elasticbeanstalk.com**.

**Frage:** * Wie gebe ich eine bestimmte Availability Zone für meine Elastic Beanstalk-Anwendung an?*

Sie können eine bestimmte Availability Zone auswählen, indem Sie das CLI APIs, das Eclipse-Plug-In oder das Visual Studio-Plugin verwenden. Für Anweisungen zum Angeben einer Availability Zone mit der Elastic Beanstalk-Konsole siehe [Auto Scaling Ihrer Elastic Beanstalk Beanstalk-Umgebungsinstanzen](using-features.managing.as.md).

**Frage:** *Wie kann ich den Instance-Typ meiner Umgebung ändern?*

Um den Instance-Typ Ihrer Umgebung zu ändern, rufen Sie die Seite **Bearbeiten** in der Konfigurationskategorie **Instances** auf. Wählen Sie dann einen neuen Instance-Typ aus und wählen Sie **Anwenden**, um Ihre Umgebung zu aktualisieren. Danach beendet Elastic Beanstalk alle laufenden Instances und ersetzt sie durch neue.

**Frage:** *Wie stelle ich fest, ob jemand Konfigurationsänderungen an einer Umgebung vorgenommen hat?*

Um diese Informationen anzuzeigen, wählen Sie im Navigationsbereich der Elastic-Beanstalk-Konsole den **Änderungsverlauf**, um eine Liste der Konfigurationsänderungen für alle Umgebungen anzuzeigen. Diese Liste enthält das Datum und die Uhrzeit der Änderung, den Konfigurationsparameter und den Wert, in den sie geändert wurde, sowie den IAM-Benutzer, der die Änderung vorgenommen hat. Weitere Informationen finden Sie unter [Änderungsverlauf](using-features.changehistory.md). 

**Frage:** *Kann ich verhindern, dass Amazon EBS-Volumes gelöscht werden, wenn Instances beendet werden?*

Instances in Ihrer Umgebung verwenden Amazon EBS zur Speicherung. Das Stamm-Volume wird jedoch gelöscht, wenn eine Instance durch Auto Scaling beendet wird. Wir empfehlen nicht, dass Sie Status- oder andere Daten auf Ihren Instances speichern. Bei Bedarf können Sie verhindern, dass Volumes gelöscht werden, indem Sie AWS CLI: verwenden, `$ aws ec2 modify-instance-attribute -b '/dev/sdc=<vol-id>:false` wie in der [AWS CLI Referenz](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-attribute.html) beschrieben.

**Frage:** *Wie lösche ich persönliche Informationen aus meiner Elastic Beanstalk-Anwendung?*

AWS Ressourcen, die Ihre Elastic Beanstalk Beanstalk-Anwendung verwendet, speichern möglicherweise persönliche Informationen. Wenn Sie eine Umgebung beenden, beendet Elastic Beanstalk die erstellten Ressourcen. Die Ressourcen, die Sie mithilfe von [Konfigurationsdateien](ebextensions.md) hinzugefügt haben, werden ebenfalls beendet. Wenn Sie jedoch AWS Ressourcen außerhalb Ihrer Elastic Beanstalk Beanstalk-Umgebung erstellt und sie mit Ihrer Anwendung verknüpft haben, müssen Sie möglicherweise manuell überprüfen, ob persönliche Informationen, die Ihre Anwendung möglicherweise gespeichert hat, nicht beibehalten werden. In diesem Entwicklerhandbuch erwähnen wir, wann immer wir über die Erstellung zusätzlicher Ressourcen sprechen, auch, wann Sie darüber nachdenken sollten, diese zu löschen.

## Häufige Fehler
<a name="common-errors"></a>

In diesem Thema werden häufig auftretende Fehlermeldungen im Zusammenhang mit der EB CLI-Verwendung sowie mögliche Lösungen aufgeführt. Falls Ihnen eine Fehlermeldung angezeigt wird, die hier nicht enthalten ist, teilen Sie uns dies bitte über die *Feedback*-Links mit.

**FEHLER: Bei der Verarbeitung des Befehls git ist ein Fehler aufgetreten. Fehlercode: 128 Fehler: fatal: Kein gültiger Objektname HEAD**

**Ursache:** Diese Fehlermeldung wird angezeigt, wenn Sie ein Git-Repository initialisiert, aber noch nicht übergeben haben. Wenn der Projektordner ein Git-Repository enthält, sucht die EB CLI nach einer HEAD-Revision.

**Lösung:** Fügen Sie die Dateien in Ihrem Projektordner zum Staging-Bereich hinzu und führen Sie den Commit aus:

```
~/my-app$ git add .
~/my-app$ git commit -m "First commit"
```

**FEHLER: Dieser Zweig hat keine Standardumgebung. Sie müssen entweder eine Umgebung angeben, indem Sie „eb status my-env-name“ eingeben, oder eine Standardumgebung festlegen, indem Sie „eb use my-env-name“ eingeben.**

**Ursache:** Wenn Sie in Git eine neue Verzweigung erstellen, wird dieser nicht standardmäßig einer Elastic Beanstalk-Umgebung zugewiesen.

**Lösung:** Führen Sie **eb list** aus, um eine Liste der verfügbaren Umgebungen aufzurufen. Führen Sie anschließend **eb use *env-name*** aus, um eine der verfügbaren Umgebungen zu verwenden.

**FEHLER: Für Plattformen ab Version 2.0 ist eine Servicerolle erforderlich. Sie können eine mit der Option --service-role angeben**

**Ursache:** Wenn Sie einen Umgebungsnamen mit **eb create** angeben (z. B. **eb create my-env**), erstellt die EB CLI keine Servicerolle für Sie. Ist die standardmäßige Servicerolle nicht vorhanden, wird die obige Fehlermeldung angezeigt.

**Lösung:** Führen Sie **eb create** ohne den Umgebungsnamen aus und folgen Sie den Anweisungen, um die standardmäßige Servicerolle zu erstellen.

## Fehler bei der Bereitstellung
<a name="python-common-troubleshooting"></a>

Ihr Elastic Beanstalk-Deployment reagiert möglicherweise mit einer 404-Antwort (wenn Ihre Anwendung nicht gestartet werden konnte) oder einer 500-Antwort (wenn Ihre Anwendung während der Laufzeit fehlschlägt). Um viele häufig auftretende Probleme zu beheben, können Sie die EB CLI verwenden, um den Status Ihrer Bereitstellung zu überprüfen, die zugehörigen Protokolle einzusehen, mit SSH auf Ihre EC2-Instance zuzugreifen oder die AWS Management Console-Seite für Ihre Anwendungsumgebung zu öffnen.

**So setzen Sie die EB CLI zum Beheben von Bereitstellungsfehlern ein**

1. Führen Sie **eb status** aus, um den Status der aktuellen Bereitstellung sowie den Zustand der EC2-Hosts anzuzeigen. Beispiel:

   ```
   $ eb status --verbose
   
   Environment details for: python_eb_app
     Application name: python_eb_app
     Region: us-west-2
     Deployed Version: app-150206_035343
     Environment ID: e-wa8u6rrmqy
     Platform: 64bit Amazon Linux 2014.09 v1.1.0 running Python 2.7
     Tier: WebServer-Standard-
     CNAME: python_eb_app.elasticbeanstalk.com
     Updated: 2015-02-06 12:00:08.557000+00:00
     Status: Ready
     Health: Green
     Running instances: 1
         i-8000528c: InService
   ```
**Anmerkung**  
Mit `--verbose` erhalten Sie detaillierte Informationen über den Status der ausgeführten Instances. Andernfalls werden nur allgemeine Umgebungsinformationen von **eb status** ausgegeben.

1. Führen Sie **eb health** aus, um Zustandsinformationen zur Umgebung anzuzeigen:

   ```
   $ eb health --refresh
    elasticBeanstalkExa-env                                  Degraded                  2016-03-28 23:13:20
   WebServer                                                                              Ruby 2.1 (Puma)
     total      ok    warning  degraded  severe    info   pending  unknown
       5        2        0        2        1        0        0        0
   
     instance-id   status     cause
       Overall     Degraded  Incorrect application version found on 3 out of 5 instances. Expected version "Sample Application" (deployment 1).
     i-d581497d    Degraded  Incorrect application version "v2" (deployment 2). Expected version "Sample Application" (deployment 1).
     i-d481497c    Degraded  Incorrect application version "v2" (deployment 2). Expected version "Sample Application" (deployment 1).
     i-136e00c0    Severe    Instance ELB health has not been available for 5 minutes.
     i-126e00c1    Ok
     i-8b2cf575    Ok
   
     instance-id   r/sec    %2xx   %3xx   %4xx   %5xx      p99      p90      p75     p50     p10
       Overall     646.7   100.0    0.0    0.0    0.0    0.003    0.002    0.001   0.001   0.000
     i-dac3f859    167.5    1675      0      0      0    0.003    0.002    0.001   0.001   0.000
     i-05013a81    161.2    1612      0      0      0    0.003    0.002    0.001   0.001   0.000
     i-04013a80    0.0         -      -      -      -         -        -       -       -       -
     i-3ab524a1    155.9    1559      0      0      0    0.003    0.002    0.001   0.001   0.000
     i-bf300d3c    162.1    1621      0      0      0    0.003    0.002    0.001   0.001   0.000
   
     instance-id   type       az   running     load 1  load 5      user%  nice%  system%  idle%   iowait%
     i-d581497d    t2.micro   1a   25 mins       0.16     0.1        7.0    0.0      1.7   91.0       0.1
     i-d481497c    t2.micro   1a   25 mins       0.14     0.1        7.2    0.0      1.6   91.1       0.0
     i-136e00c0    t2.micro   1b   25 mins        0.0    0.01        0.0    0.0      0.0   99.9       0.1
     i-126e00c1    t2.micro   1b   25 mins       0.03    0.08        6.9    0.0      2.1   90.7       0.1
     i-8b2cf575    t2.micro   1c   1 hour        0.05    0.41        6.9    0.0      2.0   90.9       0.0
     
     instance-id   status     id   version              ago                                  deployments
     i-d581497d    Deployed   2    v2                   9 mins
     i-d481497c    Deployed   2    v2                   7 mins
     i-136e00c0    Failed     2    v2                   5 mins
     i-126e00c1    Deployed   1    Sample Application   25 mins
     i-8b2cf575    Deployed   1    Sample Application   1 hour
   ```

   Im obigen Beispiel wird eine Umgebung mit fünf Instances dargestellt, in der die Bereitstellung der Version "v2" auf der dritten Instance fehlerhaft verlaufen ist. Nach der fehlgeschlagenen Bereitstellung wird die erwartete Version auf die letzte erfolgreiche Version zurückgesetzt, in diesem Falle auf "Sample Application" aus der ersten Bereitstellung. Weitere Informationen finden Sie unter [Verwenden der EB-CLI zur Überwachung des Umgebungszustands](health-enhanced-ebcli.md).

1. Führen Sie **eb logs** aus, um die Protokolle zur Anwendungsbereitstellung herunterzuladen und aufzurufen.

   ```
   $ eb logs
   ```

1. Führen Sie **eb ssh** aus, um die Verbindung zur EC2-Instance, auf der die Anwendung ausgeführt wird, herzustellen und diese direkt zu überprüfen. Auf der Instance finden Sie die bereitgestellte Anwendung im Verzeichnis `/opt/python/current/app` und die Python-Umgebung in `/opt/python/run/venv/`.

1. Führen Sie **eb console** aus, um die Anwendungsumgebung in der [AWS -Managementkonsole](https://aws.amazon.com/console/) anzuzeigen. Über die Weboberfläche können Sie schnell zahlreiche Bereitstellungsaspekte untersuchen, darunter Konfiguration, Status, Ereignisse und Protokolle der Anwendung. Außerdem können Sie die aktuellen oder beendeten Anwendungsversionen herunterladen, die Sie auf dem Server bereitgestellt haben.